google.people.v1.PeopleService.SearchContacts缓存预热持续失败问题求助
Google People API SearchContacts 缓存预热失败(FAILED_PRECONDITION)排查分析
可能的故障原因
服务端缓存机制逻辑异常
你遇到的「预热请求依赖已预热缓存」的循环报错,本质是Google People服务端的缓存初始化流程出现了bug。这种自相矛盾的错误提示说明冷缓存的初始化逻辑完全失效,属于平台侧的故障。结合问题从2024-08-02T00:30:00Z开始持续14小时未恢复的情况,大概率是服务部署变更引发的问题,且尚未被修复。特定账户/租户的缓存分区故障
即便排除了配额和速率限制,你的Google账户(或所属Workspace租户)对应的缓存分区可能出现了数据损坏或初始化阻塞。这种情况下,服务端无法为你的账户完成缓存预热,导致报错持续存在。API请求的隐性兼容性问题
虽然你用官方API Explorer也遇到相同问题,但仍可确认是否使用了非稳定版客户端库,或请求中包含了未明确标注的参数——不过这个可能性极低,毕竟API Explorer是官方环境。
临时解决方案与建议
- 直接通过Google Cloud Support提交工单,提供项目ID、报错时间范围、API Explorer的请求ID等信息,让Google工程师定位服务端问题。
- 临时改用
people.connections.list接口替代,该接口无需缓存预热,可获取全量联系人后自行实现本地搜索。 - 关注Google Workspace状态面板,查看是否有相关服务的故障公告。
内容的提问来源于stack exchange,提问作者glevine
相关产品推荐
相关产品推荐

