Firebase Auth注册时Cloud Firestore无法存储用户数据问题排查

核心问题分析 #

1. 错误存储TextEditingController对象

你在Firestore写入操作中直接传入了_email、_name、_pswd这些控制器实例，而非它们的文本内容。Firestore无法存储控制器对象，导致写入失败。此外，绝对不要将密码存储到Firestore——Firebase Auth已经安全托管了密码，自行存储会引发严重安全风险。

2. 异步流程逻辑混乱

registerWithEmailAndPassword是异步操作，但你在调用后立即同步判断FirebaseAuth.instance.currentUser。此时注册流程可能尚未完成，导致判断逻辑失效：要么提前跳转跳过Firestore写入，要么错误弹出“已注册”提示框。

3. 缺失异常捕获机制

注册和Firestore写入操作都没有处理可能的异常（如网络错误、Firestore权限限制），无法定位失败原因。

4. 可能的Firestore规则限制

检查你的Firestore安全规则，确保已允许认证用户写入users集合。例如基础规则可设置为：

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

修复后的代码示例 #

bool isloggedin = false;
final TextEditingController _email = TextEditingController();
final TextEditingController _pswd = TextEditingController();
final TextEditingController _name = TextEditingController();

// 重构为async函数统一处理异步流程
Future<void> handleSubmit() async {
  if (formkey.currentState!.validate()) {
    setState(() {
      isloggedin = true;
    });

    try {
      // 等待注册操作完成
      final userCredential = await Auth().registerWithEmailAndPassword(
        name: _name.text, 
        email: _email.text, 
        password: _pswd.text
      );

      if (userCredential != null && userCredential.uid != null) {
        // 写入Firestore，使用控制器的文本值，移除密码字段
        await FirebaseFirestore.instance
            .collection("users")
            .doc(userCredential.uid)
            .set({
              'uid': userCredential.uid,
              'email': _email.text,
              'name': _name.text,
            });

        // 确保widget未被销毁后再跳转
        if (mounted) {
          Navigator.of(context).pushReplacement(
            MaterialPageRoute(builder: (context) => MyHomePage())
          );
        }
      }
    } catch (e) {
      // 捕获并显示错误信息，便于调试
      if (mounted) {
        setState(() {
          isloggedin = false;
        });
        showDialog(
          context: context,
          builder: (context) {
            return AlertDialog(
              actions: [
                TextButton(
                  onPressed: () => Navigator.of(context).pop(),
                  child: const Text('Okay', style: TextStyle(color: Colors.blue)),
                )
              ],
              title: const Text('注册失败'),
              content: Text(e.toString()),
            );
          }
        );
      }
    }
  }
}

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