Flutter中Firebase Auth成功但Firestore无法创建文档求助

排查方向与解决方案 #

1. 确认集合引用正确性 #

检查usersRef的初始化是否指向正确的Firestore集合，拼写错误（包括大小写）会导致静默失败：

// 确保集合名称与Firebase控制台完全一致
final CollectionReference usersRef = FirebaseFirestore.instance.collection('users');

2. 处理Auth状态同步延迟 #

Firebase Auth创建用户后，本地Auth状态可能存在短暂延迟，导致Firestore安全规则校验时request.auth.uid为空。可在写入前等待Auth状态确认：

// 在createUserWithEmailAndPassword调用后添加
await FirebaseAuth.instance.authStateChanges().firstWhere((user) => user != null);

3. 捕获Firestore专属异常 #

当前代码仅处理Auth异常，添加Firestore异常捕获可获取更精准的错误信息：

signUp(BuildContext context, String email, String password) async {
  loading = true;
  notifyListeners();
  try {
    UserCredential userCredential= await FirebaseAuth.instance
        .createUserWithEmailAndPassword(email: email, password: password);

    debugPrint('userID -------> ${userCredential.user!.uid}');

    await usersRef
        .doc(userCredential.user!.uid)
        .set({
      'id': userCredential.user!.uid,
      'email': email,
      'profilePic': '',
      'username': 'User',
      'isPaid': true,
      'timestamp': Timestamp.now()
    });
    loading = false;
    notifyListeners();
    Navigator.pushReplacement(context, MaterialPageRoute(builder: (_) =>
    const EditProfile()));
  } on FirebaseAuthException catch (e) {
    loading = false;
    notifyListeners();
    errorDialog(context, e.message!);
  } on FirebaseFirestoreException catch (e) { // 新增Firestore异常捕获
    loading = false;
    notifyListeners();
    errorDialog(context, "Firestore错误: ${e.message}，错误码: ${e.code}");
  } catch (e){
    loading = false;
    notifyListeners();
    errorDialog(context, e.toString());
  }
}

4. 临时放宽安全规则调试 #

若怀疑是规则问题，可临时放宽规则测试（调试完成后务必改回原规则）：

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow write, read: if true; // 仅用于调试
    }
  }
}

若此时能成功写入，说明原规则的Auth校验存在状态同步问题。

5. 调整Flutter生命周期调用时机 #

将signUp调用从initState移至didChangeDependencies，确保上下文完全初始化：

class _PaymentSuccessState extends State<PaymentSuccess> {
  bool _hasCalledSignUp = false;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    if (!_hasCalledSignUp) {
      _hasCalledSignUp = true;
      LoginViewModel viewModel = Provider.of<LoginViewModel>(context, listen: false);
      viewModel.signUp(context, widget.email!, widget.password!);
    }
  }

  // 原build方法保持不变
}

6. 更新Firebase依赖版本 #

你的Firestore版本为24.2.2，部分旧版本存在连接稳定性问题，升级到最新稳定版：

# 在pubspec.yaml中更新依赖
firebase_core: ^2.15.0
firebase_auth: ^4.10.0
cloud_firestore: ^4.8.3

执行flutter pub get完成依赖更新。

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