Flutter对接Firestore计算收支时String强转int类型报错

报错type 'String' is not a subtype of type 'int' in type cast的核心原因是：你从Firebase读取的交易记录Map中，金额类字段（收入/支出/余额相关字段）的实际返回类型是String，但代码中直接使用as int做强制类型转换，类型不匹配直接触发运行时错误。
这类问题在Firebase开发中非常常见，触发场景一般有两种：

• 上传数据时部分端（Web端/其他客户端/手动在后台录入数据）把数字金额存成了字符串格式，比如把100存成了"100"
• 部分场景下Firebase插件跨端传输时会出现数值类型自动转换，固定写死强转int很容易踩坑

第一步：写通用的数值兼容解析方法 #

不要对Firebase返回的字段做硬类型强转，先做类型兼容处理，不管返回的是int、double、String格式的数字，都统一转成可计算的数值类型：

/// 兼容解析Firebase返回的金额字段，避免类型转换错误
num parseFirebaseAmount(dynamic rawValue) {
  // 空值默认返回0
  if (rawValue == null) return 0;
  // 本身就是数值类型直接返回
  if (rawValue is num) return rawValue;
  // 字符串格式的数字尝试解析，解析失败返回0
  if (rawValue is String) return num.tryParse(rawValue.trim()) ?? 0;
  // 其他异常类型默认返回0
  return 0;
}

第二步：修改getTotalBalance统计逻辑 #

把所有直接强转int读取金额的代码，替换成调用上面的解析方法，参考实现：

/// 计算总余额、总收入、总支出
Map<String, num> calculateTotalStats(List<Map<String, dynamic>> recordList) {
  num totalIncome = 0;
  num totalExpense = 0;

  for (final record in recordList) {
    // 错误写法（会触发你现在的报错）：final amount = record['amount'] as int;
    final amount = parseFirebaseAmount(record['amount']);
    final recordType = record['type']?.toString() ?? '';

    if (recordType == 'income') {
      totalIncome += amount;
    } else if (recordType == 'expense') {
      totalExpense += amount;
    }
  }

  return {
    'totalBalance': totalIncome - totalExpense,
    'totalIncome': totalIncome,
    'totalExpense': totalExpense,
  };
}

第三步：同步修复StreamBuilder列表页的取值逻辑 #

列表页渲染单条交易记录的金额时，同样不要用as int强转，统一调用parseFirebaseAmount方法取值，避免列表渲染时抛出同类类型错误。

• 可以登录Firebase后台检查存量数据，把误存为字符串格式的金额字段手动改成数值类型，从数据源层面减少类型不一致的问题
• 后续上传交易数据到Firebase时，金额字段固定传num/int/double类型，不要传字符串格式的数字，从写入端规避问题
• 不要用int类型固定接金额值，Firebase跨端传输时整数偶尔会被转成double类型，用num类型接值可以覆盖两种数值场景，不会触发二次类型错误

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