Home Assistant ViCare 认证升级后设备离线3 步完成 Client ID 重配完整指南【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core如果你的 Home Assistant 里 ViCare 集成最近突然连不上别急着换设备——这多半是认证机制升级带来的连锁反应。本文带你把 Viessmann ViCare 集成重配一遍从故障定位、OAuth 2.0 认证原理讲起到 Client ID 申请、令牌文件清理给你一套完整的操作路径和排查清单。先对号入座认证升级后这三类症状指向同一原因升级期间你可能遇到下面任意一种情况设备状态卡在未知传感器数值不再刷新调温度、开风扇这类控制指令发出去没反应系统日志里反复跳出401 Unauthorized三种表现看起来分散但根子是同一个认证环节断了。旧版集成拿账号密码就能直接登录 API新版 Home Assistant 换成了 OAuth 2.0 应用凭证认证缺了 Client ID 或本地令牌失效数据链路就整条停摆。社区反馈里升级公告发布后的一到两天是故障集中出现期尤其集中在 2024 年年中之前按旧流程配置过的集成。认证机制变了什么从每次报账到先拿通行证理解这一步后面的操作才有依据。改动集中在 homeassistant/components/vicare/ 模块。登录时系统把账号、密码、Client ID 和令牌文件路径一起交给 PyViCare 库vicare_api.initWithCredentials( entry_data[CONF_USERNAME], entry_data[CONF_PASSWORD], entry_data[CONF_CLIENT_ID], hass.config.path(STORAGE_DIR, VICARE_TOKEN_FILENAME), )认证流程被拆成三段账号密码交给 Viessmann 服务器核验服务器用 Client ID 确认这个应用有权访问你的设备签发访问令牌加密落盘到本地。之后所有数据请求都走令牌 Client ID不再每次重传密码。令牌文件常量定义在 homeassistant/components/vicare/const.pyVICARE_TOKEN_FILENAME vicare_token.save DEFAULT_CACHE_DURATION 60两个细节值得记住令牌文件名是vicare_token.save不是旧文档里常见的.json后缀找文件时别找错缓存周期默认 60 秒而且会随设备数量成倍拉长——设备越多请求越省这本身就是官方给的限流缓冲。重新配置的三个步骤申请 Client ID、删除旧条目、重新添加第一步在厂商门户拿到 Client ID登录 Viessmann 官方开发者门户集成配置页里有直达入口也可在浏览器搜索 Viessmann developer portal 找到创建一个新应用权限勾选设备查看和控制相关项复制生成的 Client ID形如abc123-def456-ghi789。第二步在 Home Assistant 里删除并重配集成打开设置 → 设备与服务找到 Viessmann ViCare 条目删除它在同一页面重新添加 ViCare 集成输入原有账号密码和刚拿到的 Client ID保存后等集成跑完首次认证。⚠️ 重配窗口期设备会短暂离线属于预期现象如果你选择删除令牌缓存而不是重配同样会触发一次重新登录期间数据不会更新。整个过程顺利的话三五分钟能走完期间保持网络稳定。第三步用设备状态页确认恢复三个验收点传感器数值恢复滚动更新状态不再是未知手动调一次设定温度确认设备真实响应翻一遍系统日志确认不再刷出 401 认证错误。三条都过了这次升级才算真正落地。排障清单令牌文件、Client ID 与 API 限流认证还是失败按这个顺序查先查账号同一组账号密码能否在 Viessmann 官网正常登录登录不了就是账号侧问题与 Home Assistant 无关再查 Client ID逐字符核对重点看首尾空格和大小写——这类错误最隐蔽最后查令牌文件确认.storage目录下vicare_token.save存在、非空、权限正常仅运行 Home Assistant 的用户可读写。实在不行删掉这个文件再重新登录让它重新生成一份干净的令牌。日志里刷 PyViCareRateLimitError 怎么办这是厂商 API 的限流保护说明你的请求太密集了。处理思路自动化任务里涉及 ViCare 的操作相邻触发间隔至少留 60 秒依赖数据新鲜度的场景靠调大缓存周期解决而不是加轮询避免同一分钟内对多台设备批量下发控制指令改成错峰执行。升级之后的日常三条维护建议把.storage目录纳入你的配置备份范围令牌文件丢了重新登录就能补但备份多一层安心清理缓存前先确认令牌文件名是vicare_token.save别删错文件保持 Home Assistant 核心与 ViCare 集成同步更新认证类问题大多跟着版本走旧版本上修不了。 顺带一提Viessmann 这次改造后Nest 等其他云集成也普遍走OAuth 2.0 应用凭证 本地令牌的路子。下次再看到哪类云集成突然要求 Client ID套路基本一致——厂商门户建应用、拿 ID、重配集成。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考