Flutter开发中Firebase认证正常但Firestore无法存储用户数据问题

1. 排查Cloud Firestore安全规则（最高频原因） #

Firestore默认规则禁止所有读写操作，权限配置错误是写入失败的最常见诱因

• 验证路径：打开Firebase控制台→Firestore Database→规则页面，查看当前权限配置
• 常见错误配置示例：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if false; // 全局禁止所有写入操作
    }
  }
}

• 临时验证修复方案（仅测试用，生产环境需细化权限）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow write: if request.auth != null && request.auth.uid == userId;
      allow read: if request.auth != null && request.auth.uid == userId;
    }
  }
}

修改规则后如果可正常写入，即可确认是权限规则问题，生产环境按需补充权限校验逻辑即可。

2. 排查集合路径与初始化配置错误 #

配置参数错配、集合名拼写错误、UID获取异常都会导致写入到不存在的路径

• 验证点：
  • 核对Config.dart中Firebase核心配置参数，确认projectId、apiKey等参数与Firebase控制台完全一致，未混用测试/生产环境配置
  • 检查注册页代码中Firestore写入的集合名拼写，确认没有出现users写成user、大小写不匹配等问题
  • 确认写入时使用的用户UID是Auth接口返回的有效值，未出现空值传入的情况
• 常见代码错误示例：

// 错误：未等待Auth异步操作完成就获取UID，大概率拿到空值
FirebaseAuth.instance.createUserWithEmailAndPassword(email: email, password: password);
final uid = FirebaseAuth.instance.currentUser?.uid;
await FirebaseFirestore.instance.collection('users').doc(uid).set(userData);

• 修复代码：

final userCredential = await FirebaseAuth.instance.createUserWithEmailAndPassword(email: email, password: password);
final uid = userCredential.user?.uid;
if (uid == null) {
  throw Exception('认证异常，无法获取用户UID');
}
await FirebaseFirestore.instance.collection('users').doc(uid).set(userData);

3. 排查异常捕获逻辑缺失 #

大部分写入失败都会抛出明确异常，未加捕获逻辑会导致看不到报错原因

• 修复方案：给Firestore写入逻辑补充完整异常捕获，打印错误信息定位问题：

try {
  await FirebaseFirestore.instance.collection('users').doc(uid).set({
    'name': name,
    'email': email,
    'avatarUrl': avatarUrl,
    'createdAt': FieldValue.serverTimestamp(),
  });
} catch (e, stackTrace) {
  print('Firestore写入错误: $e');
  print('错误栈: $stackTrace');
}

根据打印的错误信息直接修复即可：返回PERMISSION_DENIED对应第一步的规则问题，返回INVALID_ARGUMENT检查写入的字段是否包含Firestore不支持的数据类型，返回RESOURCE_EXHAUSTED说明配额已用完。

4. 排查依赖版本兼容性问题 #

Firebase各组件版本不匹配会导致部分功能异常

• 验证点：检查pubspec.yaml中firebase_core、firebase_auth、cloud_firestore、firebase_storage的大版本号一致，避免出现3.x和4.x混用的情况
• 修复方案：统一升级所有Firebase依赖到最新稳定版：

flutter pub upgrade firebase_core firebase_auth cloud_firestore firebase_storage

升级后重新运行应用测试写入逻辑即可。

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