如何为已有的MapStruct Mapper添加自定义映射逻辑？

开发者阿泽

2026-10-2

MapStruct 自定义映射问题解答

1. 是否确实需要编写自定义Mapper？

是，你的判断正确。MapStruct本身仅支持自动处理类之间固定字段的映射规则，你需要从InB的List<InC>键值对列表中匹配特定key再赋值给输出对象字段的逻辑属于业务自定义规则，无法通过MapStruct自带的注解自动生成，必须手动补充这部分逻辑。

2. 能否在同事已有的简单Mapper基础上附加自定义逻辑？

完全可以，不需要修改同事已实现的映射规则，MapStruct提供了@AfterMapping注解专门用于补充后置自定义逻辑，不会影响原有自动生成的映射代码。

3. 是否必须完全替换原有实现？

不需要，完全不用重写同事已写好的one/two/three字段的映射逻辑，用后置补充的方式就能实现需求。

最优实现方案

保留原有所有映射规则，仅新增后置处理方法即可：

@Mapper
public interface AMapper {
    // 同事原有映射规则完全保留，无需任何修改
    @Mapping(source = "one", target = "oneX")
    @Mapping(source = "two", target = "twoX")
    @Mapping(source = "three", target = "threeX")
    OutA inAToOutA(InA inA);

    // 新增后置映射逻辑，MapStruct生成代码时会在完成默认字段映射后自动调用该方法
    @AfterMapping
    default void fillKeyValueFields(InA inA, @MappingTarget OutA outA) {
        if (inA.getB() == null || inA.getB().getListOfC() == null) {
            return;
        }
        for (InC c : inA.getB().getListOfC()) {
            switch (c.getKey()) {
                case "alpha":
                    outA.setAlphaX(c.getValue());
                    break;
                case "beta":
                    outA.setBetaX(c.getValue());
                    break;
                default:
                    break;
            }
        }
    }
}

该方案优势：