WLED项目中WiFi配置异常问题的分析与解决方案

问题背景

在智能家居系统中，WLED作为一款流行的LED灯带控制软件，其网络连接的稳定性至关重要。近期有用户报告了一个特殊的WiFi配置问题：当用户更改了WiFi网络名称(SSID)后，WLED设备在重启后会恢复使用旧的WiFi配置，而不是保持最新的网络设置。

问题现象

用户最初将WLED设备配置连接到WiFi网络A，后来将网络名称更改为WiFi网络B。尽管在WLED界面中设置了新的网络信息，但设备在以下情况下会出现异常：

1. Home Assistant服务重启时
2. 设备意外断电后
3. 经过一段时间后（约5小时至几天）

当问题发生时，WLED会断开当前网络连接，恢复使用最初的WiFi网络A的配置。用户需要重新通过WLED的接入点手动配置网络连接。

排查过程

初步验证

1. 检查WLED版本：0.14.4 (build 2405180)
2. 硬件平台：ESP32
3. 安装方式：官方二进制文件

测试步骤

1. 执行恢复出厂设置操作
2. 手动配置新的WiFi网络
3. 观察配置是否持久化
4. 恢复配置文件后再次观察

发现的问题点

• 即使执行了恢复出厂设置，当恢复配置文件后，问题会重现
• 检查配置文件时发现旧的WiFi配置信息被保留
• 问题似乎与Home Assistant无关，因为即使移除HA集成，问题仍然存在

根本原因

经过深入排查，发现问题的根源在于：

1. 用户早期在Home Assistant中创建了一个自动化规则
2. 该规则会在特定条件下向WLED设备发送HTTP请求
3. 请求中包含旧的WiFi网络配置信息
4. 由于触发条件较为罕见，导致问题表现不稳定

解决方案

1. 彻底解决方案：

   • 检查并删除Home Assistant中所有可能修改WLED配置的自动化规则
   • 特别关注那些发送HTTP请求到WLED设备的规则

2. 临时解决方案：

   • 执行完整的设备重置（擦除闪存）
   • 重新刷写最新固件
   • 手动配置新的WiFi网络，不恢复旧的配置文件

3. 预防措施：

   • 定期审查自动化规则
   • 在更改网络配置时，同步更新所有相关自动化
   • 考虑使用变量存储WiFi配置，而不是硬编码在自动化中

技术建议

1. 配置文件管理：

   • 修改WiFi配置后，建议导出并检查配置文件
   • 使用JSON格式化工具验证配置内容
   • 特别注意"nw":{"ins":[...]}部分

2. 测试方法：

   • 创建测试WiFi网络专门用于验证
   • 使用不同SSID进行长时间稳定性测试
   • 监控设备日志以识别配置变更的来源

3. 最佳实践：

   • 重要变更后保留多个版本的配置文件
   • 使用版本控制系统管理配置文件
   • 建立变更记录文档

经验总结

这个案例展示了IoT系统中一个典型的问题排查过程：

1. 表面现象可能掩盖真正的原因
2. 系统间的自动化交互可能产生意想不到的影响
3. 配置管理需要全面考虑所有可能的修改途径

对于WLED用户，建议在遇到类似问题时：

1. 首先检查所有外部系统对设备的配置修改
2. 采用分步隔离法确定问题范围
3. 建立完整的测试环境重现问题

通过这次问题的解决，我们再次认识到在智能家居系统中，配置一致性和变更管理的重要性。只有全面考虑所有可能的配置来源，才能确保系统的稳定运行。