解决Xiaomi MIOT集成中"未找到设备"问题的技术指南

问题背景

近期许多用户在使用Xiaomi MIOT集成时遇到了"未找到设备"的问题，表现为集成无法识别已连接的Xiaomi设备，同时在配置过程中出现"SERVICETOKEN_EXPIRED"或"invalid signature"等错误提示。这一问题主要影响使用本地模式连接设备的用户，但云模式用户也可能遇到类似情况。

问题原因分析

经过技术分析，这一问题主要由以下几个因素导致：

1. 服务令牌过期：Xiaomi云服务的认证机制发生了变化，导致原有的服务令牌(SERVICETOKEN)过期失效
2. 签名验证失败：API请求的签名验证机制更新，旧版本的签名方式不再被接受
3. 账户认证流程变更：Xiaomi调整了账户认证流程，需要重新进行完整的登录验证

解决方案

方法一：升级到最新主分支版本

开发者已修复了这一问题，推荐用户升级到最新主分支版本：

1. 通过SSH连接到Home Assistant主机
2. 执行以下命令进行升级：

wget -O - https://get.hacs.vip | DOMAIN=xiaomi_miot ARCHIVE_TAG=master bash -

3. 重启Home Assistant服务

方法二：重新配置账户

如果升级后问题仍然存在，可以尝试以下步骤：

1. 在集成设置中完全移除现有的Xiaomi账户配置
2. 重新添加账户，确保勾选"强制更新设备列表"选项
3. 完成认证流程后，系统会重新发现设备

方法三：降级到稳定版本

部分用户反馈v0.7.21版本较为稳定，可以暂时降级使用：

1. 在HACS中卸载当前版本
2. 手动安装v0.7.21版本
3. 重启Home Assistant服务

技术细节说明

当出现"SERVICETOKEN_EXPIRED"错误时，表示Xiaomi云服务拒绝了请求，因为认证令牌已过期。这通常是由于：

• 服务端安全策略更新
• 长期未重新认证
• 集成使用的认证方式已过时

"invalid signature"错误则表明请求的签名验证失败，这通常是因为：

• 签名算法变更
• 请求参数格式不符合新要求
• 时间戳验证更加严格

最佳实践建议

1. 定期更新：保持Xiaomi MIOT集成处于最新版本
2. 监控日志：关注Home Assistant日志中的Xiaomi相关错误
3. 备用方案：考虑配置本地模式作为云模式的备份
4. 账户管理：避免频繁更换账户，减少认证问题

结论

Xiaomi MIOT集成的设备识别问题主要是由服务端认证机制变更引起的。通过升级到最新版本或重新配置账户，大多数用户都能解决这一问题。开发团队正在持续优化集成，以适应Xiaomi生态系统的变化，建议用户关注更新日志以获取最新改进。