Firebase Storage获取文件下载链接报错：指定位置无对象存在

问题根源分析 #

你的代码存在两个核心问题导致404错误：

1. 上传未完成就请求链接：直接链式调用putFile().snapshot.ref.getDownloadURL()，可能在文件还未完全写入Storage时发起读取请求，此时对象尚未存在。
2. 引用路径逻辑错误：处理完image后将ref切换到父节点，后续cover文件会被存在userImages根目录而非预期的userImages/uid路径下，导致引用指向错误位置。

修正后的代码 #

// 初始化基础路径引用，后续操作基于此路径，避免修改原始引用
Reference baseRef = FirebaseStorage.instance.ref('userImages/${FirebaseAuth.instance.currentUser?.uid}');

if(image != null){
  // 为图片创建独立引用，不修改baseRef
  Reference imageRef = baseRef.child(Uri.file(image!.path).pathSegments.last);
  // 等待上传任务完全完成
  TaskSnapshot imageSnapshot = await imageRef.putFile(image!);
  // 从完成的快照中获取下载链接
  String imageLink = await imageSnapshot.ref.getDownloadURL();
  // 此处可将imageLink存入数据库或做其他业务处理
}

if(cover != null){
  // 为封面创建独立引用，基于原始baseRef确保路径正确
  Reference coverRef = baseRef.child(Uri.file(cover!.path).pathSegments.last);
  TaskSnapshot coverSnapshot = await coverRef.putFile(cover!);
  String coverLink = await coverSnapshot.ref.getDownloadURL();
  // 此处可将coverLink存入数据库或做其他业务处理
}

额外排查步骤 #

• 核对文件实际路径：登录Firebase控制台进入Storage，查看上传后的文件是否在userImages/你的UID/文件名路径下，确认和代码构建的路径一致。
• 检查存储规则：确保规则允许已认证用户读取对应路径的文件，示例规则如下：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /userImages/{uid}/{allPaths=**} {
      allow read, write: if request.auth != null && request.auth.uid == uid;
    }
  }
}

• 验证文件名提取结果：打印Uri.file(image!.path).pathSegments.last的值，确认是否正确提取了文件名（不同平台路径解析可能存在差异）。

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