Firebase Storage上传图片报错object-not-found，请求排查解决

可能的原因及修复方案 #

1. 调整Firebase Storage权限规则

默认的Storage规则可能限制了上传操作，导致文件未成功上传，后续获取URL时触发「对象不存在」错误。

修改规则为允许已认证用户读写（上线前可细化为仅允许用户操作自己的路径）：

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

2. 替换Firestore的update为set(merge: true)

如果用户文档尚未创建，update方法会执行失败，导致图片URL无法保存，重启APP后自然找不到图片。修改为合并更新逻辑：

await FirebaseFirestore.instance
    .collection('users')
    .doc(userId)
    .set({
      'bannerUrl': downloadURL,
    }, SetOptions(merge: true));

3. 验证文件上传状态

在获取下载URL前，先确认文件是否上传成功，避免基于失败的上传执行后续操作：

TaskSnapshot uploadTask = await FirebaseStorage.instance
    .ref(filePath)
    .putFile(imageFile);

if (uploadTask.state != TaskState.success) {
  print('文件上传失败：${uploadTask.state}');
  return;
}

4. 确认选中文件的有效性

打印选中文件的路径，排查是否存在路径无效或文件损坏的情况：

File imageFile = File(pickedFile.path);
print('选中文件路径：${imageFile.path}');

完整修改后的代码 #

File? _bannerImage;

Future<void> _pickBannerImage() async {
  final picker = ImagePicker();
  final pickedFile = await picker.pickImage(source: ImageSource.gallery);

  if (pickedFile != null) {
    File imageFile = File(pickedFile.path);
    print('选中文件路径：${imageFile.path}'); // 验证文件路径
    setState(() {
      _bannerImage = imageFile;
    });

    User? user = FirebaseAuth.instance.currentUser;
    if (user != null) {
      String userId = user.uid;
      String filePath = 'bannerImages/$userId/banner.jpg';

      try {
        TaskSnapshot uploadTask = await FirebaseStorage.instance
            .ref(filePath)
            .putFile(imageFile);

        // 检查上传状态
        if (uploadTask.state != TaskState.success) {
          print('文件上传未完成：${uploadTask.state}');
          return;
        }

        String downloadURL = await uploadTask.ref.getDownloadURL();

        // 合并更新用户文档
        await FirebaseFirestore.instance
            .collection('users')
            .doc(userId)
            .set({
          'bannerUrl': downloadURL,
        }, SetOptions(merge: true));

        print('Banner图片上传成功，URL已保存到Firestore');
      } catch (e) {
        print('上传Banner图片出错：$e');
      }
    } else {
      print('当前无用户登录');
    }
  }
}

额外排查点 #

• 登录Firebase控制台，进入Storage的「文件」页面，确认bannerImages/用户ID/banner.jpg是否存在；
• 确保执行上传逻辑时，FirebaseAuth.instance.currentUser不为null，避免未登录状态下的无效操作。

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