Firestore使用get(GetOptions(source: Source.server))偶发获取文档失败咨询

这个cloud_firestore/unavailable错误不只是网络连接不佳，还有以下几种可能的触发场景：

• Firebase服务端临时波动或限流：Firestore服务器偶尔会出现短暂的可用性问题，或者你的请求频率触达了Firestore的限流阈值（比如短时间内大量重复请求），这种情况下即使网络正常，也会返回该错误。
• 网络环境不稳定（非完全断网）：比如网络切换（WiFi转移动数据）时的短暂中断、网络延迟过高导致请求超时，或者运营商网络的临时故障，都可能引发这个错误，不一定是完全没有网络连接。
• 查询关联的资源异常：虽然同一个ID多数情况正常，但如果查询涉及的集合组结构临时变动（比如某个子集合的权限配置调整）、文档元数据出现异常，也可能导致服务器无法正常处理请求。
• 客户端SDK状态异常：Firestore客户端SDK的本地连接状态或缓存偶尔可能出现异常，导致请求无法正确发送到服务器，这种情况重启应用通常能缓解。

实用建议 #

• 增加错误捕获逻辑，当触发该错误时，自动降级使用本地缓存获取数据（即去掉source: Source.server参数），优先保证功能可用。
• 如果频繁出现该问题，登录Firebase控制台查看监控面板，排查是否有服务端错误或限流记录。
• 确认Firestore安全规则是否允许当前查询，避免因权限配置变动导致的隐性问题。

内容的提问来源于stack exchange，提问作者Marc Van Daele