HoloCubic_AIO网络排障手册：WiFi掉线与重连失效的8种原因全清单
【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO
HoloCubic_AIO 是一款基于 ESP32 的超多功能 AIO 固件，为透明小电视提供天气时钟、相册、视频播放、桌面投屏、Web 服务等功能。当小电视出现WiFi 掉线、重连失效、配网后连不上时，本文用一张完整清单帮你快速定位 8 种最常见原因，新手也能照着逐项排查 🛠️。
排障前先知道：固件是怎么管理 WiFi 的
在看 8 种原因之前，先了解固件的网络机制，排查会事半功倍：
- 固件启动时会扫描 WiFi 并自动连接已保存的网络，连接等待超时时间为15 秒（见 network.h 中的
CONN_ERR_TIMEOUT定义）。 - WiFi 配置信息保存在flash中（而非内存卡），所以插不插 TF 卡都不影响联网，见 update_log.md。
- 找不到路由器时，固件会开启名为
HoloCubic_AIO的免密热点（AP 模式），手机/电脑连上后在浏览器访问http://192.168.4.2即可配网，详见 network.cpp 的open_ap()逻辑。 - 串口日志中反复打印
WiFi connect error.表示连接失败；打印Web Sever Start表示已进入 AP 配网模式。
原因一：连了 5GHz WiFi 或"双频合一"信号
这是第一大坑：HoloCubic 主板上的 WiFi 芯片只支持 2.4GHz 频段，5G 频段和"双频合一"（2.4G/5G 同名同信号）都不支持，任何固件都无法突破硬件限制（见 Q&A.md）。
✅ 解决办法：
- 登录路由器后台，把 2.4G 和 5G分开命名（如
MyWiFi和MyWiFi_5G）； - 关闭"双频合一/智能连接"功能；
- 在配网页面上选择2.4G 的那个 SSID重新配网。
原因二：密码错误，或 SSID/密码含中文、特殊字符
ESP32 配网对中文 SSID、中文密码兼容性差，特殊字符（空格、+、@等）也容易因输入遗漏而失败。固件每次连接失败后每 10 秒打印一次WiFi connect error.（见 network.cpp），如果日志显示"已连接"但应用仍无法联网，多半是 SSID 匹配对了但认证实际失败。
✅ 解决办法：把 WiFi 名和密码改成纯英文数字，重新进入Web ServerAPP 配网。
原因三：USB 供电不足，连接瞬间重启
官方 README 反复强调："为避免 wifi 连接时功率不够导致重启，请确保 USB 口供电充足"。WiFi 连接瞬间电流峰值高，充电宝、劣质线、USB Hub都可能导致小电视在配网时反复重启——现象就是"明明配好了，一联网就重连失效"。
✅ 解决办法：换用直插电脑/插墙充的原装 USB 口，避免集线器和过细数据线。
原因四：信号太弱，放在路由器"够不着"的地方
小电视经常摆在桌角、柜顶、展示架上，离路由器较远时信号衰减严重，连上也频繁掉线、DNS 解析超时。固件扫描时会在日志打印每个网络的 RSSI 信号强度（-50强、-85弱，见 network.cpp 的search_wifi()），可借此判断信号质量。
✅ 解决办法：把小电视靠近路由器，或加一个 2.4G 的 WiFi 扩展器；RSSI 低于 -75 时建议改善布线。
原因五：路由器的 MAC 过滤 / 连接设备数上限
家用路由器（尤其企业级）常开启MAC 地址白名单、限制同时连接设备数，或把小电视的 IP 分配到了其他网段，导致"配网成功却重连不上"。
✅ 解决办法：
- 关闭路由器的 MAC 过滤/设备准入；
- 给小电视绑定固定 IP（DHCP 静态分配），确保与电脑同网段——投屏、PC 资源监控等功能都要求同网段，见 README.md。
原因六：flash 中的 WiFi 配置信息损坏或未保存
固件把 WiFi 配置存在 flash 里，以下情况会导致配置"看起来有、实际无效"：刷机后没配网、配网后没等保存就断电、多次刷机残留旧配置（update_log.md 记录了配置从内存卡迁移到 flash 的过程）。
✅ 解决办法：进入Web ServerAPP，完整重填一次 SSID 和密码并保存，等待界面显示连接成功（打印 IP 地址）后再退出。
原因七：AP 热点 5 分钟未访问就自动断开
找不到已保存网络时，小电视会回退到 AP 模式放出HoloCubic_AIO热点。注意：固件内置了300 秒超时——超过 5 分钟没有设备访问配置页，热点会自动断开（见 network.cpp 的restCallback()），表现就是"热点闪一下就没了"。
✅ 解决办法：发现HoloCubic_AIO热点后，5 分钟内完成浏览器配网操作；如果热点频繁闪断，优先检查上面 1~6 项原因。
原因八：硬件虚焊导致供电/天线异常
WiFi 模块对电源纹波很敏感。主板走线紧凑，虚焊、DC-DC/LDO 元件问题都会引起间歇性掉线甚至整机重启；拓展板 GND 断路还会让屏幕背光不亮（见 Q&A.md 硬件部分）。
✅ 解决办法：
- 用 AIO 上位机观察串口打印，判断是"WiFi 模块重连"还是"整机重启"；
- 用群文件中的改良版 PCB 打样，重点检查电源部分焊接；
- 排除供电后，检查 2.4G 天线（如 AN2051）是否插紧、方向合理。
一分钟自检清单 📋
| # | 检查项 | 现象 | 对应原因 |
|---|---|---|---|
| 1 | 是否连的是 2.4G 独立信号 | 搜不到/连不上 | 原因一 |
| 2 | SSID/密码是否纯英文数字 | 反复重连 | 原因二 |
| 3 | 是否用优质 USB 口直连 | 一联网就重启 | 原因三 |
| 4 | 距离路由器多远 | 时有时无 | 原因四 |
| 5 | 路由器是否限制设备/IP | 配好却不通 | 原因五 |
| 6 | 是否完整重新配网一次 | 配置"像丢失" | 原因六 |
| 7 | 热点是否 5 分钟闪断 | 配网窗口太短 | 原因七 |
| 8 | 电源部分是否虚焊 | 掉线伴随重启 | 原因八 |
排障的核心路径就是：先串口日志看现象（连接失败 or 整机重启）→ 按上表逐项排除 → 从软件配置查到硬件供电。8 项排查完毕后，绝大多数 WiFi 掉线问题都能迎刃而解 🎉。更多功能细节可参考 README.md 与 Q&A.md。
【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
