下班回家想给ESP32搞点小东西,第一道坎永远是联网。路由器在客厅,板子在书房,连不上什么都白搭。这篇把ESP32连WiFi最常用的几个函数一次过完,照着抄就能跑,十分钟内能看到板子打印出自己的IP地址。
先说准备:代码开头引入WiFi.h这个库就够了。装ESP32板卡支持包的时候它已经自带,不用额外装任何东西,这也是ESP32比很多模块省心的地方。

一、先定模式:WiFi.mode
ESP32的WiFi有三种工作模式:station是客户端,去连别人的路由器;access point是自己当热点等别人来连;AP+STA则是两边同时干。做项目十有八九用的是station模式,所以动手前先调一句WiFi.mode(WIFI_STA),把板子定成客户端。
反过来,WiFi.mode(WIFI_AP)是开热点模式,真正把热点广播出去要靠WiFi.softAP(ssid, password),它还有通道数、最大连接数这些可选参数。AP+STA就是WiFi.mode(WIFI_AP_STA),比如做中继、配网时会用到。这篇文章只走连WiFi这条路,热点部分知道有这个开关就行。

二、三步联网:WiFi.begin与等待循环
连接本身只要三步:WiFi.mode定模式,WiFi.begin(ssid, password)发起连接,然后盯着WiFi.status()等它变成WL_CONNECTED。要填的两个变量在代码开头定义好,路由器名和密码各归各位,填错了板子可不会帮你猜。
WiFi.status()返回的是当前连接状态,常用几个值记下来就够用:3对应WL_CONNECTED,连上了;6对应WL_DISCONNECTED,断开;4对应WL_CONNECT_FAILED,几轮尝试都失败;1对应WL_NO_SSID_AVAIL,多半是SSID名字写错或者路由器隐藏了。判断连接与否,只需要盯着WL_CONNECTED这一个值。
下面这份完整示例来自教程原文,把你的路由器名和密码填进去就能用。while循环里每秒打印一个点,是等连接的经典写法,连上后顺手把IP和信号强度一起打出来。
/*
Complete details at https://RandomNerdTutorials.com/esp32-useful-wi-fi-functions-arduino/
*/
#include "WiFi.h"
// Replace with your network credentials (STATION)
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
void initWiFi() {
WiFi.mode(WIFI_STA);
WiFi.begin(ssid, password);
Serial.print("Connecting to WiFi ..");
while (WiFi.status() != WL_CONNECTED) {
Serial.print('.');
delay(1000);
}
Serial.println(WiFi.localIP());
}
void setup() {
Serial.begin(115200);
initWiFi();
Serial.print("RRSI: ");
Serial.println(WiFi.RSSI());
}
void loop() {
// put your main code here, to run repeatedly:
}
上传后打开串口监视器,波特率选115200,看到一串点后面跟一个192.168开头的地址,就成了。WiFi.localIP()随时可以再调,每次连上后打印一次是个好习惯,地址换了心里有数。
三、扫一圈网络,看看信号强度
不知道板子摆的位置信号好不好,先用WiFi.scanNetworks()扫一遍。它返回找到的网络数量,配合WiFi.SSID(i)和WiFi.RSSI(i)就能把每个网络的名字和信号强度都列出来,括号里的i是网络的序号。
int n = WiFi.scanNetworks();
Serial.print(WiFi.SSID(i));
Serial.print(WiFi.RSSI(i));
RSSI就是接收信号强度指示,单位是dBm,数值为负,越接近0信号越强。实际经验是:-30左右基本满格,板子快贴着路由器了;-70开始就有点勉强;掉到-90以下基本别指望稳定传输。天线板上老断线,先看这个数再怀疑代码。
顺带一提,WiFi.encryptionType()还能返回每个网络的加密类型,从WIFI_AUTH_OPEN到WIFI_AUTH_WPA2_PSK等一整套常量,扫完列表顺手判断自家路由器用的什么加密,也方便排查连不上的问题。


