MapStruct未复用其他Mapper类中表达式转换的问题排查

问题原因 #

1. 未关联依赖Mapper #

核心问题是Type2Mapper没有关联Type1Mapper。MapStruct默认不会自动识别其他Mapper的自定义规则，如果你在Type2Mapper上未添加@Mapper(uses = Type1Mapper.class)，处理Type2中的Type1属性时，MapStruct会自动生成一个默认的属性映射实现——这个实现只会做同名属性的简单复制，完全不会复用Type1Mapper中定义的code字段自定义表达式逻辑。

2. 映射规则的作用域限制 #

每个@Mapper接口的@Mapping规则是局部作用域的，仅对当前接口内定义的映射方法生效，不会自动扩散到其他Mapper处理嵌套对象的场景。除非显式通过uses字段引入依赖Mapper，或者在当前Mapper中重复声明规则。

潜在影响 #

• 代码冗余与维护成本上升：为让嵌套对象的自定义映射生效，不得不重复编写@Mapping规则。后续若修改code的生成逻辑（比如前缀从type1-改成t1-），需要同步修改Type1Mapper和所有包含Type1属性的其他Mapper，遗漏任何一处都会导致规则不一致。
• 业务一致性风险：若某个包含Type1属性的Mapper忘记同步规则，会导致不同场景下转换后的code字段值不一致，进而引发业务逻辑错误（比如数据查询、标识匹配失败）。
• 生成代码冗余：每个未关联Type1Mapper的Mapper，都会生成一套独立的Type1→Type1Model转换逻辑，而非复用Type1Mapper的实现，增加了编译后的字节码体积。

解决办法（额外补充） #

在Type2Mapper上添加uses = Type1Mapper.class，让MapStruct复用Type1Mapper的自定义映射规则：

@Mapper(uses = Type1Mapper.class)
public interface Type2Mapper {
    Type2Model toModel(Type2 entity);
}

这样生成的Type2MapperImpl会直接调用Type1Mapper的映射方法处理嵌套的Type1属性，自动应用code字段的表达式逻辑，无需重复编写规则。

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