使用FutureBuilder从Firebase Firestore获取用户数据时遇类型错误

错误原因 #

代码直接从Firestore返回的Map中读取profileImage、fullName、email字段，传给需要String类型的组件（如NetworkImage、Text），但这些字段可能为Null，或者字段名拼写错误导致取不到值（返回Null），触发类型转换错误。

修复方案 #

1. 给字段设置默认值 #

用空值合并运算符??为可能为Null的字段设置默认String值，避免组件接收Null：

// 替换原代码中对应字段的使用
NetworkImage(data['profileImage'] ?? 'https://via.placeholder.com/128'),
Text(
  data['fullName'] ?? '匿名用户',
  style: TextStyle(fontWeight: FontWeight.bold, fontSize: 15),
),
Text(
  data['email'] ?? '未绑定邮箱',
  style: TextStyle(fontWeight: FontWeight.bold, fontSize: 15),
),

2. 提前校验并转换字段类型 #

在使用数据前，先显式转换字段类型并处理Null，让代码逻辑更清晰：

if (snapshot.hasData && snapshot.connectionState == ConnectionState.done) {
  Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
  
  // 显式处理Null情况
  final String profileImage = data['profileImage'] as String? ?? '默认头像URL';
  final String fullName = data['fullName'] as String? ?? '未设置姓名';
  final String email = data['email'] as String? ?? '无邮箱';

  // 后续组件使用上述变量即可
}

3. 确保Firestore文档字段完整 #

检查buyers集合中当前用户的文档，确认profileImage、fullName、email字段存在且为String类型（无Null值）。若注册时未写入这些字段，需在注册逻辑中补充必填字段的写入操作。

4. 处理用户未登录场景 #

原代码用currentUser!.uid强制解包，若用户未登录会直接崩溃，需提前校验登录状态：

final currentUser = FirebaseAuth.instance.currentUser;
if (currentUser == null) {
  return Scaffold(body: Center(child: Text('请先登录')));
}
// 再执行Firestore数据获取逻辑

完整修复后的代码 #

Widget build(BuildContext context) {
  final currentUser = FirebaseAuth.instance.currentUser;
  if (currentUser == null) {
    return Scaffold(body: Center(child: Text('请先登录')));
  }

  CollectionReference users = FirebaseFirestore.instance.collection('buyers');
  return FutureBuilder<DocumentSnapshot>(
    future: users.doc(currentUser.uid).get(),
    builder: (BuildContext context, AsyncSnapshot<DocumentSnapshot> snapshot) {

      if (snapshot.hasData && snapshot.connectionState == ConnectionState.done) {
        Map<String, dynamic> data = snapshot.data!.data() as Map<String, dynamic>;
        
        // 处理可能为Null的字段
        final String profileImage = data['profileImage'] as String? ?? 'https://via.placeholder.com/128';
        final String fullName = data['fullName'] as String? ?? '匿名用户';
        final String email = data['email'] as String? ?? '未绑定邮箱';

        return Scaffold(
          appBar: AppBar(
            automaticallyImplyLeading: false,
            elevation: 2,
            backgroundColor: lightblue,
            centerTitle: true,
            title: Text('Profile', style: TextStyle(letterSpacing: 4)),
            actions: [
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Icon(CupertinoIcons.moon),
              ),
            ],
          ),
          body: Column(
            children: [
              SizedBox(height: SizeConfig.screenHeight * 0.015),
              Center(
                child: CircleAvatar(
                  radius: 64,
                  backgroundColor: lightpurple,
                  backgroundImage: NetworkImage(profileImage),
                ),
              ),
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(fullName, style: TextStyle(fontWeight: FontWeight.bold, fontSize: 15)),
              ),
              Padding(
                padding: const EdgeInsets.all(8.0),
                child: Text(email, style: TextStyle(fontWeight: FontWeight.bold, fontSize: 15)),
              ),
              Padding(
                padding: const EdgeInsets.all(15.0),
                child: Divider(color: Colors.grey, thickness: 2),
              ),
              ListTile(leading: Icon(Icons.settings), title: Text('Settings')),
              ListTile(leading: Icon(Icons.phone), title: Text('Phone')),
              ListTile(leading: Icon(Icons.add_shopping_cart), title: Text('Cart')),
              ListTile(leading: Icon(CupertinoIcons.cart), title: Text('Orders')),
              ListTile(leading: Icon(Icons.logout), title: Text('Logout')),
            ],
          ),
        );
      }
      if (snapshot.hasError) {
        return Center(child: Text("加载失败"));
      }
      return Center(child: CircularProgressIndicator());
    },
  );
}

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