四、断线自动重连:轮询status配reconnect
路由器半夜自动重启、信号瞬断,都是家常便饭,断了不管的话板子就永远掉线了。断线后用WiFi.reconnect()可以尝试重连上一个热点;也可以先WiFi.disconnect()再WiFi.begin(ssid, password)整套重来;实在不行还有ESP.restart()直接重启板子这招,但那是最后的手段。
等待重连别用delay硬等,那会把loop里其他活儿全堵死。正确的做法是用millis()计时,每隔一段时间检查一次状态,检查之外的时间该干嘛干嘛。
下面这份示例声明了previousMillis和interval两个变量,interval是两次检查之间的毫秒数,这里设了30秒。掉线超过30秒就自动disconnect再reconnect,其余时间loop照常干自己的事。
/*
Rui Santos
Complete project details at https://RandomNerdTutorials.com/solved-reconnect-esp32-to-wifi/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*/
#include "WiFi.h"
// Replace with your network credentials (STATION)
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
unsigned long previousMillis = 0;
unsigned long interval = 30000;
void initWiFi() {
WiFi.mode(WIFI_STA);
WiFi.begin(ssid, password);
Serial.print("Connecting to WiFi ..");
while (WiFi.status() != WL_CONNECTED) {
Serial.print('.');
delay(1000);
}
Serial.println(WiFi.localIP());
}
void setup() {
Serial.begin(115200);
initWiFi();
Serial.print("RSSI: ");
Serial.println(WiFi.RSSI());
}
void loop() {
unsigned long currentMillis = millis();
// if WiFi is down, try reconnecting every CHECK_WIFI_TIME seconds
if ((WiFi.status() != WL_CONNECTED) && (currentMillis - previousMillis >=interval)) {
Serial.print(millis());
Serial.println("Reconnecting to WiFi...");
WiFi.disconnect();
WiFi.reconnect();
previousMillis = currentMillis;
}
}
这个写法的好处是简单可控,检查周期自己说了算,30秒还是5秒看项目容忍度。缺点是它属于轮询,板子得自己时不时想起来看一眼,掉线最坏要多等一个周期才被发现。
五、事件回调重连与固定IP思路
更省心的思路是WiFi事件回调。用WiFi.onEvent()注册回调函数:连上AP触发一个,拿到IP触发一个,掉线触发一个。掉线回调里直接重新WiFi.begin,不用轮询,事件一到立刻处理,比定时检查反应还快。
/*
Rui Santos
Complete project details at https://RandomNerdTutorials.com/solved-reconnect-esp32-to-wifi/
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files.
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
*/
#include "WiFi.h"
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";
void WiFiStationConnected(WiFiEvent_t event, WiFiEventInfo_t info){
Serial.println("Connected to AP successfully!");
}
void WiFiGotIP(WiFiEvent_t event, WiFiEventInfo_t info){
Serial.println("WiFi connected");
Serial.println("IP address: ");
Serial.println(WiFi.localIP());
}
void WiFiStationDisconnected(WiFiEvent_t event, WiFiEventInfo_t info){
Serial.println("Disconnected from WiFi access point");
Serial.print("WiFi lost connection. Reason: ");
Serial.println(info.wifi_sta_disconnected.reason);
Serial.println("Trying to Reconnect");
WiFi.begin(ssid, password);
}
void setup(){
Serial.begin(115200);
// delete old config
WiFi.disconnect(true);
delay(1000);
WiFi.onEvent(WiFiStationConnected, WiFiEvent_t::ARDUINO_EVENT_WIFI_STA_CONNECTED);
WiFi.onEvent(WiFiGotIP, WiFiEvent_t::ARDUINO_EVENT_WIFI_STA_GOT_IP);
WiFi.onEvent(WiFiStationDisconnected, WiFiEvent_t::ARDUINO_EVENT_WIFI_STA_DISCONNECTED);
/* Remove WiFi event
Serial.print("WiFi Event ID: ");
Serial.println(eventID);
WiFi.removeEvent(eventID);*/
WiFi.begin(ssid, password);
Serial.println();
Serial.println();
Serial.println("Wait for WiFi... ");
}
void loop(){
delay(1000);
}
注意setup开头那句WiFi.disconnect(true)是清掉旧配置再开连。事件回调里还能通过info.wifi_sta_disconnected.reason把掉线原因打印出来,是密码错了还是信号没了,串口里一目了然,排查路由器问题特别好使。另外onEvent注册后会返回一个事件ID,不需要的回调可以用removeEvent移除,代码注释里留了这个用法。
固定IP的思路也简单:在WiFi.begin之前调WiFi.config(),把IP、网关、子网掩码、DNS一次性指定好,板子每次开机都拿同一个地址。两个关键片段如下,地址换成你自己局域网网段里的。
// Set your Static IP address
IPAddress local_IP(192, 168, 1, 184);
// Set your Gateway IP address
IPAddress gateway(192, 168, 1, 1);
IPAddress subnet(255, 255, 0, 0);
IPAddress primaryDNS(8, 8, 8, 8); // optional
IPAddress secondaryDNS(8, 8, 4, 4); // optional// Configures static IP address
if (!WiFi.config(local_IP, gateway, subnet, primaryDNS, secondaryDNS)) {
Serial.println("STA Failed to configure");
}DNS两项是可选参数,可以省略。指定前先确认这个地址没被局域网里其他设备占用,不然两台设备撞IP,谁都别想好好上网。拿不准就先在路由器管理页里看看已分配的地址段,挑个靠后又不冲突的。
WiFi这一关稳了之后,后面不管是要挂网页服务器、接MQTT,还是发HTTP请求、玩ESP-NOW、进深度睡眠省电,都是在这个连接基础上加东西。先把这篇跑通,那些就都是顺手的事了。











断线重连那段是刚需,我家路由器每周自己重启一次,之前板子断了就死,现在不管它自己就回来了
RSSI那个-90的判断挺实用,扫了下发现阳台信号正好卡在-75,难怪放那儿的板子老掉线
事件回调比轮询优雅多了,掉线原因都能打出来这个细节好评,就是回调函数名起得有点长
跟着抄了一遍基础那版,填上家里WiFi密码,串口真的打出一串点然后蹦出IP,一次过,太爽了