Home Assistant Home Connect 设备离线、状态不更新5类典型故障一次修好【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core凌晨两点洗碗机面板显示运行中HA 面板里那台设备却已经灰了40分钟点启动毫无反应。Home Assistant Home Connect 设备离线、状态异常断点往往落在认证、网络、事件流、限流、设备五层之一而不是笼统的网络问题。本文先定位断在哪一层再给出逐层修复动作完整分诊约需10到20分钟。 症状分诊Home Assistant Home Connect 设备离线断在哪一层症状根因层定位方法同一配置条目下所有设备同时变灰界面提示重新授权认证层日志 grepConfigEntryAuthFailed/UnauthorizedError条目始终加载失败日志反复出现ConfigEntryNotReady网络层服务器测试到 api.home-connect.com:443 的连通性单台设备状态冻结日志出现Non-breaking error事件流层grep home_connect 日志中的重试间隔与事件流错误控制服务返回 429状态延迟数分钟限流层grep 日志Rate limit exceeded仅单台设备离线Home Connect APP 中同样显示离线设备层检查设备供电与 WiFi用 APP 确认在线状态控制报 Remote control disabled设备层查看设备remote_control二态传感器先按表格定位层再跳到修复手册对应小节分诊阶段不需要执行任何修复操作。机制透视集成内部到底在跑什么条目 setup 时Home Assistant 先从 OAuth2 配置条目取访问令牌刷新令牌失效直接抛ConfigEntryAuthFailed网络不通则抛ConfigEntryNotReady这是认证层与网络层的分界点。逻辑在 homeassistant/components/home_connect/init.py 的async_setup_entry中完成。状态更新依赖双通道一条常驻的服务器推送事件流加每台设备一个 DataUpdateCoordinator 轮询。事件流断线后的重试策略是 10 秒起步、每次失败翻倍、上限 1 小时见 homeassistant/components/home_connect/coordinator.py 的_event_listener。流长时间中断设备状态就停更这正是 Bosch 家电 HA 状态不同步的常见根源。轮询遇到 429 时不会立刻报错而是按retry_after休眠后重试默认回退 60 秒定义在 homeassistant/components/home_connect/const.py。实体发起的服务调用还经过constraint_fetcher装饰器捕获 TooManyRequestsError 后改期重发见 homeassistant/components/home_connect/entity.py。每台设备的数据组织成一组按 BSH 键索引的字典与诊断最相关的字段{ BSH.Common.Status.OperationState: Run, BSH.Common.Status.DoorState: Closed, BSH.Common.Status.RemoteControlActive: true, BSH.Common.Status.RemainingTime: 1200, } 根因修复手册逐层处理 Home Connect 设备离线修复认证层OAuth 令牌失效确认信号grep -E Unauthorized|ConfigEntryAuthFailed /var/log/home-assistant.log预期输出包含UnauthorizedError或条目在界面显示需重新授权。若 grep 为空且全部设备同时变灰转网络层。修复动作在 设置 → 设备与服务 → Home Connect 卡片上完成重新授权浏览器走完 OAuth 流程。授权完成后重载条目重启事件流与全部协调器重载 Home Connect 配置条目service: homeassistant.reload_config_entry data: entry_id: 替换为你的条目 ID验证闭环条目状态回到已加载各设备实体由灰变可用日志不再新增 Unauthorized 行。修复网络层服务器到 API 不通确认信号curl -sI https://api.home-connect.com/api/homeappliances | head -n1预期输出HTTP/2 401或HTTP/1.1 401 Unauthorized。返回 401 说明连接通但令牌未验证网络层正常超时或 DNS 解析失败才是网络层故障。修复动作检查服务器 DNS 与 443 出站策略容器部署时确认网桥网络与默认路由。走代理的环境为容器配置代理后重启 Home Assistant。重测上述 curl直到返回 401。验证闭环curl 返回 401 后条目停止ConfigEntryNotReady重试并自动完成加载。修复事件流层流中断或连接抖动确认信号grep -E Non-breaking error|Too many connected/paired /var/log/home-assistant.log | tail -n 20预期输出两种之一Non-breaking error (...) while listening for events, continuing in N secondsN 从 10 秒起按倍增加或Too many connected/paired events表示设备在反复连接断开协调器已主动停用更新每小时 8 次即触发。修复动作N 持续增大时拔除设备电源 30 秒再通电强制设备侧重建连接。出现 too many 警告时优先排查路由器到设备的信号再断电软复位设备。重载配置条目重启事件流监听。这一步卡住的话多数情况不是 Home Assistant 的问题设备侧网络模块才是源头。验证闭环日志出现新的事件流活动continuing in的间隔回到 10 秒设备状态恢复实时刷新。修复限流层与设备层429 节流和真离线确认信号终端执行grep -c Rate limit exceeded /var/log/home-assistant.log非零返回说明存在 429 限流日志同时记录了每次重试等待的秒数无 429 且仅单台设备离线则属设备层用 Home Connect APP 确认该设备是否在线。修复动作限流层降低自动化查询频率同一设备两次控制间隔留足 30 秒避免并发下发指令。设备层断电 30 秒重上电在 APP 中确认设备在线。控制报 Remote control disabled 时在设备面板开启远程控制对应remote_control传感器应变为 on。验证闭环状态更新延迟从分钟级回到秒级日志中 429 计数停止增长。如果以上都试过仍然不行四层逐一排除后条目依旧加载失败或单台设备不恢复属于设备侧协议异常这类少数情况。把 home_connect 组件日志级别调到 DEBUG 跑一轮连同 设置 → 设备与服务 → Home Connect 条目菜单里的诊断数据一并导出提交到 Home Assistant 社区论坛并附上复现步骤与固件版本。️ 主动防御让问题不再静默发生当设备远程控制状态变为 off 时立即推送到已配置的 notify 服务避免故障静默累积# 设备远程控制失效时推送通知 alias: Home Connect 远程控制失效告警 trigger: - platform: state entity_id: binary_sensor.dishwasher_remote_control to: off action: - service: notify.mobile_app_phone data: message: {{ trigger.to_state.entity_id }} 远程控制已关闭检查设备网络配置后在状态视图里观察触发与推送链路是否闭环低频维护建议每月对每台设备断电复位一次清除临时性网络故障。在 Home Connect APP 中检查固件版本保持更新。关注 Home Assistant 版本发布说明及时获知 Home Connect API 变更与集成行为调整。下次洗碗机深夜变灰先查断在哪一层再动手。更多实现细节见 homeassistant/components/home_connect/ 源码目录。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考