Firebase displayName首次登录为空,重登后才正常显示的问题排查
问题场景
- 开发者封装了两个核心方法:
signUp用于创建用户账号,updateUser用于为用户资料设置displayName;注册流程中会串联调用updateUser方法,注册成功后用户自动跳转至HomeScreen - 异常表现:注册完成进入
HomeScreen时,displayName始终显示为 "null",只有用户主动登出后重新登录,displayName才能正常展示
原始实现代码
首先是全局Controller中的基础定义与signUp方法:
class FirebaseController extends GetxController { FirebaseAuth _auth = FirebaseAuth.instance; Rx<User> _firebaseUser = Rx<User>(); String get user => _firebaseUser.value?.email; String get userid => _firebaseUser.value?.uid; String get displayName => _firebaseUser.value?.displayName; void signUp(String username, String email, String password) async { CollectionReference dbref = FirebaseFirestore.instance.collection("users"); await _auth .createUserWithEmailAndPassword(email: email, password: password) .then((value) { dbref .doc(userid) .set({ "username": username, "email": email, "password": password, "uid": userid, }) .then((value) => updateUser(username: username)) .then((value) => Get.offAll(HomeScreen())); }).catchError( (onError) => Get.snackbar("Error while creating account ", onError.message), ); } }
然后是updateUser方法的原始实现:
void updateUser({username}) async { await _auth.currentUser .updateProfile(displayName: username) .then((value) => _firebaseUser.value.reload()) .then((value) => Get.snackbar("User Created", "User has been created")) .catchError((onError) => Get.snackbar("Error while Updating DisplayName ", onError.message)); }
核心疑问:上述实现到底哪里存在逻辑错误,导致首次注册后displayName显示为null?
错误根因
三处核心实现缺陷叠加导致了这个问题:
- Rx用户对象的初始化时机错位
注册流程中调用createUserWithEmailAndPassword完成账号创建后,代码从未将Auth返回的用户实例赋值给_firebaseUser.value。虽然userid能取值成功是因为Firebase Auth单例内部已经自动同步了当前登录用户,但_firebaseUser本身的对象引用从注册开始就是空的,后续所有依赖这个对象的逻辑都缺乏正确的数据源。 reload()操作没有触发响应式状态更新
代码中调用_firebaseUser.value.reload()的作用是将内存中持有的User实例的网络数据重新拉取刷新,但存在两个逻辑漏洞:- 持有的
_firebaseUser.value本身就是未正确初始化的空引用,reload操作的主体对象本身就不对 - 就算reload成功拉取到了带新displayName的用户数据,也没有将最新的用户实例重新赋值给
_firebaseUser.value,GetX的响应式机制根本感知不到数据变化,UI自然还是展示初始的null值
- 持有的
- 异步调用链没有正确等待,页面跳转时机过早
updateUser方法被定义为无返回值的void类型,相当于这个方法内部的所有异步操作(更新资料、reload数据)根本没有被纳入整个注册流程的等待队列。代码执行完Firestore的文档写入后,会立刻触发Get.offAll(HomeScreen())跳转,这时候displayName的更新、用户数据的刷新可能还在网络请求途中,页面拿到的自然是旧的、没有displayName的用户数据。
修正方案
按照以下逻辑调整即可解决问题:
- 在账号创建完成的第一时间,将Auth返回的用户实例赋值给
_firebaseUser.value,补全数据源 - 将
updateUser方法改为返回Future类型,确保整个调用链会等待资料更新、数据刷新完成后再执行跳转 - 在调用
reload()完成后,手动将最新的_auth.currentUser实例重新赋值给_firebaseUser.value,触发响应式UI更新
修正后的参考代码:
// 修正后的signUp方法 void signUp(String username, String email, String password) async { CollectionReference dbref = FirebaseFirestore.instance.collection("users"); try { // 等待账号创建完成,获取用户凭证 final userCredential = await _auth.createUserWithEmailAndPassword( email: email, password: password, ); // 第一时间同步用户实例到Rx对象 _firebaseUser.value = userCredential.user; // 等待Firestore用户文档写入完成 await dbref.doc(userid).set({ "username": username, "email": email, "password": password, "uid": userid, }); // 等待displayName更新、用户数据刷新完成 await updateUser(username: username); // 全流程完成后再跳转主页 Get.offAll(HomeScreen()); } on FirebaseAuthException catch (onError) { Get.snackbar("Error while creating account ", onError.message); } } // 修正后的updateUser方法 Future<void> updateUser({required String username}) async { try { // 等待displayName更新接口调用完成 await _auth.currentUser!.updateDisplayName(username); // 等待最新用户数据拉取完成 await _auth.currentUser!.reload(); // 手动同步最新用户实例到Rx对象,触发UI更新 _firebaseUser.value = _auth.currentUser; Get.snackbar("User Created", "User has been created"); } on FirebaseAuthException catch (onError) { Get.snackbar("Error while Updating DisplayName ", onError.message); } }
补充说明:登出重登后displayName能正常显示,本质是因为重登流程会触发Firebase Auth完整拉取用户的云端资料,这时候如果正确初始化了用户实例赋值逻辑,自然能拿到正确的displayName值;但注册流程里因为缺少用户实例的手动同步步骤,Rx对象感知不到数据变化,就会出现首次进入页面值为null的问题。
内容的提问来源于stack exchange,提问作者Firaun
相关产品推荐
相关产品推荐

