Mapstruct @Mapper注解无法识别问题排查求助

针对你遇到的MapStruct @Mapper注解无法识别问题，结合Java 17 + IntelliJ环境，给出以下排查和解决步骤：

1. 检查IntelliJ Lombok插件状态 #

• 打开IntelliJ的Settings > Plugins，搜索Lombok插件，确认它已安装并启用
• 若刚安装插件，重启IntelliJ生效

2. 细化IntelliJ注解处理器配置 #

• 进入Settings > Build, Execution, Deployment > Compiler > Annotation Processors
  • 除了勾选Enable annotation processing，还要确保Obtain processors from project classpath被选中
  • 可以尝试勾选Store generated sources relative to module content root，并指定生成目录（比如target/generated-sources/annotations）

3. 升级Maven编译器插件版本 #

你当前使用的maven-compiler-plugin 3.8.1对Java 17的支持有限，建议升级到3.10.1及以上版本：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.10.1</version>
    <configuration>
        <source>17</source>
        <target>17</target>
        <annotationProcessorPaths>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>1.18.30</version>
            </path>
            <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.5.5.Final</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

4. 清理并重新构建项目 #

• 执行Maven命令：mvn clean install -U，强制更新依赖并重新编译
• 手动删除本地Maven仓库中MapStruct和Lombok相关的缓存目录（比如.m2/repository/org/mapstruct和.m2/repository/org/projectlombok），再重新拉取依赖

5. 检查模块依赖配置 #

确保mapstruct依赖是compile范围（默认就是，无需额外指定），而mapstruct-processor仅在注解处理阶段生效，不要添加为普通依赖（避免冗余）

6. 手动指定注解处理器JAR #

如果上述步骤无效，可以尝试在IntelliJ中手动添加注解处理器：

• 进入Settings > Build, Execution, Deployment > Compiler > Annotation Processors
• 点击Add，选择本地Maven仓库中的mapstruct-processor-1.5.5.Final.jar和lombok-1.18.30.jar

7. 排查其他注解处理器冲突 #

检查项目中是否引入了其他注解处理器（比如Dozer、ModelMapper的处理器），这些可能和MapStruct的注解处理器产生冲突，尝试暂时移除无关的注解处理器依赖，再测试

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