ESP32 IDF零基础指南：连接AP并获取IP地址

从零开始玩转ESP32：连上Wi-Fi后如何稳拿IP地址？

你有没有过这样的经历？把ESP32烧录好代码，串口打开，满心期待它连上网、报出IP，结果日志里只看到一串“retrying…”循环打转——连不上AP？获取不到IP？不知道卡在哪一步？

别急。这几乎是每个物联网新手都会踩的坑。

今天我们就来手把手拆解这个最基础也最关键的环节：用ESP-IDF让ESP32以Station模式连接路由器（AP），并成功拿到IPv4地址。不只是贴代码，更要讲清楚每一步背后的逻辑和“为什么”。

一、先搞明白：我们到底在做什么？

想象一下，你的ESP32是一个刚搬进新小区的住户。
- 它手里有一张房号清单（SSID）和门禁密码（Password）；
- 想要住进去，得先找到物业办公室（AP）登记身份；
- 登记通过后，物业会给它分配一个唯一的家庭住址（IP地址）；
- 只有拿到了地址，它才能收快递（接收数据）、发消息（发送请求）。

我们的任务就是帮它完成这套“入住流程”。

而整个过程的核心组件有三个：
1.Wi-Fi驱动—— 负责“拨号上网”
2.esp-event事件系统—— 监听“通知公告”
3.esp-netif + DHCP—— 等待物业派发房号

这三个家伙必须协同工作，少一个都不行。

二、第一步：搭好地基——初始化不能跳

很多初学者一上来就想esp_wifi_connect()，结果直接崩溃。为什么？因为底层服务还没启动。

就像盖楼前要通水通电一样，以下三行是所有网络功能的前提：

nvs_flash_init(); // 启用非易失性存储（用来存Wi-Fi配置） esp_netif_init(); // 初始化网络接口层 esp_event_loop_create_default(); // 创建默认事件循环

🔧关键点解析：
-nvs_flash_init()不只是可选项！如果你以后想保存配网信息（比如SmartConfig配网后的SSID/密码），就必须初始化NVS。
-esp_event_loop_create_default()相当于建立了一个“广播站”，后续所有Wi-Fi、IP的状态变化都要靠它来通知你。
- 这三步顺序不能乱，否则后面调用API会返回错误或导致程序跑飞。

三、创建“网络身份证”：esp-netif的作用你真的懂吗？

接下来这句常被忽略但极其重要：

esp_netif_create_default_wifi_sta();

这句话做了什么？
它为ESP32创建了一个代表“Wi-Fi客户端”的虚拟网络接口（netif）。你可以把它理解为给设备办了一张“网络身份证”。

有了这张证：
- 系统才知道哪里该接DHCP；
- IP地址才能正确绑定到这个接口上；
- 后续调用get_ip_info()才能查到有效数据。

如果没调这一句，哪怕Wi-Fi物理层连上了，你也拿不到IP！

💡 小知识："WIFI_STA_DEF"是这个默认接口的key值，后面可以通过它反向获取句柄。

四、Wi-Fi启动全流程：从初始化到发出连接指令

现在进入正题。下面是完整的Wi-Fi初始化函数，我们逐段分析：

