Dart包/库导出模型时高效使用json_serializable与泛型的方案探讨

针对你的需求——让包使用者无需额外配置即可完成泛型对象的序列化，推荐采用静态自动注册工厂的方案替代当前的全局可变映射，既保持简洁又避免手动配置。

实现步骤 #

1. 定义统一接口与静态注册器

创建一个用于管理序列化工厂的静态类，同时定义接口约束所有模型具备toJson方法，并添加错误处理提升调试体验：

// 约束模型必须实现toJson方法
abstract class JsonSerializableModel {
  Map<String, dynamic> toJson();
}

// 静态工厂注册器，负责存储各类型的fromJson构造函数
class JsonFactory {
  static final Map<Type, Object Function(Map<String, dynamic>)> _factories = {};

  // 注册类型对应的fromJson工厂
  static void register<T>(T Function(Map<String, dynamic>) factory) {
    _factories[T] = factory;
  }

  // 根据类型获取工厂并反序列化，添加错误提示
  static T fromJson<T>(Map<String, dynamic> json) {
    final factory = _factories[T];
    if (factory == null) {
      throw StateError('未找到类型$T的fromJson工厂，请确保已导入对应模型。');
    }
    return factory(json) as T;
  }
}

2. 包内模型自动注册工厂

在你包中的每个freezed模型里，添加顶层变量触发自动注册。当使用者导入模型时，该变量会自动初始化并完成工厂注册：

part 'model_a.freezed.dart';
part 'model_a.g.dart';

@freezed
class ModelA with _$ModelA implements JsonSerializableModel {
  const factory ModelA({String? id}) = _ModelA;

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

// 自动注册ModelA的fromJson工厂，导入模型时自动执行
final _registerModelA = JsonFactory.register<ModelA>(ModelA.fromJson);

对包内所有freezed模型重复此操作，确保每个模型导入时自动完成注册。

3. 简化泛型转换器

修改原有的GenericJsonConverter，使用静态注册器替代全局可变映射：

class GenericJsonConverter<T> implements JsonConverter<T, Object?> {
  const GenericJsonConverter();

  @override
  T fromJson(Object? json) {
    return JsonFactory.fromJson<T>(json as Map<String, dynamic>);
  }

  @override
  Object? toJson(T object) {
    return (object as JsonSerializableModel).toJson();
  }
}

方案优势 #

• 零使用者配置：使用者只需导入包内模型，无需手动初始化工厂映射
• 类型安全：通过接口约束确保模型具备toJson方法，降低动态类型转换风险
• 无全局可变状态：替代原有的全局可变映射，避免意外覆盖或并发问题
• 友好调试：添加工厂未找到的错误提示，快速定位问题

其他备选方案（不推荐） #

• dart:mirrors反射：可通过反射自动调用T.fromJson，但反射在Flutter生产环境中会显著增加包体积，且无法被树摇优化，不适合发布包使用
• generic_argument_factories：虽能实现类型安全的序列化，但会给使用者带来大量样板代码，不符合你追求的简洁性目标

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