Flutter+Firebase：如何实现用户目录嵌套挑战文件夹的图片存储？

1. 确认依赖配置 #

确保你的pubspec.yaml中已添加必要依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.15.0
  firebase_storage: ^11.2.0
  image_picker: ^1.0.4 # 用于选择本地图片

执行flutter pub get完成依赖安装。

2. 获取当前登录用户的用户名 #

因为你使用邮箱密码认证，默认用户displayName可能为空，需根据实际存储方式获取用户名：

场景1：用户名存在于User对象的displayName

final user = FirebaseAuth.instance.currentUser;
if (user == null) {
  // 未登录，跳转登录页或提示用户
  return;
}
final username = user.displayName;
if (username == null) {
  // 用户名未设置，引导用户完善信息
  return;
}

场景2：用户名存储在Firestore的users集合

假设Firestore中users集合以用户uid为文档ID，包含username字段：

final user = FirebaseAuth.instance.currentUser;
if (user == null) return;

final userDoc = await FirebaseFirestore.instance.collection('users').doc(user.uid).get();
if (!userDoc.exists) {
  // 用户文档不存在，处理异常逻辑
  return;
}
final username = userDoc.data()?['username'] as String;

3. 构建存储路径并上传图片 #

先通过image_picker选择图片，再构建目标路径完成上传：

// 1. 选择本地图片
final picker = ImagePicker();
final pickedFile = await picker.pickImage(source: ImageSource.gallery);
if (pickedFile == null) return;

// 2. 处理文件与文件名
final file = File(pickedFile.path);
final fileName = DateTime.now().millisecondsSinceEpoch.toString(); // 用时间戳避免文件名重复

// 3. 构建存储路径（替换为实际挑战名称/ID）
final challengeName = '每日打卡挑战';
final storagePath = 'users/$username/$challengeName/$fileName';

// 4. 上传至Firebase Storage
final storageRef = FirebaseStorage.instance.ref().child(storagePath);
try {
  await storageRef.putFile(file);
  // 上传成功后可获取下载链接
  final downloadUrl = await storageRef.getDownloadURL();
  print('图片上传完成，下载链接：$downloadUrl');
} catch (e) {
  print('上传失败：$e');
  // 处理错误逻辑（如提示用户重试）
}

4. 设置Storage安全规则 #

为保障数据安全，在Firebase控制台的Storage规则中配置权限，确保用户仅能操作自己目录下的文件：

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /users/{username}/{allPaths=**} {
      allow read, write: if request.auth != null && 
        get(/databases/$(database)/documents/users/$(request.auth.uid)).data.username == username;
    }
  }
}

若用户名直接存在于User对象的displayName，规则可简化为：

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

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