Flutter上传图片至Firebase Storage后首次获取下载URL异常问题
Flutter Firebase Storage 首次上传获取下载URL异常问题说明
已实现功能
- 支持从系统相册选取本地图片
- 支持通过
TextFormField组件接收用户自定义的图片存储文件名 - 上传的图片统一存储到Firebase Storage的
deneme/resimler路径下
异常表现
- 首次上传全新命名的图片完成后,调用
getDownloadURL方法获取图片可访问下载地址时,抛出[firebase_storage/object-not-found]错误,提示指定存储引用路径下不存在对应对象 - 沿用完全相同的文件名再次上传任意图片时,可正常获取最新上传图片的下载地址,无报错
核心问题成因
- 上传任务未完成闭环就发起下载URL请求:代码未等待
putFile上传任务拿到服务端写入成功的完整回调,在上传流未完全关闭时就提前触发下载URL查询 - 服务端元数据同步延迟:首次写入全新路径的存储对象时,服务端对象索引的同步存在毫秒级延迟,未拿到写入完成确认就发起的查询请求,会被服务端判定为对象不存在
- 路径拼接逻辑存在隐性偏差:首次上传时实际写入的对象路径,和后续查询下载URL时拼接的存储引用路径存在不一致(如大小写差异、特殊字符未统一转义),第二次因同名触发客户端路径缓存匹配,绕开了路径校验逻辑
通用修复方案
- 强制等待上传任务的完成回调触发后,再执行
getDownloadURL查询,禁止在未拿到上传成功的流状态时发起查询 - 为
getDownloadURL调用增加短延迟重试逻辑,对首次查询触发的object-not-found错误做最多3次、每次间隔200ms的重试兜底 - 统一路径拼接逻辑,将自定义的文件名经过统一字符串清洗后,同时作为上传和查询环节的路径拼接参数,避免路径不匹配问题
内容的提问来源于stack exchange,提问作者kalfalarin_omer
相关产品推荐
相关产品推荐

