Flutter Firebase注册时user.uid返回null但User对象正常问题求助

问题场景 #

调用createUserWithEmailAndPassword成功创建用户后，打印整个User对象能看到包含有效uid（如d3wI96PxFKSHGiXb8CIVlIJtC0r2），但直接访问user.uid返回null，导致写入Firestore时抛出异常。

用户核心代码：

userCredential = await _auth.createUserWithEmailAndPassword(
  email: email,
  password: password,
);

final user = userCredential.user;
if (user != null) {
  print(user);                                // 能看到完整User对象，包含uid
  print(user.uid);                            // 返回null
}

await FirebaseFirestore.instance
    .collection('users')
    .doc(userCredential.user!.uid)            // 因uid为空出错
    .set({
  'username': username,
  'email': email,
});

打印的User对象示例：

flutter: User(displayName: null, email: a3@gmail.com, emailVerified: false, isAnonymous: false, metadata: UserMetadata(creationTime: 2023-03-21 03:52:37.635Z, lastSignInTime: 2023-03-21 03:52:37.635Z), phoneNumber: null, photoURL: null, providerData, [UserInfo(displayName: null, email: a3@gmail.com, phoneNumber: null, photoURL: null, providerId: password, uid: a3@gmail.com)], refreshToken: , tenantId: null, uid: d3wI96PxFKSHGiXb8CIVlIJtC0r2)

可行解决方案 #

1. 升级Firebase SDK到最新稳定版 #

部分旧版本的Firebase Auth SDK存在uid字段初始化延迟或未正确赋值的bug，更新依赖即可解决：
在pubspec.yaml中修改为最新稳定版（版本号以官方发布为准）：

firebase_core: ^2.15.0
firebase_auth: ^4.10.0
cloud_firestore: ^4.8.2

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

2. 直接从UserCredential提取uid并校验 #

避免中间变量可能的状态不一致问题，直接从userCredential中获取uid并做非空校验：

userCredential = await _auth.createUserWithEmailAndPassword(
  email: email,
  password: password,
);

final uid = userCredential.user?.uid;
if (uid != null) {
  print(uid); // 正常输出有效uid
  await FirebaseFirestore.instance
      .collection('users')
      .doc(uid)
      .set({
    'username': username,
    'email': email,
  });
} else {
  // 处理用户创建失败的异常逻辑
  print('用户注册失败，未获取到有效uid');
}

3. 监听Auth状态变化确保数据同步 #

在某些场景下，用户数据可能存在短暂的状态同步延迟，通过监听Auth状态变化可确保获取到完整的用户信息：

await _auth.createUserWithEmailAndPassword(
  email: email,
  password: password,
);

// 监听当前用户状态，确保数据完全初始化
FirebaseAuth.instance.authStateChanges().listen((User? user) {
  if (user?.uid != null) {
    FirebaseFirestore.instance
        .collection('users')
        .doc(user!.uid)
        .set({
      'username': username,
      'email': email,
    });
  }
});

4. 规范空安全使用 #

避免在未做非空校验的情况下使用!强制解包，防止因空值导致的崩溃，始终先通过?.或条件判断确认值不为空。

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