Flutter端Firebase注册后DisplayName返回null，重登后正常获取如何解决

问题本质 #

调用updateProfile更新用户显示名称时，改动只会同步到Firebase服务端，不会自动刷新当前内存中持有User对象的本地缓存。
你在注册完成、执行完资料更新后，立刻读取原User实例的displayName属性时，读到的还是注册初始状态的缓存值，也就是null。等用户重新登录时，Auth SDK会从服务端拉取全量最新的用户资料覆盖本地缓存，这时候就能正常读到保存的显示名称了，这就是两种场景取值不一致的核心原因。

具体修复步骤 #

在资料更新逻辑完成后，手动触发本地缓存强制刷新，再读取用户属性即可，核心要加两个操作：

• 等updateProfile的异步流程执行完成后，调用user.reload()，强制SDK从服务端拉取最新的用户数据
• 重新通过全局Auth实例获取当前登录的用户对象，再读取对应属性值

修正后的可运行代码：

Future createUserWithEmailAndPassword(
      String email, String password, String name) async {
    try {
      UserCredential userCredential = await _auth
          .createUserWithEmailAndPassword(email: email, password: password);
      User? currentUser = userCredential.user;
      if (currentUser == null) return null;

      // 更新用户显示名称
      await currentUser.updateProfile(displayName: name);

      // 关键：强制刷新本地用户缓存
      await currentUser.reload();
      // 重新获取最新的全局当前用户实例
      currentUser = _auth.currentUser;

      // 此时读取displayName可拿到正确值
      print(currentUser?.displayName);

      // 原有数据库写入逻辑保持不变
      db.setProfileonRegistration(currentUser!.uid, name);
      return _userFromFireBase(currentUser);
    } on FirebaseAuthException catch (e) {
      if (e.code == 'weak-password') {
        print('The password provided is too weak.');
        return null;
      } else if (e.code == 'email-already-in-use') {
        print('The account already exists for that email.');
        return null;
      }
    } catch (e) {
      print(e);
      return null;
    }
  }

常见踩坑提醒 #

• 一定不要省略updateProfile前的await，如果更新流程还没执行完就读取属性，依然会拿到null
• 不要只调用reload()却不重新获取_auth.currentUser，部分FlutterFire版本中，reload()仅会更新对象内部状态，直接读取原持有的对象属性仍可能存在缓存延迟，重新拉取一次全局的当前用户实例是最稳妥的实现方式
• 后续如果要更新头像链接等其他用户资料字段，遵循同样的“更新→刷新缓存→重新获取实例→读取值”流程，就能避免同类取值为空的问题

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