如何配置MapStruct生成支持构造器依赖注入的实现类构造器

在使用MapStruct结合Spring生态做对象映射开发时，期望生成的Mapper实现类支持构造器方式的依赖注入。即便已经在@Mapper注解中配置了Spring组件模型、构造器注入策略，生成的实现类仍然没有可用于注入的带参构造器，无法满足构造器依赖的使用要求。

当前写法没有触发MapStruct的构造器生成逻辑，核心问题有两点：

• 抽象类定义的Mapper中，你将依赖dependency声明为无特殊修饰的私有字段，MapStruct无法将其识别为需要纳入注入范围的Bean
• 注入策略的生效存在识别边界：MapStruct仅会对可扫描到的、需要外部注入的Bean生成对应的构造器参数，不会把类的内部私有字段自动纳入构造器

核心调整点 #

关键调整：在抽象类定义的Mapper场景下，将需要注入的依赖字段从private改为protected，让MapStruct可以识别到该字段为需要外部注入的依赖，完整的写法如下：

@Mapper(
    componentModel = "spring",
    uses = Dependency.class,
    injectionStrategy = InjectionStrategy.CONSTRUCTOR
)
public abstract class MapStructTest {
    // 将原private修饰的依赖改为protected
    protected Dependency dependency;

    @Mapping(source = "field", target = "target")
    @Mapping(target = "target2", ignore = true)
    @AfterMapping
    public final void runAfter(Source source, @MappingTarget Target target) {
        // 原有AfterMapping的目标字段处理逻辑
    }
}

生成逻辑说明 #

按照上述写法调整后，MapStruct会在生成的实现类中自动包含以下内容：

• 生成全参构造器，将所有识别到的注入依赖（包含uses声明的Bean、类中定义的protected依赖字段）作为构造器入参
• 生成的类会被Spring自动扫描注册为Bean，直接支持构造器依赖注入，不会走默认的无参构造+字段注入的逻辑

• 不要在依赖字段上手动添加@Autowired注解，MapStruct会根据配置的注入策略自动生成对应的注入逻辑，手动添加Spring注解反而会触发字段注入的分支，绕开构造器生成逻辑
• 不要给依赖字段设置默认初始值，否则MapStruct会将其判定为类的内部属性，不会纳入构造器参数范围
• 如果使用接口而非抽象类定义Mapper，不需要单独声明依赖字段，MapStruct会自动将uses中声明的所有Bean作为构造器入参，直接支持构造器注入

内容的提问来源于stack exchange，提问作者Prince of Sweden