AIGlasses_for_navigation保姆级教学：ESP32 WiFi配置失败的5种排查方法

1. 引言

如果你正在折腾AIGlasses_for_navigation这个智能眼镜项目，并且卡在了ESP32连接WiFi这一步，那你来对地方了。我见过太多朋友满怀热情地烧录好固件，结果设备死活连不上网，最后只能对着闪烁的指示灯干瞪眼。

AIGlasses_for_navigation是一个集成了AI导航、盲道识别和实时语音交互的智能可穿戴设备。它的核心工作流程是：ESP32采集视频和音频，通过WiFi发送到服务器进行处理，再把AI的导航指令传回来。所以，WiFi连接是整套系统正常工作的“生命线”。线断了，后面所有炫酷的AI功能都成了摆设。

今天，我就把自己调试了几十台设备总结出来的经验，整理成这份保姆级的排查指南。咱们不聊深奥的网络原理，就解决实际问题。无论你是第一次接触ESP32的小白，还是遇到过奇怪网络问题的老手，都能在这里找到答案。

2. 理解问题：为什么ESP32连不上WiFi？

在开始动手排查之前，咱们先花两分钟搞清楚ESP32联网的基本逻辑。这能帮你更快地定位问题所在，而不是像无头苍蝇一样乱试。

ESP32连接WiFi，可以简单理解为三步握手：

1. 扫描网络：ESP32启动后，会像手机一样搜索周围的WiFi信号。
2. 身份认证：它拿着你代码里写的SSID（WiFi名称）和密码，去尝试连接对应的路由器。
3. 获取IP：连接成功后，路由器会给ESP32分配一个局域网内的IP地址（比如192.168.1.105）。

整个过程中，任何一个环节出问题都会导致失败。常见的错误提示，比如 WiFi连接超时、密码错误 或者 无法获取IP地址，其实就是这三步里某一步卡住了。

对于AIGlasses_for_navigation项目，还有一个特殊点：它需要让ESP32和运行AI服务的电脑/服务器在同一个局域网内。因为视频流和指令是通过本地网络传输的，如果ESP32连的是你家WiFi，而服务器用的是手机热点，那它俩根本“看不见”对方，自然无法通信。

3. 方法一：检查最基础的硬件与代码

这是最简单，但也最容易被忽略的一步。很多“诡异”的问题，根源往往就在这里。

3.1 确认硬件供电稳定

ESP32，尤其是搭载了摄像头模组（ESP32-CAM）的版本，在启动和连接WiFi时功耗较大。供电不足会导致芯片工作不稳定，表现为反复重启或根本无法连接网络。

• 排查方法：确保使用5V/2A以上的稳定电源适配器供电。如果使用电脑USB口供电，尝试换到后置的USB3.0接口，或者直接使用手机充电头。观察设备上的电源指示灯是否明亮、稳定，无闪烁。

3.2 核对Arduino代码配置

打开项目中的 compile/compile.ino 文件，找到设置WiFi的部分（通常以 WiFi.begin 开头）。你需要像核对账号密码一样，仔细检查以下两行：

const char* ssid = "Your_WiFi_SSID";     // 你的WiFi名称
const char* password = "Your_WiFi_Pass"; // 你的WiFi密码

• 常见坑点1：大小写和特殊字符。WiFi名称和密码是区分大小写的，并且要完整包含所有空格、下划线等特殊字符。最好直接复制粘贴。
• 常见坑点2：隐藏的换行符或空格。有时从文档复制时，可能会不小心带上不可见的字符。一个保险的做法是，手动重新输入一遍密码。
• 常见坑点3：WiFi加密方式。确保你的路由器使用的是WPA2或WPA3加密。ESP32对老旧的WEP加密或某些企业级加密方式支持不好。

3.3 验证串口监视器输出

将ESP32通过USB线连接到电脑，打开Arduino IDE的串口监视器（工具 -> 串口监视器），将右下角的波特率设置为 115200。然后给ESP32复位或重新上电。

• 正常情况：你会看到类似以下的输出，清晰地表明连接成功并获得了IP。

  Connecting to WiFi...
  WiFi connected!
  IP address: 192.168.1.105
  

• 异常情况：如果一直卡在 Connecting...，或者出现 Connection failed、Wrong password 等错误，就说明问题出在连接阶段。

