Flutter从API获取MongoDB数据时出现Null转String类型错误求助

错误核心原因 #

这个报错是因为API返回的某个字段值为null，但你的Category模型类中对应的字段被定义为非空的String类型，导致类型转换失败。常见触发场景：

• MongoDB中部分分类的categoryName或categoryGujaratiName字段为null
• API返回的字段名与代码中使用的键名不匹配（比如大小写错误，如categoryname vs categoryName）
• 模型类字段未声明为可空类型

具体解决方案 #

1. 调整Category模型类，兼容空值 #

如果数据库允许字段为空，将模型中的对应字段改为可空类型String?，或给空值设置默认值：

// category.model.dart
class Category {
  final String? id;
  final String categoryName;
  final String categoryGujaratiName;

  Category({
    this.id,
    required this.categoryName,
    required this.categoryGujaratiName,
  });

  // 推荐使用命名构造函数统一处理空值
  Category.fromMap(Map<String, dynamic> map)
      : id = map['_id'],
        categoryName = map['categoryName'] ?? '', // 空值替换为空字符串
        categoryGujaratiName = map['categoryGujaratiName'] ?? '';
}

2. 在数据解析层强制处理null #

修改CategoryService的解析逻辑，给每个字段添加null检查，避免直接赋值null给非空String：

static Future<List<Category>> fetchAllCategories() async {
  final response = await http.get(Uri.parse(apiUrl));

  if (response.statusCode == 200) {
    final List<dynamic> responseData = jsonDecode(response.body);
    return responseData.map((item) {
      // 打印返回数据，方便排查字段问题
      print('返回的分类数据：$item');
      return Category(
        id: item['_id'] ?? '',
        categoryName: item['categoryName'] ?? '',
        categoryGujaratiName: item['categoryGujaratiName'] ?? '',
      );
    }).toList();
  } else {
    throw Exception('获取分类失败');
  }
}

3. 验证API返回字段的一致性 #

对比Postman返回的JSON字段名与代码中使用的键名，确保完全一致，比如正确返回格式应为：

[
  {
    "_id": "60d21b4667d0d8992e610c85",
    "categoryName": "Vegetables",
    "categoryGujaratiName": "કારણસભ્યો"
  }
]

如果字段名是小写（如categoryname），需同步修改代码中的键名。

4. UI层增加空值兜底处理 #

即使数据层处理了空值，UI层也可以添加判断，优化用户体验：

// CategoryList的ListTile部分
title: Text(category.categoryName.isEmpty ? '未命名分类' : category.categoryName),
subtitle: Text(category.categoryGujaratiName.isEmpty ? '无 Gujarati 名称' : category.categoryGujaratiName),

额外排查步骤 #

• 运行App时查看控制台打印的返回的分类数据日志，确认每个字段的实际值
• 检查MongoDB数据库中的文档，确保没有缺失必填字段

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