Google Smart Home设备与服务器失联问题求助

根据你描述的情况——Google Actions Webhook在Auth0授权后正常运行数天突然失联，仅能通过重置集成恢复，我分享几个实际排查和解决的方向：

1. 检查Auth0令牌的自动刷新机制 #

这是最常见的诱因之一：

• 确认你的Node.js服务是否正确实现了Auth0令牌的刷新逻辑。初始授权的access_token通常有过期期限（默认多为24小时），如果没有自动刷新并同步更新Google Actions侧的令牌，就会导致授权失效，请求被直接拦截。
• 可以在Auth0控制台查看应用的令牌过期配置，然后在Webhook代码中添加令牌过期前的自动刷新逻辑，确保每次与Google Actions交互时使用的是有效令牌。
• 另外要留意refresh_token过期的场景，部分配置下refresh_token也会失效，需要处理这种情况的静默重新授权（无需用户重新添加设备）。

2. 验证Google Actions的Webhook签名与注册状态 #

有时候Google服务器会因签名验证失败停止发送请求：

• 检查Node.js服务是否正确验证Google Actions的请求签名。可以在代码中新增日志，专门捕获签名验证失败的情况（之前正常不代表一直正常，密钥更新、服务器时间同步偏差都可能引发问题）。
• 登录Google Actions控制台，查看Webhook配置是否有变更，比如URL是否被误修改，或者是否有Google侧的通知提示Webhook验证失败。
• 尝试手动触发一次同步操作（无需删除集成）：在Google Home应用中刷新设备列表，观察是否能触发onSync请求，同时查看服务器日志是否有响应。

3. 优化服务器端的授权状态管理 #

如果你的服务依赖本地缓存存储授权状态：

• 检查Node.js服务是否存在内存泄漏或缓存过期逻辑错误，导致旧的授权状态未被更新，进而无法处理新请求。
• 建议将授权状态迁移到外部缓存（比如Redis），而非服务内存中，这样服务重启或扩容时状态不会丢失，也更易管理过期时间。

4. 处理设备端的授权缓存问题 #

有时候Google Home设备会缓存旧的授权信息：

• 尝试在Google Home应用中进入设备设置页，选择「重新链接账户」，而非删除整个集成。这样可以刷新设备的授权状态，无需重新添加所有设备。
• 如果这种方法有效，说明是设备端缓存的令牌过期，而你的服务未正确触发静默刷新，需要优化令牌刷新的触发时机。

快速临时排查技巧 #

• 在Node.js服务中添加全局请求捕获日志，比如用Express中间件捕获所有进入的请求（包括OPTIONS健康检查请求），确认是否有请求到达服务器但未被业务逻辑处理。
• 检查服务器防火墙、反向代理（如Nginx）的配置，是否有规则变更导致Google的请求被拦截。

内容的提问来源于stack exchange，提问作者MatexQ