Flutter项目报错：'Null'不是'Map<String, dynamic>'子类型求排查及代码建议

错误原因与修复 #

控制台报错'type 'Null' is not a subtype of type 'Map<String, dynamic>' in type cast'，本质是数据解析时将null强制转换为Map或数值类型。结合你提到设置amount为常量0.00就正常，大概率是Firebase返回的amount字段存在null值，或者某个嵌套的Map字段为null，而你的模型类直接用as做强制转换，没有处理空值。

具体修复步骤： #

1. 检查Firebase数据：确认你的transactions集合中，是否存在amount字段缺失或为null的记录，这类脏数据会导致解析失败。
2. 修改Transaction模型的fromJson方法：对可能为null的字段做空安全处理，避免强制转换错误：

class Transaction {
  final String id;
  final double amount;
  final String title;
  // 其他字段...

  Transaction({required this.id, required this.amount, required this.title});

  factory Transaction.fromJson(Map<String, dynamic> json) {
    return Transaction(
      id: json['id'] as String? ?? '', // 为空时给默认值
      // 处理amount可能为null的情况，先转num再转double，空值用0.00兜底
      amount: (json['amount'] as num?)?.toDouble() ?? 0.00,
      title: json['title'] as String? ?? '无标题',
      // 如果有嵌套Map类型字段，比如details，要先判断非空再转换
      // details: json['details'] != null ? Details.fromJson(json['details'] as Map<String,dynamic>) : null,
    );
  }
}

getData方法规范 #

从代码健壮性和可维护性来看，你的getData方法需要优化以下几点：

规范写法示例 #

Future<List<Transaction>> getData() async {
  try {
    final querySnapshot = await FirebaseFirestore.instance.collection('transactions').get();
    
    // 先判断快照是否为空
    if (querySnapshot.docs.isEmpty) {
      return [];
    }

    return querySnapshot.docs.map((doc) {
      // 先判断文档数据是否为null
      final docData = doc.data();
      if (docData == null) {
        throw FormatException('文档数据为空，ID: ${doc.id}');
      }
      // 调用安全处理后的fromJson方法
      return Transaction.fromJson(docData);
    }).toList();
  } catch (e) {
    // 捕获并打印异常，避免崩溃
    print('获取数据失败: $e');
    // 根据业务需求返回空列表或抛出异常
    return [];
  }
}

关键优化点： #

• 空安全检查：对doc.data()、快照结果做非空判断，避免null引发的类型错误；
• 异常捕获：用try-catch包裹数据请求和解析逻辑，捕获网络、解析异常，防止应用崩溃；
• 类型安全处理：所有字段转换都添加空值兜底，不直接用as强制转换可能为null的字段；
• 可维护性：添加错误日志，方便排查问题，同时返回合理的默认值（比如空列表）。

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