ESP32连WiFi实操:WiFi.begin与断线重连

2026-11-14 20:34:51 128阅读 所属项目:ESP32 开发板

下班回家想给ESP32搞点小东西,第一道坎永远是联网。路由器在客厅,板子在书房,连不上什么都白搭。这篇把ESP32连WiFi最常用的几个函数一次过完,照着抄就能跑,十分钟内能看到板子打印出自己的IP地址。

先说准备:代码开头引入WiFi.h这个库就够了。装ESP32板卡支持包的时候它已经自带,不用额外装任何东西,这也是ESP32比很多模块省心的地方。

ESP32常用WiFi函数教程的Arduino IDE演示图

一、先定模式: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这条路,热点部分知道有这个开关就行。

ESP32以station模式连接路由器的示意图

二、三步联网: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等一整套常量,扫完列表顺手判断自家路由器用的什么加密,也方便排查连不上的问题。

ESP32扫描周边WiFi网络的串口监视器输出

ESP32打印WiFi连接强度与IP地址的串口输出

四、断线自动重连:轮询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、进深度睡眠省电,都是在这个连接基础上加东西。先把这篇跑通,那些就都是顺手的事了。


作者:工位上的小周
链接:https://www.aiddithome.com/p/4b4f98602cd37.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
只看不说话
1楼 · 2026-11-14 20:35:38

断线重连那段是刚需,我家路由器每周自己重启一次,之前板子断了就死,现在不管它自己就回来了

刷视频进来围观
2楼 · 2026-11-14 20:35:38

RSSI那个-90的判断挺实用,扫了下发现阳台信号正好卡在-75,难怪放那儿的板子老掉线

学生党玩机
3楼 · 2026-11-14 20:35:38

事件回调比轮询优雅多了,掉线原因都能打出来这个细节好评,就是回调函数名起得有点长

触底反弹的Tony
4楼 · 2026-11-14 20:35:37

跟着抄了一遍基础那版,填上家里WiFi密码,串口真的打出一串点然后蹦出IP,一次过,太爽了