小米 Home Assistant 集成更新后浴霸模式控制消失？5 步找回
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
小米 Home Assistant 集成更新到0.2.1版本后，部分用户发现浴霸实体只剩下灯光开关，原本可用的换气、暖风、干燥等模式控制全部不见了。本文梳理该问题的触发条件、背后原因与一条已验证的修复路径。
现象与触发条件
- 症状：设备实体中仅显示“灯”，模式选择实体缺失。
- 触发场景：集成升级到
0.2.1后重新添加设备，或修改过实体转换规则后实体被重建。 - 自查方法：给浴霸通电后查看实体列表，若模式项消失、灯光仍在，基本可以确认命中此问题。
波及面
- 奥普浴霸
aupu.bhf_light.s10m - 奥普浴霸
aupu.bhf_light.s11m - 易来浴霸
yeelink.bhf_light.v5 - 仅“模式控制”一项受影响，灯光开关与基础状态显示均正常。
- 空调、风扇、扫地机等其他品牌与品类不在波及范围内，不必恐慌。
背后发生了什么
集成的工作方式是：先从 MIoT 规范拉取设备的原始属性清单，再经过一层“实体转换规则”，把每个属性映射成 Home Assistant 的对应实体——开关、选择器、气候等。
0.2.1版本中，bhf_light品类的模式属性没有对上设备规范里的实际字段，于是模式属性在转换环节被当作“不认识”直接跳过；而灯光属性匹配正常，所以只剩下灯实体。
也就是说，设备本身没有问题，问题出在中间的映射这一步：指令链路断在了“属性 → 实体”这一环，模式指令根本派发生成不到实体上。
修复路线图
该问题已在 PR#899 中修复。建议按顺序完成以下操作：
- 更新到包含 PR#899 的最新版本，安装与更新方法可参考 doc/README_zh.md。
- 重启 Home Assistant 服务，让新规则生效。
- 打开 Xiaomi Home 集成的配置选项页面，勾选“更新实体转换规则”与“更新设备列表”。
- 移除受影响的浴霸设备，然后重新添加该设备。
- 验证点：设备实体下重新出现模式实体，且切换换气、暖风、干燥均实时生效。
五步全部完成后修复才算闭环。若只做了第 1 步，旧的实体缓存仍会沿用，症状不会消失。
排查思路延伸
对开发者而言，这类问题有一条通用排查路径：
- 核对原始数据：打印设备的 MIoT 原始规范，确认模式属性真实存在且字段名正确。
- 验证转换规则：检查 custom_components/xiaomi_home/miot/specs/ 下的映射表，确认该属性未被过滤或漏配。
- 追踪指令链路：发送一条模式指令，确认它是否正确派发到 MQTT Broker 或网关侧的 HTTP 通道。
原始数据正常而规则缺失，改规则；规则存在而指令不达，查链路。定位问题基本都能在这三步之内收敛。
少踩坑指南
- 升级集成版本前备份配置目录，出问题时可快速回滚到旧版本。
- 定期查看 CHANGELOG.md，确认新版本修复了哪些设备与属性。
- 反馈问题时提供三要素：设备型号、集成版本号、具体现象，信息越全定位越快。
- 修复完成后保持“实体转换规则”与“设备列表”同步更新，避免新旧规则混用造成二次漂移。
【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
