Flutter中type 'Null' is not a subtype of type 'String'类型转换错误排查

核心原因 #

错误本质是CloudJobApplication模型类中，某几个被定义为非可空String类型的字段，在Firebase数据库中对应的值为null或字段不存在，导致解析时强制将null转为String失败。

排查与修复步骤 #

1. 检查CloudJobApplication模型类 #

定位所有声明为非可空String的字段，比如：

class CloudJobApplication {
  final String id;
  final String jobId;
  final String applicantName; // 该字段可能在Firebase中为空
  // 其他字段...

  CloudJobApplication({
    required this.id,
    required this.jobId,
    required this.applicantName,
    // 其他参数...
  });

  factory CloudJobApplication.fromMap(Map<String, dynamic> map) {
    return CloudJobApplication(
      id: map['id'] as String,
      jobId: map['jobId'] as String,
      applicantName: map['applicantName'] as String, // 此处若map值为null会直接报错
      // 其他字段解析...
    );
  }
}

2. 修复模型类的空值处理 #

针对可能为空的字段，按业务需求二选一处理：

• 若字段允许为空，将类型改为String?，并适配解析逻辑：

final String? applicantName;

// fromMap方法中
applicantName: map['applicantName'] as String?,

• 若字段必须有值，给默认值兜底：

applicantName: (map['applicantName'] as String?) ?? '未知申请人',

3. 排查Firebase数据读取逻辑 #

在FirebaseCloudStorage的查询方法中添加日志，直观查看返回的字段值：

Future<List<CloudJobApplication>> fetchJobApplications() async {
  final snapshot = await firebaseFirestore.collection('jobApplications').get();
  return snapshot.docs.map((doc) {
    final data = doc.data();
    print('申请数据详情：$data'); // 打印后可定位哪个字段为null
    return CloudJobApplication.fromMap(data);
  }).toList();
}

4. 适配前端JobApplicationsView的UI展示 #

如果模型字段改为可空类型，UI层需处理null情况：

Text(application.applicantName ?? '未知申请人'),

快速验证方案 #

临时在fromMap方法中给所有String字段添加空值兜底，若错误消失，即可确认是对应字段存在null值：

id: map['id'] as String? ?? '',
jobId: map['jobId'] as String? ?? '',

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