Freezed构建带泛型的ApiResponse联合类时build_runner报错如何解决

你遇到的是Freezed处理泛型联合类型时的常见配置问题，核心原因有两个：

• 定义泛型Freezed类时，混入的mixin没有显式传递泛型参数
• 没有开启Freezed的泛型参数工厂支持，生成的代码无法正确识别泛型T的类型，导致编译错误。

按以下步骤调整代码即可解决：

1. 修改类注解，开启泛型参数工厂配置，同时给混入的_$ApiResponse加上泛型参数

import 'package:freezed_annotation/freezed_annotation.dart';

part 'api_response.freezed.dart';

// 新增genericArgumentFactories配置
@Freezed(genericArgumentFactories: true)
class ApiResponse<T> with _$ApiResponse<T> {
  const factory ApiResponse.success(T content, String? message) = _Data;
  const factory ApiResponse.failed(String? message, Object? exception) = _Error;
}

2. 清理旧的生成产物后重新执行代码生成命令，避免旧缓存干扰：
   dart run build_runner build --delete-conflicting-outputs

执行完成后生成的代码就不会再报类型错误，when、map、copyWith等Freezed生成的方法也能正确识别泛型类型。

如果不想调整Freezed配置，或者后续遇到Freezed泛型相关的其他兼容问题，也可以选择以下实现方案：

• 手写Dart 3.0+原生密封类实现：不用依赖代码生成，没有构建错误风险，基础使用体验和Freezed生成的联合类型一致，缺点是需要手动实现copyWith、值相等、toString等常用方法，示例代码：

sealed class ApiResponse<T> {
  const ApiResponse();
}

final class ApiSuccess<T> extends ApiResponse<T> {
  final T content;
  final String? message;
  const ApiSuccess(this.content, [this.message]);
}

final class ApiFailed<T> extends ApiResponse<T> {
  final String? message;
  final Object? exception;
  const ApiFailed([this.message, this.exception]);
}

• 拆分状态与数据模型：不把泛型数据放到联合类型内部，顶层的成功/失败状态只存接口返回的原始结构，每个业务接口单独写自己的数据解析模型，适合接口响应结构差异较大的项目，缺点是会增加部分重复的状态判断模板代码。

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