Java中泛型DTO需定义为BaseResponse<T>并声明private T data，配无参构造器；反序列化必须用TypeReference指定完整泛型类型，如new TypeReference<BaseResponse<List<StudentInfo>>>(){}，不可仅传BaseResponse.class。
Java 中泛型在 DTO 中做通用类型封装，核心是让 DTO 的某个字段能承载任意业务数据类型（如 StudentInfo、List<Order>、PageResult<Product>），同时保持编译期类型安全和反序列化可用性。关键不在“能不能用泛型”，而在于“怎么用才不踩坑”。
DTO 定义要带泛型参数，且 data 字段声明为 T
泛型 DTO 必须是可参数化的类，不能只在方法里用。典型结构如下：
- 定义一个基础响应 DTO，含
code、message、data三字段 -
data类型设为泛型T，并用private T data声明 - 类本身声明为
public class BaseResponse<T>，而非BaseResponse<Object> - 必须提供无参构造器（JSON 反序列化必需），Lombok 加
@NoArgsConstructor即可
示例：
public class BaseResponse<T> implements Serializable {
private String code;
private String message;
private T data;
public BaseResponse() {}
// getter/setter 省略
}
反序列化时必须传入具体 TypeReference，不能只靠 Class<T>
JSON 库（如 Fastjson、Jackson）擦除泛型信息，仅靠 BaseResponse.class 无法还原 data 的真实类型。必须用 TypeReference 显式描述嵌套泛型结构。
立即学习“Java免费学习笔记（深入）”；
- 解析单个对象：
JSON.parseObject(json, new TypeReference<BaseResponse<StudentInfo>>() {}) - 解析 List：用
new TypeReference<BaseResponse<List<StudentInfo>>>() {} - 解析嵌套分页：
new TypeReference<BaseResponse<PageResult<Product>>>() {} - 避免写
JSON.parseObject(json, BaseResponse.class)—— 此时data会变成LinkedHashMap
对外提供泛型方法，把 TypeReference 封装进去
让调用方不用每次手写匿名内部类。工具类中定义泛型方法，接收 Class<T> 或直接接收 TypeReference：
- 适合简单类型（如
StudentInfo.class）：方法签名<T> BaseResponse<T> parse(String json, Class<T> dataClass)，内部用JSON.parseObject(json, new TypeReference<BaseResponse<T>>() {})不行，得动态构造 TypeReference（需借助 TypeUtils 或自定义工具） - 更推荐：直接接收
TypeReference<? extends BaseResponse<?>>，调用方传new TypeReference<BaseResponse<List<User>>>() {}，方法内直接复用 - 若用 Jackson，可用
objectMapper.readValue(json, typeReference)，天然支持
DTO 字段命名与序列化兼容性要提前对齐
泛型 DTO 本质仍是普通 Java 对象，但 JSON 框架依赖字段名、访问器和构造器。几个硬性要求：
- 所有字段必须有 public getter（
getData()），Lombok 的@Data或@Getter足够 - 必须有无参构造器（
@NoArgsConstructor），否则 Jackson/Fastjson 反序列化失败 - 避免在 DTO 中加业务逻辑或重写
toString()引发懒加载等副作用 - 字段名严格匹配 JSON key（如后端返回
"data"，DTO 字段就必须叫data，不能是result）