4. 方法二：排查路由器与网络环境问题

如果硬件和代码确认无误，那么“战场”就转移到了你的网络环境。家用路由器有时候也会闹点小脾气。

4.1 检查路由器设置

有些路由器为了安全，会开启一些限制功能，恰好就把ESP32给“误伤”了。

• MAC地址过滤：登录路由器管理后台（通常是192.168.1.1），检查是否开启了MAC地址过滤。如果开启了，你需要找到ESP32的MAC地址（可以在连接失败时的串口日志里找到，或者用简单的扫描代码获取），并将其添加到路由器的允许列表中。
• AP隔离（客户端隔离）：这个功能会禁止连接在同一个WiFi下的设备之间互相访问。必须关闭它！ 因为AIGlasses需要让ESP32和你的服务器电脑互相通信。在路由器无线设置或高级安全设置里找到并关闭“AP隔离”或“客户端隔离”。
• DHCP地址池耗尽：路由器能分配的IP地址是有限的。如果家里智能设备太多，可能IP地址被分完了。尝试重启路由器，或者登录后台，查看已连接设备列表，将一些不用的设备断开。

4.2 尝试连接手机热点

这是一个非常有效的“排除法”。用你的手机开一个2.4GHz的热点（注意：ESP32通常只支持2.4GHz网络，不支持5GHz），然后将 compile.ino 代码中的SSID和密码改成手机热点的信息，重新烧录测试。

• 如果连上了：那问题肯定出在你的家用路由器设置上。回头重点检查上面提到的路由器隔离、过滤等功能。
• 如果还是连不上：那问题可能更偏向于ESP32本身、代码，或者手机热点本身有特殊限制（比如某些手机热点的兼容性问题）。

4.3 确保网络频段与信号强度

• 2.4GHz网络：这是必须的。请确保你连接的是路由器的2.4GHz频段，名称可能是类似 MyWiFi 和 MyWiFi_5G 的区别。
• 信号强度：将ESP32尽量靠近路由器进行测试。信号太弱（如隔了好几堵墙）会导致握手过程不稳定而失败。

5. 方法三：诊断与服务器端的通信

ESP32连上WiFi只是第一步，它还需要成功连接到运行AIGlasses_for_navigation服务的服务器（WebSocket服务）。这部分问题在串口监视器里会有不同表现。

5.1 理解连接流程

在 compile.ino 代码中，ESP32在获取IP后，会尝试连接一个特定的WebSocket服务器地址，例如：

WebSocketClient webSocketClient;
webSocketClient.begin("192.168.1.100", 8081, "/ws"); // 服务器IP和端口

这里的 192.168.1.100 必须是你运行 app_main.py 的那台电脑的局域网IP地址。

5.2 排查“服务器不可达”错误

如果在串口看到 WebSocket connection failed 或类似的超时错误：

1. 确认服务器IP：在服务器电脑上，打开命令行，输入 ipconfig (Windows) 或 ifconfig (Mac/Linux)，找到正确的局域网IPv4地址（通常是192.168.x.x或10.x.x.x）。不要使用127.0.0.1或localhost，那是电脑自己的环回地址，ESP32无法访问。
2. 确认服务器程序已运行：在服务器电脑上，确保你已经成功启动了AIGlasses服务。可以通过在终端运行 supervisorctl status aiglasses 来查看状态是否为 RUNNING。
3. 关闭防火墙：服务器电脑的防火墙可能会阻止8081端口的连接。为了测试，可以暂时完全关闭防火墙（测试完记得打开），或者添加一条规则允许8081端口的入站连接。
4. 网络互通性测试：找一个和ESP32在同一WiFi下的手机或另一台电脑，打开浏览器，尝试访问 http://[服务器IP]:8081。如果打不开，说明服务器服务没起来或网络不通，ESP32自然也无法连接。

6. 方法四：高级软件与固件排查

当所有基础检查都通过后，问题可能藏在更深的地方。

6.1 更新ESP32核心库与WiFi库

Arduino IDE的库版本过旧可能会导致兼容性问题。打开“工具 -> 开发板 -> 开发板管理器”，搜索“esp32”，确保你安装的是较新版本的ESP32开发板支持包（如2.0.x版本）。有时，选择不同的“Core Version”也会有影响。

