json_serializable 项目中 List 类型转换问题的解决方案

问题背景

在使用 json_serializable 进行 JSON 序列化和反序列化时，开发者经常会遇到 List 类型转换的问题。特别是在处理嵌套对象或自定义类型列表时，类型系统可能会抛出类型不匹配的错误。

典型错误场景

当我们在 Dart 模型中使用 List 类型时，json_serializable 生成的代码可能会产生类型转换问题。例如：

@JsonSerializable()
class EmpresaFilial {
  final List<Filial> filiais;
  
  // 构造函数和其他方法...
}

生成的代码可能会尝试将 List<dynamic> 直接赋值给 List<Filial>，导致类型不匹配错误。

根本原因分析

这个问题通常源于以下几个原因：

1. JSON 数据在 Dart 中默认被解析为 List<dynamic> 类型
2. 生成的代码尝试直接将动态类型列表赋值给具体类型列表
3. 类型系统在运行时无法保证列表元素的类型安全

解决方案

方案一：使用正确的类型转换

在自定义的 fromJson 方法中，确保进行正确的类型转换：

static List<CategoryModel> _categoryFromJson(List<dynamic> list) {
  return list.map((e) => CategoryModel.findByApiName(e as String)).toList();
}

方案二：修改模型定义

对于简单的模型，可以修改模型定义来避免这个问题：

@JsonSerializable()
class EmpresaFilial {
  final List<Filial> filiais;

  EmpresaFilial({required this.filiais});

  factory EmpresaFilial.fromJson(Map<String, dynamic> json) =>
      _$EmpresaFilialFromJson(json);
}

json_serializable 会生成正确的转换代码：

EmpresaFilial _$EmpresaFilialFromJson(Map<String, dynamic> json) =>
    EmpresaFilial(
      filiais: (json['filiais'] as List<dynamic>)
          .map((e) => Filial.fromJson(e as Map<String, dynamic>))
          .toList(),
    );

方案三：使用扩展方法

对于复杂的转换逻辑，可以使用扩展方法来处理类型转换：

extension ListConversion on List<dynamic> {
  List<T> convert<T>(T Function(dynamic) converter) {
    return map(converter).toList();
  }
}

然后在 fromJson 方法中使用：

categories: (json['genres'] as List<dynamic>).convert((e) => CategoryModel.findByApiName(e as String))

最佳实践建议

1. 始终为 List 类型提供显式的类型参数
2. 在自定义的 fromJson 方法中处理类型转换
3. 考虑使用扩展方法简化重复的转换逻辑
4. 为复杂的类型转换编写单元测试

总结

json_serializable 是一个强大的工具，但在处理 List 类型时需要特别注意类型安全问题。通过理解 Dart 的类型系统和 json_serializable 的工作机制，我们可以有效地解决这些问题，编写出更健壮的序列化代码。