HoloCubic_AIO网络排障手册WiFi掉线与重连失效的8种原因全清单【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIOHoloCubic_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 同名同信号都不支持任何固件都无法突破硬件限制见 QA.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 过滤/设备准入给小电视绑定固定 IPDHCP 静态分配确保与电脑同网段——投屏、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 断路还会让屏幕背光不亮见 QA.md 硬件部分。✅ 解决办法用 AIO 上位机观察串口打印判断是WiFi 模块重连还是整机重启用群文件中的改良版 PCB 打样重点检查电源部分焊接排除供电后检查 2.4G 天线如 AN2051是否插紧、方向合理。一分钟自检清单 #检查项现象对应原因1是否连的是 2.4G 独立信号搜不到/连不上原因一2SSID/密码是否纯英文数字反复重连原因二3是否用优质 USB 口直连一联网就重启原因三4距离路由器多远时有时无原因四5路由器是否限制设备/IP配好却不通原因五6是否完整重新配网一次配置像丢失原因六7热点是否 5 分钟闪断配网窗口太短原因七8电源部分是否虚焊掉线伴随重启原因八排障的核心路径就是先串口日志看现象连接失败 or 整机重启→ 按上表逐项排除 → 从软件配置查到硬件供电。8 项排查完毕后绝大多数 WiFi 掉线问题都能迎刃而解 。更多功能细节可参考 README.md 与 QA.md。【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考