void wifi_init_sta(void) { // 已经初始化过了，这里不再重复 wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT(); esp_wifi_init(&cfg); // 初始化Wi-Fi驱动 esp_wifi_set_mode(WIFI_MODE_STA); // 设置为Station模式 wifi_config_t wifi_config = { .sta = { .ssid = "YOUR_SSID", .password = "YOUR_PASSWORD", .threshold.authmode = WIFI_AUTH_WPA2_PSK, }, }; esp_wifi_set_config(WIFI_IF_STA, &wifi_config); // 应用配置 esp_wifi_start(); // 启动Wi-Fi模块 esp_wifi_connect(); // 主动发起连接 }

📌 关键步骤详解：

⚠️ 注意：有些教程建议在事件回调中才调用esp_wifi_connect()，这是更稳妥的做法（见下文），避免因模块未就绪导致失败。

五、真正的核心：事件驱动模型怎么玩？

ESP-IDF不是“调完就完”的同步框架，而是典型的事件驱动异步系统。你不应该写成这样：

esp_wifi_connect(); while (1) { if (connected) break; // ❌ 错误！阻塞主线程且无法检测状态 }

正确的做法是：注册事件处理器，等系统主动告诉你发生了什么。

来看一个实用的事件处理函数模板：

static void event_handler(void* arg, esp_event_base_t event_base, int32_t event_id, void* event_data) { if (event_base == WIFI_EVENT) { switch(event_id) { case WIFI_EVENT_STA_START: ESP_LOGI("WIFI", "Wi-Fi started, connecting..."); esp_wifi_connect(); break; case WIFI_EVENT_STA_DISCONNECTED: { ESP_LOGI("WIFI", "Disconnected, retrying..."); // 可加入重试计数、延迟重连等策略 esp_wifi_connect(); } break; } } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) { ip_event_got_ip_t *event = (ip_event_got_ip_t *)event_data; const char* ip_str = ip4addr_ntoa(&event->ip_info.ip); ESP_LOGI("TCP/IP", "Got IP: %s", ip_str); // ✅ 到这里说明已经联网成功！可以启动HTTP/MQTT等任务 } }

然后在初始化时注册：

esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &event_handler, NULL); esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &event_handler, NULL);

🎯重点提醒：
-WIFI_EVENT_STA_START表示Wi-Fi模块已准备就绪，此时再调esp_wifi_connect()才是安全的；
-WIFI_EVENT_STA_DISCONNECTED提供了断线重连的机会，别浪费；
-IP_EVENT_STA_GOT_IP才是你真正想要的终点信号——IP已分配！

🧠 高级技巧：可以在获得IP后触发一个FreeRTOS事件组或发送队列消息，通知其他任务开始运行，实现模块解耦。

六、DHCP是如何悄悄帮你拿IP的？

你可能注意到，上面的代码根本没有手动设置IP地址。那IP是怎么来的？

答案就是：DHCP客户端自动运行。

当你调用了esp_netif_create_default_wifi_sta()，系统就已经为你启用了一个DHCP客户端。一旦Wi-Fi认证成功，它就会自动向路由器发起DHCP请求，流程如下：

[ESP32] --> DHCP Discover --> [Router] [ESP32] <-- DHCP Offer <-- [Router] [ESP32] --> DHCP Request --> [Router] [ESP32] <-- DHCP ACK <-- [Router] → 分配IP成功！

整个过程通常在1~3秒内完成，并触发IP_EVENT_STA_GOT_IP事件。

🔧 如果你想关闭DHCP、使用静态IP，可以这样做：

esp_netif_t *netif = esp_netif_get_handle_from_ifkey("WIFI_STA_DEF"); esp_netif_dhcpc_stop(netif); // 停止DHCP客户端 esp_netif_ip_info_t ip_info; inet_pton(AF_INET, "192.168.1.100", &ip_info.ip); inet_pton(AF_INET, "255.255.255.0", &ip_info.netmask); inet_pton(AF_INET, "192.168.1.1", &ip_info.gw); esp_netif_set_ip_info(netif, &ip_info);

但大多数场景下，保持DHCP开启更省心，尤其面对不同网络环境时兼容性更好。

七、常见“翻车”现场与避坑指南

💣 坑点1：密码错了却不提示？

确保你在日志中开启了足够的调试级别：

esp_log_level_set("wifi", ESP_LOG_DEBUG);

否则你只会看到“disconnected”，却不知道原因是AUTH_FAIL还是AP_NOT_FOUND。

💣 坑点2：明明信号很强，却连不上？

检查路由器是否启用了MAC地址过滤或隐藏SSID（scan hidden）。如果是后者，需额外设置：

.wifi_scan_method = WIFI_ALL_CHANNEL_SCAN, .scan_method = WIFI_FAST_SCAN, .ssid_len = strlen("YOUR_SSID"), // 显式指定长度

💣 坑点3：拿到IP后又丢了？

可能是电源不稳或天线设计问题。建议添加看门狗机制，在长时间无网络时重启Wi-Fi子系统。

💣 坑点4：事件回调里干了太多事？

不要在事件回调中执行耗时操作（如发起HTTP请求）。应使用队列或信号量将事件传递给独立任务处理。

八、实战增强建议：让你的连接更聪明

✅ 添加连接超时机制

避免无限等待。可以用定时器+事件标志判断：

static EventGroupHandle_t s_wifi_event_group; #define WIFI_CONNECTED_BIT BIT0 #define WIFI_FAIL_BIT BIT1 // 在event_handler中： if (event_id == IP_EVENT_STA_GOT_IP) { xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT); }

主任务中等待：

EventBits_t bits = xEventGroupWaitBits(s_wifi_event_group, WIFI_CONNECTED_BIT | WIFI_FAIL_BIT, pdFALSE, pdFALSE, pdMS_TO_TICKS(10000)); // 最多等10秒 if (bits & WIFI_CONNECTED_BIT) { ESP_LOGI(TAG, "Connected with IP!"); } else { ESP_LOGE(TAG, "Connection timeout"); }

✅ 使用LED指示连接状态

提升用户体验：

• 快闪：正在尝试连接
• 慢闪：连接失败，重试中
• 常亮：已联网

✅ 敏感信息别硬编码！

把SSID和密码存在NVS里，或者通过蓝牙/SPIFFS等方式动态注入。

示例读取NVS中的配置：

nvs_handle_t handle; nvs_open("wifi", NVS_READONLY, &handle); nvs_get_str(handle, "ssid", ssid_buf, &len); nvs_get_str(handle, "pass", pass_buf, &len);

九、结语：这是起点，不是终点

当你第一次在串口看到那句：

I (12345) TCP/IP: Got IP: 192.168.1.123

那一刻的感觉，值得纪念。

但这仅仅是个开始。有了IP，你就可以：
- 用http_client访问天气API；
- 通过mqtt_client接入云平台；
- 开启ota实现远程升级；
- 搭建本地Web服务器进行配置；

所有的高级功能，都建立在这个最基础的联网能力之上。

所以，请务必亲手跑通这段代码，理解每一个API背后的意义。不要复制粘贴就走人。

毕竟，会连Wi-Fi的ESP32千千万，懂原理的才是未来工程师。

💬互动时间：你在连接Wi-Fi时遇到过哪些奇葩问题？欢迎留言分享你的“翻车故事”和解决方法！