Firestore普通文档写入自动重试规则及更新操作报错问题咨询

1. 确认文档存在时，不受我方控制的update报错原因 #

• 服务端临时故障：Firestore集群内部节点异常、区域级服务短暂不可用、服务端内部处理超时
• 配额统计异常：项目配置的Firestore写入吞吐量/请求数配额被同一项目其他业务耗尽，或Google侧配额统计链路临时延迟导致的误判超限
• 权限校验链路故障：IAM权限校验服务临时波动、服务账号密钥后台校验逻辑失败，即使本地确认权限配置正确也可能偶发
• 安全规则执行异常：安全规则本身配置无误，但服务端执行规则时出现临时故障导致请求被拒绝
• 并发修改冲突：其他客户端同时修改同一份文档，触发Firestore乐观并发控制逻辑，服务端主动拒绝当前请求
• 网络层异常：运营商骨干网波动、国际链路丢包、Google边缘接入节点临时不可用等网络传输问题

2. 报错后的update请求是否会自动重试 #

要分两类SDK场景判断：

• 端侧官方SDK（Web/Android/iOS/Flutter等面向客户端的SDK）：默认开启离线持久化的前提下，对可重试的错误类型会自动执行重试逻辑
• 服务端SDK/直接调用原生接口（Admin SDK、REST/gRPC直接调用）：默认没有自动重试机制，需要自行实现重试逻辑

3. 自动重试的触发场景说明 #

自动重试不局限于无网络连接的离线场景，端侧SDK的自动重试覆盖以下场景：

• 离线场景：设备无网络、且开启了离线持久化时，操作会存入本地缓存，网络恢复后自动重试，直到写入成功或手动取消
• 临时服务端错误：收到服务端返回的5xx错误码、429配额超限错误、网络超时、连接重置等临时异常时，SDK会按照指数退避策略自动重试
• 并发冲突场景：仅在事务包裹内的update操作收到409并发冲突错误时会自动重试，普通单步update操作收到409错误不会触发自动重试

内容的提问来源于stack exchange，提问作者lurning too koad