Flutter Dart使用Firebase Storage上传图片 元数据同步但存储桶无文件求助

1. 首先排查Firebase Storage安全规则 #

默认情况下Firebase Storage的安全规则禁止未认证用户的读写操作，如果你没有接入Firebase Auth，可以先临时将规则调整为测试规则验证问题：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read, write: if true;
    }
  }
}

注意：测试规则仅用作调试，上线前必须替换为符合业务逻辑的安全规则，避免数据泄露。

2. 修复代码中异常被吞的问题 #

你当前的FirebaseApi.uploadFile方法捕获到FirebaseException后直接返回null，没有任何日志输出，无法定位具体错误，修改代码打印异常信息：

class FirebaseApi {
  static UploadTask? uploadFile(String destination, File file) {
    try {
      final ref = FirebaseStorage.instance.ref(destination);
      return ref.putFile(file)
        ..catchError((e) {
          // 打印上传异常
          print("上传出错：$e");
        });
    } on FirebaseException catch (e) {
      print("Firebase异常：${e.code} ${e.message}");
      return null;
    }
  }
}

同时在调用uploadFile后监听任务执行结果：

Future uploadFile() async {
  if (file == null) return;

  final fileName = basename(file!.path);
  final destination = 'Content/$fileName';

  task = FirebaseApi.uploadFile(destination, file!);
  setState(() {});
  
  // 等待上传任务完成
  if (task != null) {
    final snapshot = await task!;
    final downloadUrl = await snapshot.ref.getDownloadURL();
    print("上传成功，下载地址：$downloadUrl");
  }
}

3. 排查实体设备权限适配问题 #

• Android端：如果运行设备是Android 13及以上版本，需要在AndroidManifest.xml中申请READ_MEDIA_IMAGES权限，旧的READ_EXTERNAL_STORAGE权限在Android 13以上无效。
• iOS端：需要在Info.plist中添加NSPhotoLibraryUsageDescription权限说明，否则无法正常读取相册文件内容。

4. 排查存储路径问题 #

打印destination变量的值，确认路径中没有特殊字符、乱码或者非法符号，避免Firebase Storage无法正常创建文件路径。如果你的项目使用了非默认的存储桶，需要手动指定存储桶实例：

final ref = FirebaseStorage.instanceFor(bucket: "你的存储桶地址").ref(destination);

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