Flutter中如何从Firebase Auth获取用户ID？Firestore存用户数据方案

我来帮你梳理下这个问题，你遇到的_userId == null错误其实是异步操作的时机问题，咱们一步步拆解解决：

一、为什么你的代码会报错？ #

你在build方法里调用FirebaseAuth.instance.currentUser().then(...)，但currentUser()是异步方法（返回Future<User>），而build是同步执行的——当Text(_userId)渲染时，then里的回调还没执行，_userId自然还是null，所以会触发错误。

正确获取用户ID的两种方式 #

1. 用FutureBuilder处理单次异步请求

如果只需要获取当前登录状态的用户ID，用FutureBuilder等待异步请求完成后再渲染：

@override
Widget build(BuildContext context) {
  return FutureBuilder<User>(
    future: FirebaseAuth.instance.currentUser(),
    builder: (context, snapshot) {
      if (snapshot.connectionState == ConnectionState.done) {
        // 若用户已登录则取UID，否则显示"未登录"
        final String userId = snapshot.data?.uid ?? "未登录";
        return Text(userId);
      } else {
        // 请求未完成时显示加载状态
        return CircularProgressIndicator();
      }
    },
  );
}

2. 用StreamBuilder监听Auth状态变化

如果需要实时响应用户登录/退出的状态变化（比如用户切换账号），StreamBuilder更合适，它会监听Auth状态流的变化：

@override
Widget build(BuildContext context) {
  return StreamBuilder<User?>(
    stream: FirebaseAuth.instance.authStateChanges(),
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        final User user = snapshot.data!;
        return Text(user.uid);
      } else {
        // 用户未登录时的提示
        return Text("未登录");
      }
    },
  );
}

二、Firestore用户数据存储的最佳方式 #

不建议把用户ID作为文档字段，更规范高效的做法是：用用户的UID作为Firestore文档的ID，原因如下：

• 唯一性保障：Firebase Auth生成的UID是全局唯一的，不会出现文档冲突；
• 查询更高效：直接通过UID定位文档（FirebaseFirestore.instance.collection('users').doc(userId)），比查询字段更快，还无需额外创建索引；
• 逻辑更清晰：文档ID与用户身份直接绑定，后续删除、更新用户数据时更直观。

示例：创建/更新用户文档 #

当用户注册或登录成功后，你可以这样存储用户数据：

Future<void> saveOrUpdateUser(User user) async {
  final userDoc = FirebaseFirestore.instance.collection('users').doc(user.uid);
  
  // 检查文档是否存在，不存在则初始化，存在则更新部分字段
  final docSnapshot = await userDoc.get();
  if (!docSnapshot.exists) {
    await userDoc.set({
      'email': user.email,
      'displayName': user.displayName,
      'createdAt': FieldValue.serverTimestamp(),
      // 其他自定义用户字段...
    });
  } else {
    await userDoc.update({
      'lastLoginAt': FieldValue.serverTimestamp(),
    });
  }
}

如果需要在多个页面复用Auth相关逻辑，还可以封装一个简单的Auth服务类：

class AuthService {
  final FirebaseAuth _auth = FirebaseAuth.instance;

  // 监听Auth状态流
  Stream<User?> get authStateChanges => _auth.authStateChanges();

  // 获取当前用户ID
  Future<String?> get currentUserId async {
    final user = await _auth.currentUser();
    return user?.uid;
  }
}

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