1. ESP32 WiFi连接基础与项目概述
ESP32作为一款集成了WiFi和蓝牙功能的低成本微控制器，已经成为物联网开发的明星芯片。这个实验将带你快速上手ESP32的WiFi功能，通过Arduino IDE实现最基本的网络连接，并在串口监视器中打印获取到的IP地址。对于刚接触ESP32的开发者来说，这是迈入物联网世界的第一步。
为什么选择这个实验作为入门？因为网络连接是绝大多数ESP32项目的基础功能。无论是远程传感器数据采集、智能家居控制还是物联网设备管理，都需要先解决设备联网问题。通过串口打印IP地址这个看似简单的操作，实际上已经完成了设备入网的关键步骤，为后续开发奠定了基础。
实验所需硬件非常简单：一块ESP32开发板（如ESP32-DevKitC）、USB数据线以及可用的2.4GHz WiFi网络。软件方面需要安装Arduino IDE和ESP32开发板支持包。整个实验不涉及额外电路连接，特别适合作为第一个ESP32实操项目。
2. 开发环境准备与基础配置
2.1 Arduino IDE环境搭建
首先需要安装Arduino IDE（建议1.8.x或2.x最新版），然后添加ESP32开发板支持。打开Arduino IDE后，依次点击"文件"→"首选项"，在"附加开发板管理器网址"中输入：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json然后通过"工具"→"开发板"→"开发板管理器"安装"esp32"平台。安装完成后，在开发板列表中选择"ESP32 Dev Module"。
注意：国内用户可能会遇到下载慢的问题，可以尝试将上述URL中的github.com替换为ghproxy.com/https://github.com来加速下载。
2.2 基础代码结构解析
一个典型的ESP32 WiFi连接程序包含以下几个关键部分：
#include <WiFi.h> // 引入ESP32 WiFi库 const char* ssid = "你的WiFi名称"; // WiFi SSID const char* password = "你的WiFi密码"; // WiFi密码 void setup() { Serial.begin(115200); // 初始化串口通信 WiFi.begin(ssid, password); // 开始连接WiFi while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println("连接成功"); Serial.print("IP地址: "); Serial.println(WiFi.localIP()); // 打印获取到的IP地址 } void loop() { // 主循环通常保持为空或执行其他任务 }这段代码展示了最基本的连接流程：引入库→设置凭证→建立连接→获取IP。实际开发中我们还需要考虑更多细节。
3. 完整实现与深度优化
3.1 增强型WiFi连接实现
基础版本虽然能工作，但缺乏健壮性。以下是改进后的完整代码：
#include <WiFi.h> const char* ssid = "你的WiFi名称"; const char* password = "你的WiFi密码"; const int timeout = 20000; // 20秒连接超时 void setup() { Serial.begin(115200); // 设置WiFi模式为STA（客户端模式） WiFi.mode(WIFI_STA); WiFi.disconnect(true); // 清除之前的连接配置 Serial.println(); Serial.println("正在连接WiFi..."); Serial.print("SSID: "); Serial.println(ssid); WiFi.begin(ssid, password); unsigned long startAttemptTime = millis(); while (WiFi.status() != WL_CONNECTED && millis() - startAttemptTime < timeout) { delay(500); Serial.print("."); } if (WiFi.status() != WL_CONNECTED) { Serial.println("\n连接失败！可能原因："); Serial.println("- WiFi名称或密码错误"); Serial.println("- 信号强度不足"); Serial.println("- 路由器设置了MAC过滤"); Serial.println("- 2.4GHz/5GHz网络混淆"); ESP.restart(); // 重启尝试重新连接 } else { Serial.println("\n连接成功！"); Serial.print("IP地址: "); Serial.println(WiFi.localIP()); Serial.print("MAC地址: "); Serial.println(WiFi.macAddress()); Serial.print("信号强度(RSSI): "); Serial.print(WiFi.RSSI()); Serial.println(" dBm"); } } void loop() { // 维持连接状态检测 if (WiFi.status() != WL_CONNECTED) { Serial.println("WiFi连接丢失，尝试重新连接..."); WiFi.reconnect(); delay(5000); // 等待5秒后检查状态 } }3.2 代码关键点解析
WiFi模式设置：明确设置
WIFI_STA模式（客户端模式），避免默认模式可能带来的问题。连接超时处理：添加20秒超时机制，避免无限等待。
详细的错误诊断：连接失败时提供可能的原因分析，帮助快速定位问题。
连接状态维持：在loop()中定期检查连接状态，断开时自动重连。
额外网络信息：除了IP地址，还输出MAC地址和信号强度等有用信息。
重要提示：ESP32仅支持2.4GHz WiFi网络。如果路由器开启了5GHz频段，请确保设备连接的是2.4GHz网络，或者将路由器设置为双频合一模式。
4. 常见问题与高级技巧
4.1 典型问题排查指南
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 长时间显示连接中 | WiFi密码错误 | 仔细检查密码，注意大小写 |
| 连接后立即断开 | 电源不足 | 使用外部电源供电，USB可能供电不足 |
| 无法发现网络 | 2.4GHz/5GHz混淆 | 确保连接2.4GHz网络 |
| 连接不稳定 | 信号强度弱 | 检查RSSI值，-70dBm以上较理想 |
| 串口无输出 | 波特率不匹配 | 确保串口监视器设置为115200 |
4.2 高级技巧与优化建议
- 多网络配置：可以配置多个备用网络，当前网络不可用时自动切换：
const char* ssids[] = {"主网络", "备用网络1", "备用网络2"}; const char* passwords[] = {"主密码", "备用密码1", "备用密码2"}; void connectToWiFi() { for(int i = 0; i < 3; i++) { WiFi.begin(ssids[i], passwords[i]); // ...连接逻辑... if(WiFi.status() == WL_CONNECTED) break; } }- 智能重连机制：实现指数退避算法，避免频繁重连：
void reconnect() { static unsigned long lastAttempt = 0; static int delaySeconds = 1; if (millis() - lastAttempt > delaySeconds * 1000) { WiFi.disconnect(); WiFi.reconnect(); delaySeconds = min(delaySeconds * 2, 60); // 最大间隔60秒 lastAttempt = millis(); } }- 低功耗优化：对于电池供电设备，可以调整WiFi功率：
#include "esp_wifi.h" void setup() { // ...其他代码... esp_wifi_set_max_tx_power(84); // 设置发射功率为20dBm }- OTA升级支持：在WiFi连接成功后初始化OTA功能，便于后续无线更新：
#include <ArduinoOTA.h> void setupOTA() { ArduinoOTA.setHostname("my-esp32-device"); ArduinoOTA.begin(); } void loop() { ArduinoOTA.handle(); // ...其他代码... }5. 项目扩展与实际应用
掌握了基础WiFi连接后，可以进一步扩展实现更多功能：
Web服务器功能：基于ESP32搭建简易Web服务器，通过浏览器访问设备信息。
MQTT客户端：连接MQTT服务器实现物联网消息收发。
NTP时间同步：从网络获取准确时间，用于数据记录和时间戳。
远程固件更新：实现OTA(Over-The-Air)无线更新功能。
一个典型的Web服务器扩展示例：
#include <WebServer.h> WebServer server(80); void handleRoot() { String html = "<html><body>"; html += "<h1>ESP32系统信息</h1>"; html += "<p>IP地址: " + WiFi.localIP().toString() + "</p>"; html += "<p>信号强度: " + String(WiFi.RSSI()) + " dBm</p>"; html += "<p>运行时间: " + String(millis()/1000) + " 秒</p>"; html += "</body></html>"; server.send(200, "text/html", html); } void setup() { // ...WiFi连接代码... server.on("/", handleRoot); server.begin(); Serial.println("HTTP服务器已启动"); } void loop() { server.handleClient(); }在实际项目中，建议将WiFi配置信息存储在非易失性存储器(如EEPROM或SPIFFS)中，方便后期修改而无需重新编译程序。同时考虑实现一个配置模式（如长按按钮进入AP模式），允许通过网页配置WiFi参数。
