SonoffLAN集成在Home Assistant升级后设备不可用的解决方案

问题背景
近期部分用户在将Home Assistant核心版本升级至2024.5.x系列（包括5.4和5.5版本）后，发现通过SonoffLAN集成的所有设备（包括TH传感器、RF桥接器和基础开关）均显示为"不可用"状态。值得注意的是，这些设备在官方eWeLink应用中仍能正常工作，表明问题出在集成层面而非硬件本身。

根本原因分析
从调试日志中可以观察到两个关键错误：

1. 云端登录失败：返回406错误码及"Sign:sign is error"提示，表明认证签名验证失败
2. 本地模式异常：出现"coroutine 'async_load_platform' was never awaited"的运行时警告

这些现象指向集成与Home Assistant新版本之间的兼容性问题，特别是在异步处理机制和认证流程方面。值得注意的是，部分用户错误地使用了名称包含双下划线的非标准版本（__sonoff），这进一步加剧了问题。

解决方案
经过验证，以下步骤可有效恢复设备连接：

1. 完全移除集成

   • 通过Home Assistant界面进入"设置 > 设备与服务"
   • 找到SonoffLAN集成并选择"删除"
   • 注意：仅通过HACS移除可能不够彻底

2. 重新安装集成

   • 通过HACS重新安装最新官方版本
   • 确保集成目录名称为"sonoff"（无多余下划线）

3. 重新配置集成

   • 添加集成时选择所有关联的"家庭"(Homes)
   • 建议优先尝试"自动"连接模式

4. 多次重启系统

   • 首次重启后可能仅显示部分设备（属正常现象）
   • 第二次重启等待所有设备完全加载
   • 第三次重启恢复可能失效的自动化规则

技术建议

1. 升级前务必备份配置
2. 避免使用非官方修改版本
3. 对于Zigbee设备，注意其初始化时间可能长于WiFi设备
4. 如遇持续问题，建议通过开发者工具提供完整诊断信息（包含本地和云端模式日志）

后续维护
建议用户关注SonoffLAN集成的更新日志，特别是在Home Assistant核心版本升级后。开发者已确认将针对异步加载机制进行优化，未来版本会增强与新版Home Assistant的兼容性。

通过上述方法，大多数用户可恢复设备连接。如问题持续存在，建议检查网络环境并确保使用最新稳定版的Home Assistant和SonoffLAN集成。