Flutter对接Firebase谷歌登录类型报错 无法获取Google账号显示名称

报错type 'String' is not a subtype of type 'User'的触发逻辑非常明确：

• 当前封装的signInWithGoogle方法，实际返回的是String类型的序列化用户信息，而非FirebaseAuth定义的User对象
• 后续代码直接把String类型的返回值强转为User类型，类型不匹配就会直接抛出运行时异常
• 这类强转报错和页面跳转、按钮点击逻辑无关，本质是前后方法的返回值约定不对等

场景1：未正确走完Firebase Google登录流程（最常见） #

按照标准流程，Google登录的正确链路是「触发Google账号授权 → 获取授权凭证 → 传入Firebase完成身份校验 → 返回Firebase User对象」，如果中途把用户信息转成字符串做返回值，就会彻底丢失原生User对象的属性访问能力。

1. 先把signInWithGoogle方法的返回值修正为Future<User?>，删除多余的String序列化逻辑：

   Future<User?> signInWithGoogle() async {
     // 触发Google账号选择弹窗
     final googleUser = await GoogleSignIn().signIn();
     // 用户取消授权直接返回空
     if (googleUser == null) return null;
   
     // 获取授权凭证
     final googleAuth = googleUser.authentication;
     final credential = GoogleAuthProvider.credential(
       accessToken: googleAuth.accessToken,
       idToken: googleAuth.idToken,
     );
   
     // 传入Firebase完成登录，直接返回内置User对象
     final userCredential = await FirebaseAuth.instance.signInWithCredential(credential);
     return userCredential.user;
   }
   

2. 修正原有的点击触发逻辑，去掉无意义的强转，增加空值判断：

   void click() async {
     final currentUser = await signInWithGoogle();
     // 登录失败/用户取消时阻断后续流程
     if (currentUser == null) return;
     
     // 直接从User对象取displayName，做空值兜底
     final displayName = currentUser.displayName ?? "未设置账号昵称";
     Navigator.push(
       context,
       MaterialPageRoute(builder: (context) => MyHomePage(displayName))
     );
   }
   

场景2：业务要求signInWithGoogle必须返回String类型的用户信息 #

如果因为模块拆分、序列化存储的需求，方法本身约定返回String格式的用户信息（通常是JSON序列化后的字符串），就不要做强转，先解析内容再取字段：

1. 引入Dart自带的json解析工具

   import 'dart:convert';
   

2. 在回调中先把String转成结构化的Map，再提取对应的显示名字段：

   void click() {
     signInWithGoogle().then((userStr) {
       // 把序列化的字符串解析为Map结构
       final userInfo = jsonDecode(userStr) as Map<String, dynamic>;
       // 从Map中读取displayName字段，增加空值兜底
       final displayName = userInfo['displayName'] as String? ?? "未设置账号昵称";
       
       Navigator.push(
         context,
         MaterialPageRoute(builder: (context) => MyHomePage(displayName))
       );
     });
   }
   

• 避免在then回调里使用和类成员同名的参数名（比如原代码里回调参数直接命名为user），会造成作用域混淆，容易错把String类型的回调值赋值给类里的User类型成员变量
• 读取displayName时必须做空值兼容，部分未设置公开昵称的Google账号，该字段会返回null
• 只要碰到类型强转的运行时报错，优先打印方法实际的返回值类型，不要盲目照搬教程里的强转写法，教程里的方法返回约定和你本地的实现不一致时，强转就必然报错

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