Spring Boot中MapStruct配置有效性及故障排查咨询

从你贴的POM配置来看，存在一处关键的兼容性问题，大概率是导致MapStruct不工作的核心原因，咱们一步步拆解分析：

一、当前POM配置的问题点 #

你用的Lombok版本是1.16.18，但同时引入了lombok-mapstruct-binding:0.2.0——这个绑定组件是Lombok 1.18.16及以上版本才需要的，低版本Lombok根本不支持这个绑定逻辑，反而会因为依赖不兼容，导致MapStruct和Lombok的注解处理器无法协同工作。

另外，你的Lombok版本实在太老了（2017年的版本），和MapStruct 1.6.2（2024年的版本）之间的兼容性也存在不少隐患，建议同步升级Lombok到稳定的新版本。

二、修正后的POM配置参考 #

你可以调整成如下兼容的配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.12.1</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.34</version> <!-- 升级到稳定新版 -->
            </path>
            <!-- 因Lombok版本≥1.18.16，保留该绑定组件 -->
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok-mapstruct-binding</artifactId>
                <version>0.2.0</version>
            </path>
            <path>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct-processor</artifactId>
                <version>1.6.2</version>
            </path>
        </annotationProcessorPaths>
        <compilerArgs>
            <compilerArg>
                -Amapstruct.defaultComponentModel=spring
            </compilerArg>
        </compilerArgs>
    </configuration>
</plugin>

另外，别忘了在POM的<dependencies>块中添加MapStruct的核心API依赖：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.6.2</version>
</dependency>

三、故障排查步骤（修正后仍不工作的话） #

如果调整配置后还是失效，可以按以下步骤逐一排查：

• 检查编译日志：执行mvn clean compile -X开启调试日志，重点看有没有注解处理器相关的报错，比如MapStruct处理器是否加载成功、有没有找不到Lombok生成的getter/setter的提示。
• 查看生成的实现类：MapStruct会在target/generated-sources/annotations目录下生成映射器的实现类，如果这个目录是空的，说明注解处理器根本没运行；如果有类，打开看看有没有属性映射逻辑错误。
• 验证Spring组件扫描：因为你配置了mapstruct.defaultComponentModel=spring，映射器接口要加上@Mapper(componentModel = "spring")注解，同时确保Spring能扫描到这个接口所在的包（比如在SpringBoot启动类上用@ComponentScan指定包路径）。
• 确认Lombok生效：检查实体类和DTO类上的@Data/@Getter/@Setter注解是否生成了对应方法，可以通过IDE的“查看字节码”功能验证，或者在代码中尝试调用getter方法看是否编译通过。

备注：内容来源于stack exchange，提问作者Rajivjackz