Flutter中Firebase AuthStateChanges获取用户属性报错求助

问题场景 #

使用Firebase Auth的authStateChanges()监听用户登录状态，将snapshot.data中的用户信息赋值给自定义UserDetails对象时，先后遇到两个错误：

• 初始空安全报错：The property 'email' can't be unconditionally accessed because the receiver can be 'null'
• 添加null断言符!后，报错：The getter 'email' isn't defined for the type 'Object'

错误原因 #

1. 空安全限制：authStateChanges()返回的是Stream<User?>，说明snapshot.data存在为null的可能，直接访问属性违反Dart空安全规则。
2. 类型推断偏差：未给StreamBuilder指定泛型时，Dart会将snapshot.data默认推断为Object?类型，而Object类没有email、displayName等Firebase User的专属属性，导致属性访问失败。

解决方案 #

1. 给StreamBuilder指定泛型User?，明确数据流的类型为Firebase Auth的User对象（可空）。
2. 依赖snapshot.hasData的判断确保snapshot.data非空后，再用!访问属性（此时断言是安全的）。
3. 避免在build方法外部定义userDetails：build会频繁触发，外部定义会导致对象被重复初始化，建议在builder内部创建实例。

修正后的代码 #

Widget build(BuildContext context) {
  return StreamBuilder<User?>( // 显式指定泛型User?
      stream: FirebaseAuth.instance.authStateChanges(),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.waiting) {
          return const Center(
            child: CircularProgressIndicator(),
          );
        } else if (snapshot.hasError) {
          return const Center(
            child: Text("Something Went wrong"),
          );
        } else if (snapshot.hasData) {
          // 在builder内部创建UserDetails实例，避免build触发时重置数据
          final userDetails = UserDetails(
            name: snapshot.data!.displayName ?? "",
            phNo: snapshot.data!.phoneNumber ?? "",
            email: snapshot.data!.email ?? "",
            knownTechnologies: "",
            userDesc: "",
            id: snapshot.data!.uid,
          );
          final provider =
              Provider.of<UpdateProfileDetails>(context, listen: false);
          provider.addUsersProfileDetails(userDetails);
          return const HomePage();
        } else {
          return const MyPageView();
        }
      });
}

补充说明 #

• authStateChanges()的定义明确返回Stream<User?>，指定泛型后，Dart能正确识别snapshot.data的类型，从而允许访问User类的所有属性。
• 用?? ""处理displayName、phoneNumber等可能为null的属性，避免给UserDetails赋值时出现空值问题。

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