泛型接口IDTOConvertible<TDto>实现跨模块DTO类型安全映射，实体类声明可转目标类型，编译期校验；配合MapStruct生成零反射映射代码，静态工具方法统一处理集合与嵌套对象。
用泛型方法实现跨模块 DTO 的自动化属性映射与类型安全转换，核心在于把“谁来映射”和“怎么映射”从调用方剥离，交由编译期可验证、运行时零反射开销的契约来约束。关键不是写更多工具类，而是让每个 DTO 和实体自己声明“我能转成什么”，并由统一机制接管执行。
定义泛型转换契约接口
不依赖外部库也能起步，只需一个轻量接口明确转换能力：
- 接口声明为
IDTOConvertible<TDto>，其中TDto是目标 DTO 类型，强制实现类在编译期就绑定具体类型 - 实体类直接实现该接口，例如
UserEntity implements IDTOConvertible<UserDto> - 接口中只暴露一个
toDTO()方法，返回确定类型的 DTO 实例，无 Object 或泛型擦除风险 - 避免使用
<T> T convert(...)这类运行时才确定类型的泛型方法——它无法阻止传入错误类型，也失去 IDE 智能提示
跨模块调用时保持类型上下文
模块 A 提供 UserEntity，模块 B 定义 UserDto，二者通过接口解耦但类型仍需对齐：
- 将
IDTOConvertible接口放在公共基础模块（如common-core）中，被所有业务模块依赖 - 模块 B 在定义
UserDto后，模块 A 的UserEntity才能实现IDTOConvertible<UserDto>；编译失败即暴露类型不匹配问题 - 服务层调用时直接写
userEntity.toDTO().getUsername()—— 返回类型是UserDto，不是Object或? - 若 DTO 类名变更或字段删减，编译器立刻报错，无需等测试或上线才发现空指针或 ClassCastException
配合 MapStruct 实现零配置自动映射
当 DTO/实体字段多、命名不一致或需定制逻辑时，泛型接口 + MapStruct 是高可靠组合：
- 定义
@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.ERROR)接口，泛型参数限定源和目标类型 - 在实现类中注入该 Mapper，并在
toDTO()方法里调用mapper.toDto(this) - MapStruct 编译期生成纯 Java 映射代码，无反射、无运行时代理，启动快、性能稳
- 字段名不同时用
@Mapping(source = "createTime", target = "registerTime")显式声明，比手动 set 更易维护
处理集合与嵌套对象的一致性策略
单个对象映射容易，跨模块处理 List 或含子对象的 DTO 需统一规则：
- 不推荐在泛型接口中加
toDTOList()方法——它破坏单一职责，且 List 泛型擦除后类型信息丢失 - 改用静态工具方法：
DTOConverters.toList(entityList, UserEntity::toDTO)，利用方法引用保留类型推导 - 对嵌套对象（如
UserDto包含AddressDto），要求AddressEntity也实现IDTOConvertible<AddressDto>，形成可递归验证的映射链 - 模块间 DTO 引用应通过接口或不可变 record 声明，避免直接依赖对方模块的具体类，降低循环依赖风险
