Domoticz项目中Evohome设备登录失败问题解决方案

问题背景

近期部分Domoticz用户反馈其集成的Honeywell Evohome智能温控系统出现同步失败问题，系统日志显示"Login failed with message: invalid_grant"错误。该问题主要出现在Domoticz 2024.4版本中，表现为虽然用户能够通过浏览器正常登录Evohome官方控制面板，但Domoticz插件却无法完成认证。

根本原因分析

经过技术社区排查，该问题主要由以下两个因素共同导致：

1. 密码策略变更：Evohome服务端近期更新了密码策略，对特殊字符的支持出现兼容性问题
2. API调用限制：Domoticz中Evohome插件的默认轮询间隔设置过于频繁，可能触发服务端的API限制

详细解决方案

第一步：密码重置

1. 登录Evohome官方账户管理页面
2. 创建符合以下要求的新密码：
   • 长度至少8位
   • 包含至少一个大写字母
   • 包含至少一个小写字母
   • 包含至少一个数字
   • 仅使用一个特殊字符（推荐使用星号*）

第二步：Domoticz配置调整

1. 进入Domoticz控制面板的"硬件"设置页面
2. 找到"Evohome via web API"硬件设备
3. 进行以下参数调整：
   • 禁用"显示计划"选项（Show Schedule）
   • 保持"同步安装"（Synchronize Installation）和"显示位置"（Show Location）为启用状态
   • 将"轮询间隔"（Poll Interval）设置为300秒（5分钟）以上

第三步：更新凭证

1. 在硬件配置页面更新密码字段，使用新创建的密码
2. 点击"更新"按钮保存配置

技术原理说明

该解决方案通过以下机制解决问题：

1. 简化密码复杂度：减少特殊字符数量可避免服务端认证模块的解析异常
2. 优化API调用：延长轮询间隔既符合Evohome API的最佳实践，又能防止触发速率限制
3. 精简数据请求：禁用非必要的计划数据获取可降低认证负载

预防措施建议

1. 定期检查Domoticz的插件更新，及时获取官方修复
2. 避免在密码中使用多个特殊字符组合
3. 对于自动化系统使用的账户，建议创建专用API凭证（如服务支持）
4. 监控系统日志，关注认证相关警告信息

注意事项

• 修改配置后建议重启Domoticz服务确保变更生效
• 如问题持续存在，可尝试临时禁用再重新启用硬件设备
• 在冬季供暖季等关键时期，不建议进行频繁的配置变更