如何用MapStruct实现通用POJO转换？避免定义大量映射方法

直接定义Object genericMapper(Object object)这类通用方法不可行，因为MapStruct是编译时生成映射代码，必须依赖明确的源/目标类型来分析属性匹配关系，Object类型无法提供足够的类型元数据供框架生成代码。

以下是几种替代方案，既能避免重复定义大量一对一映射方法，又符合MapStruct的编译时生成逻辑：

1. 泛型映射接口 + 公共配置复用 #

通过定义泛型基础接口，让具体的映射接口继承它，MapStruct会自动为每对类型生成对应的映射实现：

步骤1：定义公共映射配置（可选，处理通用转换逻辑） #

public interface CommonMappingConfig {
    // 示例：统一处理LocalDateTime到String的转换
    default String mapLocalDateTime(LocalDateTime dateTime) {
        return dateTime != null ? DateTimeFormatter.ISO_LOCAL_DATE_TIME.format(dateTime) : null;
    }
}

步骤2：定义泛型基础映射接口 #

@Mapper(config = CommonMappingConfig.class)
public interface GenericBiMapper<S, T> {
    T toTarget(S source);
    S toSource(T target);
}

步骤3：创建具体类型的映射接口 #

针对每对需要映射的POJO/DTO，只需要创建空接口继承泛型接口即可，无需手动写映射方法：

// DtoA与DtoB的双向映射
public interface ABMapper extends GenericBiMapper<DtoA, DtoB> {}

// DtoC与DtoD的双向映射
public interface CDMapper extends GenericBiMapper<DtoC, DtoD> {}

MapStruct会自动为每个继承的接口生成包含toTarget和toSource方法的实现类，完全替代手动定义DtoA fromBToA(DtoB dtoB)这类重复代码。

2. 通用属性更新方法（针对同结构对象更新场景） #

如果需求是将一个对象的属性批量更新到另一个对象（比如用DTO更新实体），可以结合@MappingTarget定义通用更新方法：

@Mapper(config = CommonMappingConfig.class)
public interface GenericUpdateMapper {
    <S, T> void updateTargetFromSource(S source, @MappingTarget T target);
}

使用时直接传入源对象和待更新的目标对象，MapStruct会根据编译时的实际类型，自动生成匹配属性的赋值代码，无需反射。

3. Spring环境下结合ConversionService整合 #

如果项目基于Spring，可以让MapStruct生成的映射类实现Spring的Converter<S, T>接口，然后通过ConversionService统一调用映射逻辑：

定义Converter风格的映射接口 #

@Mapper(config = CommonMappingConfig.class)
public interface AToBConverter extends Converter<DtoA, DtoB> {
    @Override
    DtoB convert(DtoA source);
}

@Mapper(config = CommonMappingConfig.class)
public interface BToAConverter extends Converter<DtoB, DtoA> {
    @Override
    DtoA convert(DtoB source);
}

统一调用 #

在业务代码中注入ConversionService，直接通过类型调用映射：

@Autowired
private ConversionService conversionService;

// 将DtoA转为DtoB
DtoB dtoB = conversionService.convert(dtoA, DtoB.class);
// 将DtoB转为DtoA
DtoA dtoA = conversionService.convert(dtoB, DtoA.class);

这种方式无需直接依赖每个Mapper接口，进一步降低代码耦合。

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