Flutter用Lit Firebase Auth实现Google登录获取Google用户名传入userSetup

在Flutter应用身份验证开发中，已完成邮箱注册全链路逻辑：引导用户自行输入自定义用户名，调用FirebaseAuth创建账号后，将用户输入的文本同步到Firebase Auth用户profile的displayName字段，再通过userSetup方法将用户资料写入自有数据库完成初始化。
目前使用Lit Firebase Auth完成Google登录集成，仅需执行context.signInWithGoogle()即可走完整套Google登录授权流程，但暂未明确如何从Google登录的返回结果中获取用户的Google账号显示名，不知道该给userSetup方法传入什么参数，才能和邮箱注册流程保持一致，完成Google登录账号的数据库初始化。

• 不要忽略context.signInWithGoogle()的返回值：这个方法会返回标准的UserCredential对象，和邮箱注册时调用createUserWithEmailAndPassword拿到的对象结构完全一致
• Firebase Auth在对接Google身份提供商时，已经在登录流程中自动从Google侧拉取了用户的公开显示名，直接读取UserCredential.user.displayName即可拿到对应的Google用户名，无需额外调用第三方接口拉取
• 将读取到的显示名作为入参传入userSetup，即可复用现有邮箱注册的数据库初始化逻辑，保持两条登录链路的一致性

异常兜底说明：如果遇到用户未在Google账号设置公开显示名的极端情况，displayName字段会返回null，此时可以增加一层逻辑判断，优先取用户绑定的Google邮箱前缀作为默认展示名，避免传空值导致数据库写入异常。

try {
  // 接收Google登录接口返回的凭证对象
  final googleLoginCred = await context.signInWithGoogle();
  // 按优先级取展示名：优先Google同步的displayName，兜底取邮箱前缀，最后兜底默认值
  final displayName = googleLoginCred.user?.displayName 
      ?? googleLoginCred.user?.email?.split('@').first 
      ?? '平台新用户';
  // 直接调用现有初始化方法完成数据库写入
  userSetup(displayName);
  // 登录完成跳转主页
  Navigator.of(context).pushAndRemoveUntil(
    HomeScreen.route, (route) => false);
} catch (err) {
  // 补充Google登录失败的异常提示逻辑
}

• Google登录成功后不需要手动调用updateProfile更新displayName：Firebase Auth会自动同步Google侧的用户名、头像地址到当前用户的profile字段，手动重复更新反而可能覆盖正确的同步值
• 优先使用登录接口返回的UserCredential对象读取用户信息，不要在登录刚完成的节点直接调用FirebaseAuth.instance.currentUser取值：受Auth状态异步刷新的延迟影响，该接口在登录瞬间可能返回null值，使用接口返回的凭证对象取值更稳定

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