Google Home Assistant报GAL_NOT_FOUND等错误的技术求助

问题详情 #

• 基于Google Home Action开发的空调控制技能出现异常：通过Google Assistant语音执行设备控制指令时，持续提示“无法连接”或“技能暂不可用”，但Google Home App的屏幕操作可正常操控空调。
• 处理指令、查询、同步及授权流程的API端点部署在AWS，错误发生时API端未收到相关请求，也无失败日志留存。
• Google Cloud中Google Home Action的日志显示两个关键错误：GAL_NOT_FOUND、BACKEND_FAILURE_URL_UNREACHABLE。
• 已按官方文档完成账号重连操作，问题未解决；已开启高级监控，暂未定位到问题根源。

排查方向建议 #

1. 对比语音与App请求的路由差异 #

• 确认语音触发的指令是否进入了与App屏幕操作不同的处理分支，比如语音特定意图的API配置存在疏漏。
• 借助Google Cloud的Action Console日志，对比语音请求与App请求的意图类型、参数传递、授权令牌等细节，排查链路差异。

2. 针对BACKEND_FAILURE_URL_UNREACHABLE的验证 #

• 检查AWS API端点的网络可达性：验证Google服务器IP段是否能正常访问API，排查防火墙、安全组、WAF规则是否拦截了来自Google的请求。
• 确认API的HTTPS配置：确保证书为受信任CA颁发、域名解析正常、无SNI配置问题，语音请求对HTTPS合规性要求可能更严格。
• 校验授权流程：确认语音场景下的授权令牌获取、验证逻辑与App场景一致，无令牌失效或权限不足问题。

3. 解析GAL_NOT_FOUND错误 #

• 该错误关联设备关联逻辑，检查设备同步响应中的设备id是否与后续指令请求中的设备ID完全匹配，避免大小写、格式等差异。
• 确认技能的设备Trait配置：空调设备对应的action.devices.traits.TemperatureSetting等Trait是否完整配置，语音指令触发的操作是否已在技能中实现。

4. 追踪完整请求链路 #

• 使用Action Console的测试工具模拟语音指令，查看完整的请求/响应日志，确认Google端到API端的链路是否存在请求丢失或异常。
• 检查AWS API Gateway、CloudTrail日志，确认是否有来自Google的请求被静默拦截（如速率限制、权限策略等）。

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