Flutter结合Firebase Authentication更新用户资料后如何正确获取最新用户对象

• 打印输出为Instance of 'Future'的直接原因：updateDisplayName是标注了async的异步函数，在onTap回调中没有通过await等待异步执行完成就直接赋值，拿到的自然是未解析的Future对象，而非实际的用户实例。
• 原updateDisplayName实现存在返回链路断裂：
  • 没有显式声明函数的返回值类型，也没有将异步操作完成后的最终用户对象正确透传给外层调用。
  • Firebase Auth的user.reload()方法本身无返回值，仅作用是将本地缓存的用户属性从服务端重新拉取刷新，原代码在then回调内嵌套的返回值无法向上传递到外层调用栈。
• 容易被忽略的实现偏差：
  • 函数形参要求传入User类型实例，但实际调用时传入了字符串类型的widget.username，类型完全不匹配，会直接引发运行时异常。
  • 页面跳转逻辑没有等更新流程执行完成就触发跳转，根本等不到拿到最新用户数据的环节。

修正后的用户更新方法 #

FirebaseAuth auth = FirebaseAuth.instance;

// 显式声明返回类型为Future<User?>，明确告知调用方该异步方法最终会返回最新的用户对象
Future<User?> updateDisplayName(User user, String displayName) async {
  // 执行显示名称更新（替代已废弃的updateProfile方法）
  await user.updateDisplayName(displayName);
  // 重新从服务端拉取最新数据，刷新本地缓存的用户属性
  await user.reload();
  // 刷新完成后直接返回已同步最新数据的auth.currentUser
  return auth.currentUser;
}

修正后的InkWell点击逻辑 #

InkWell(
  // 将回调改为async，支持异步等待操作完成
  onTap: () async {
    // 等待更新、刷新流程跑完，拿到携带最新显示名称的用户实例
    final updatedUser = await updateDisplayName(currentUser, displayName);
    // 此时打印可直接输出实际用户对象，不再是Future实例
    print(updatedUser?.displayName);
    // 待拿到最新用户实例后再执行页面跳转，可将实例作为参数传递给下一个页面
    Navigator.pushReplacement(
      context,
      MaterialPageRoute(
        builder: (context) => MobileNumberScreen(
          username: widget.username,
          currentUser: updatedUser,
        ),
      ),
    );
  },
  child: ....
)

• 不需要在reload()后手动构造新的User对象，Firebase Auth SDK会在reload完成后自动更新auth.currentUser的全量属性，直接返回该实例即可保证数据为服务端最新值。
• 所有异步函数的调用场景，只要需要拿到最终执行结果，就必须搭配await使用，否则获取到的永远是待解析的Future对象。
• 涉及异步操作的页面跳转，一定要把跳转逻辑放在await的后续代码中，否则会出现跳转后下一个页面拿到的还是更新前旧数据的问题。

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