Flutter集成Firebase Storage上传图片报StorageException错误

核心故障原因 #

你遇到的上传报错核心是上传路径非法，和App Check警告、安全规则配置无关：
你当前的路径拼接代码：

final fileName = imageFile!.path;
final destination = 'images/$fileName';

imageFile!.path取到的是设备本地文件的完整绝对路径，安卓端格式类似/data/user/0/包名/cache/xxx.jpg、iOS端格式类似/var/mobile/Containers/Data/Application/xxx/tmp/xxx.jpg，路径中包含大量系统层级分隔符/，拼接后会生成类似images//data/user/0/xxx/cache/xxx.jpg的非法存储路径，Firebase服务端会直接拒绝该请求，抛出StorageException。

分步修复方案 #

1. 修正上传路径生成逻辑 #

只提取文件本身的名称，不要使用完整本地路径：

• 先在pubspec.yaml中添加path依赖（用于跨平台安全提取文件名）：

dependencies:
  flutter:
    sdk: flutter
  path: ^1.8.3 # 加这一行，版本兼容当前flutter sdk即可
  # 其他你已有的依赖保持不变

• 修改页面中的uploadFile方法，替换路径逻辑，同时增加异步等待、错误捕获：

// 顶部导入path包
import 'package:path/path.dart' as path;

Future uploadFile() async {
  if (imageFile == null) return;
  // 仅提取文件名，丢弃完整本地路径
  final fileName = path.basename(imageFile!.path);
  final destination = 'images/$fileName';
  
  try {
    final task = Storage.uploadFile(destination, imageFile!);
    if (task != null) {
      // 等待上传完成
      final snapshot = await task.whenComplete(() {});
      // 可选：获取上传后的文件访问链接
      final downloadUrl = await snapshot.ref.getDownloadURL();
      print("上传成功，文件访问地址：$downloadUrl");
    }
  } catch (e) {
    print("上传失败：$e");
  }
}

2. 补全错误捕获逻辑 #

你当前封装的Storage类错误捕获不全，且未打印具体错误信息，修改为以下代码方便后续排查问题：

import 'dart:io';
import 'package:firebase_storage/firebase_storage.dart';

class Storage {
  static UploadTask? uploadFile(String destination, File file) {
    try {
      final ref = FirebaseStorage.instance.ref(destination);
      return ref.putFile(file);
    } on FirebaseException catch (e) {
      // 打印具体错误码和服务端返回信息
      print("Firebase存储错误：错误码=${e.code}, 错误信息=${e.message}");
      return null;
    } catch (e) {
      print("未知上传错误：$e");
      return null;
    }
  }
}

其他说明 #

• 你看到的No AppCheckProvider installed只是警告，不是上传失败的原因。你未开启App Check时，Firebase服务端不会校验App Check令牌，该警告直接忽略即可，不影响上传功能。如果要消除警告，可在Firebase控制台开启App Check并按官方文档完成集成。
• 你配置的全量开放安全规则没有问题，修改规则后建议等待1-2分钟待规则生效后再测试。

额外排查项 #

如果修改后仍报错，逐一核对以下配置：

• 安卓端AndroidManifest.xml（路径：android/app/src/main/AndroidManifest.xml）的manifest节点下已添加网络权限：

  <uses-permission android:name="android.permission.INTERNET"/>
  

• 从Firebase控制台下载的google-services.json文件已放在android/app目录下，GoogleService-Info.plist已放在iOS对应配置目录，配置文件和当前Firebase项目匹配。
• 如果你是手动初始化Firebase App，核对storageBucket参数和Firebase控制台存储页面显示的存储桶地址完全一致。

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