actions-on-google偶现StatusRuntimeException的成因及降低发生率方案问询

• 权限校验失败：请求携带的agentUserId无效、服务账号密钥过期、权限配置缺失homegraph.devices.requestSync权限时，gRPC会返回PERMISSION_DENIED状态的StatusRuntimeException。
• 接口配额超限：Home Graph API对requestSync接口默认限制单项目每分钟请求不超过1000次，若近期设备状态变更频次上涨触碰到配额阈值，会返回RESOURCE_EXHAUSTED类型的异常，这也是错误频次持续升高的最常见原因。
• 通信与参数异常：客户端到谷歌服务的网络抖动、请求超时会返回DEADLINE_EXCEEDED、UNAVAILABLE类异常；请求参数格式非法（如agentUserId为空、字段不符合协议要求）会返回INVALID_ARGUMENT类异常。
• 依赖版本过旧：你当前使用的actions-on-google 1.8.0是2020年发布的旧版本，底层依赖的gRPC、Google API客户端存在已知的通信兼容性Bug，也会导致无明确业务原因的异常抛出。
• 用户无绑定设备：如果传入的agentUserId对应用户未在你的智能家居Action下绑定任何设备，调用接口会返回FAILED_PRECONDITION状态的异常。

• 分类处理异常做重试：捕获StatusRuntimeException后先提取状态码，对UNAVAILABLE、DEADLINE_EXCEEDED这类临时性异常增加指数退避重试逻辑，最多重试3次，避免瞬时故障导致的请求失败；对PERMISSION_DENIED、INVALID_ARGUMENT这类确定性异常不重试，直接打印详细日志排查参数和权限问题。
• 合并请求加客户端限流：短时间内同一agentUserId的多次设备状态变更，合并为一次requestSync请求，避免重复调用；在客户端层面先做请求限流，确保单分钟请求量不超过配额上限，超出的请求放入延迟队列异步处理。
• 前置校验过滤无效请求：发起请求前先校验agentUserId是否非空、是否对应实际绑定过设备的用户，提前过滤无效请求；定期校验服务账号密钥有效性和权限配置，避免权限过期导致的批量失败。
• 升级依赖修复兼容问题：将actions-on-google依赖升级到最新稳定版，同步升级底层gRPC、Google API客户端依赖，修复旧版本已知的兼容性Bug。
• 申请提升配额：如果业务实际请求量确实超出默认配额阈值，可以向谷歌云提交配额提升申请，从根源解决限流导致的异常。

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