6.2 检查并修改WiFi连接参数

默认的WiFi连接超时时间可能在某些网络环境下不够用。你可以在 compile.ino 的 setup() 函数中，WiFi.begin 之前或之后，添加一些配置来增强连接稳定性：

WiFi.mode(WIFI_STA); // 明确设置为站点模式
WiFi.setAutoReconnect(true); // 启用自动重连
WiFi.persistent(false); // 可选：不将WiFi配置保存到flash，避免配置冲突

// 尝试增加连接尝试次数
int retryCount = 0;
while (WiFi.status() != WL_CONNECTED && retryCount < 20) { // 尝试20次
    delay(500);
    Serial.print(".");
    retryCount++;
}

6.3 使用更简单的测试代码

为了彻底排除是项目复杂代码导致的问题，可以创建一个全新的Arduino工程，只写入最基础的WiFi连接代码进行测试：

#include <WiFi.h>

const char* ssid = "Your_SSID";
const char* password = "Your_PASS";

void setup() {
  Serial.begin(115200);
  delay(1000);

  Serial.println("\nConnecting to WiFi...");
  WiFi.begin(ssid, password);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println("\nWiFi Connected!");
  Serial.print("IP Address: ");
  Serial.println(WiFi.localIP());
}

void loop() {
  // 什么都不做
}

如果这个简单代码能连上，但项目代码连不上，就需要对比分析项目代码中在WiFi连接前后还做了什么（比如初始化摄像头、SD卡等），可能是这些操作影响了WiFi模块的初始化。

7. 方法五：终极硬件与替代方案

如果以上所有软件方法都无效，我们需要考虑硬件本身是否存在问题。

7.1 检查ESP32模块与天线

• 天线连接：如果你的ESP32模块带有外置天线接口，请确保天线已牢固连接。对于PCB板载天线，确保其没有被金属物体遮挡或损坏。
• 模块差异：市面上ESP32模块型号繁多（ESP32-WROOM, ESP32-S3, ESP32-CAM等），其WiFi射频性能可能有细微差异。如果条件允许，换一个不同品牌或批次的ESP32模块测试，是判断硬件问题的金标准。

7.2 利用项目内置的“无硬件”测试模式

AIGlasses_for_navigation项目设计得非常贴心，它考虑到了硬件调试的困难。即使ESP32完全无法连接，你依然可以验证核心AI服务是否正常。

1. 确保你的服务器电脑已经按照教程正确配置并运行了服务（supervisorctl status aiglasses 显示为 RUNNING）。
2. 在服务器电脑或同一局域网内的任何设备上，打开浏览器，访问 http://[服务器IP]:8081。
3. 如果页面成功加载，你会看到右下角的系统状态面板。这里会清晰显示：
   • ✅ 服务运行状态
   • ✅ API配置状态（需要你先配置好阿里云DashScope的API Key）
   • ✅ 各个AI模型（盲道、红绿灯、物品识别）的加载情况
   • ❌ 摄像头连接状态（此时会显示未连接，这是正常的）
4. 你可以点击页面上传一个本地视频文件，测试盲道检测、物品识别等功能。如果这些功能都工作正常，那么恭喜你，服务器端的AI服务是完好的，问题100%锁定在ESP32到网络的这个连接环节。

8. 总结

给ESP32配置WiFi，就像给一把智能锁配对手机，步骤不复杂，但任何一个细节出错都会导致失败。通过上面这五个层次的排查方法，绝大多数连接问题都能被解决。

我们来快速回顾一下这条清晰的排查路径：

1. 从最简单开始：核对代码里的WiFi密码，检查串口输出信息。
2. 审视网络环境：关闭路由器的“AP隔离”，尝试连接手机热点进行隔离测试。
3. 打通通信链路：确认服务器IP正确、服务已运行、防火墙已放行。
4. 深入软件层面：更新库、调整连接参数、用最简代码测试。
5. 怀疑硬件与利用备选方案：更换模块测试，同时利用项目自带的Web界面验证服务本身是否正常。

调试的过程就是不断缩小问题范围的过程。别怕麻烦，一步步来。当ESP32的串口终于打印出 WiFi connected! 和那个宝贵的IP地址时，你会觉得这一切都是值得的。接下来，你就可以尽情体验AIGlasses_for_navigation带来的智能导航世界了。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。