Flutter从Firebase Storage获取图片URL提示对象不存在的解决方法

核心问题分析 #

firebase_storage/object-not-found错误说明你构造的Storage引用指向的文件不存在，大概率是Firestore存储的路径与Storage实际文件路径不匹配，或是代码逻辑存在疏漏。以下是具体解决步骤：

1. 验证Firestore中存储的路径准确性 #

打开Firebase控制台，分别查看：

• Cloud Firestore的parts_sales文档中，parts_image字段的具体值
• Firebase Storage中目标文件的「文件位置」（点击文件即可查看）
  确保两者完全一致：
• 注意大小写敏感（比如Image.jpg和image.jpg是不同路径）
• 路径必须用正斜杠/分隔，不能有多余的前缀/后缀
• 字段值应为文件的相对路径（比如parts_images/engine.jpg），而非完整URL或单纯文件名

2. 修正代码中的潜在问题 #

（1）修复文档ID获取逻辑

当前循环会把documentID覆盖为集合最后一个文档的ID，若集合为空会直接导致后续查询失败。改为明确获取目标文档：

void getData() async {
  var querySnapshots = await collection.get();
  // 改为取第一个文档（若需特定文档，可直接指定ID或添加查询条件）
  if(querySnapshots.docs.isNotEmpty){
    documentID = querySnapshots.docs.first.id;
  } else {
    print('parts_sales集合无数据');
    return;
  }

  // ...后续代码
}

（2）添加空安全与有效性检查

在使用parts_image字段前，先确认数据有效性：

var result = await firestore.collection('parts_sales').doc(documentID).get();
setState(() {
  resultData = result.data();
});

// 检查数据是否存在且包含有效路径
if(resultData == null || !resultData.containsKey('parts_image') || resultData['parts_image'].isEmpty){
  print('文档无有效图片路径');
  return;
}

（3）添加异常捕获与调试信息

给getDownloadURL添加异常捕获，方便定位具体问题：

try {
  var ref = FirebaseStorage.instance.ref().child(resultData['parts_image']);
  var url = await ref.getDownloadURL();
  print('获取到的URL: $url');
  setState(() {
    imageUrl = url;
  });
} catch(e) {
  print('获取下载URL失败: $e');
  print('当前使用的存储路径: ${resultData['parts_image']}');
}

3. 直接验证存储路径有效性 #

手动构造存储引用测试，确认路径是否正确：

// 替换成你控制台中实际的文件路径
var testRef = FirebaseStorage.instance.ref().child('parts_images/test.jpg');
testRef.getDownloadURL()
  .then((url) => print('测试URL: $url'))
  .catchError((e) => print('测试失败: $e'));

• 若测试成功：说明Firestore中parts_image字段的路径有误
• 若测试失败：说明文件确实不存在，或是Storage权限限制

4. 检查Firebase Storage权限 #

确保存储规则允许读取操作（开发阶段可临时放宽，生产环境需严格限制）：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read: if true; // 生产环境改为`request.auth != null`
      allow write: if request.auth != null;
    }
  }
}

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