未修改代码时Firebase Storage部分用户无法下载文件报重试上限超出异常

你遇到的com.google.firebase.storage.StorageException: The operation retry limit has been exceeded异常是客户端请求存储资源触发了内置的指数退避重试上限，多次请求失败后抛出的非致命异常，结合未修改代码、仅部分用户出问题的特征，可按以下优先级排查：

• 网络侧限制：出问题的用户多处于特殊网络环境，比如企业内网、教育网、特定运营商网络，防火墙限制了Firebase Storage相关域名的访问，或用户本地网络波动大、丢包率高。可让故障用户在手机浏览器直接打开对应资源的下载链接，若无法访问即可确认是网络侧问题，需引导用户切换网络环境，或你侧增加域名代理中转方案。
• 安全规则变更：排查Firebase控制台的Storage安全规则，是否有其他协作者修改规则，限制了部分用户（如未登录用户、特定用户分组）的资源访问权限，规则调整不会影响业务代码，但会直接拦截无权限用户的请求。
• 重试参数配置不合理：Firebase Storage默认的重试时间较短，网络链路较差的用户容易在重试次数耗尽后报错，可在初始化时自定义拉长重试配置：

// 安卓端自定义重试配置示例
FirebaseStorage storageInstance = FirebaseStorage.getInstance();
// 下载操作最大重试时间调整为60秒，默认10秒
storageInstance.setMaxDownloadRetryTimeMillis(60000);
// 所有操作通用最大重试时间调整为120秒
storageInstance.setMaxOperationRetryTimeMillis(120000);

• SDK版本缺陷：确认故障用户安装的APP版本是否使用了较低版本的Firebase Storage SDK，旧版本存在已知的网络重试逻辑bug，可在后续版本迭代升级SDK至最新稳定版，或引导故障用户升级到最新版APP。
• 资源异常：如果故障集中在特定资源上，排查对应存储路径下的文件是否被误删、访问路径是否被修改。

内容的提问来源于stack exchange，提问作者Emma Alden