IntelliJ 2017 Ultimate Gradle项目中MapStruct注解处理器无法运行

我来帮你搞定IntelliJ 2017 Ultimate里MapStruct注解处理器不生成类的问题，不用完全依赖Gradle构建，咱们直接配置IntelliJ的APT来解决：

1. 先把build.gradle的MapStruct配置补正确 #

首先得确保Gradle里的依赖配置是对的，IntelliJ的APT需要读取这里的配置来识别处理器：

plugins {
    id 'org.springframework.boot' version '2.0.0.RELEASE' // 替换成你实际用的Spring Boot版本
    id 'java'
}

dependencies {
    // Spring Boot基础依赖
    implementation 'org.springframework.boot:spring-boot-starter-web'
    
    // MapStruct核心库
    implementation 'org.mapstruct:mapstruct:1.2.0.Final' // 2017年主流稳定版，可根据你的需求调整
    
    // 关键：MapStruct注解处理器必须放在annotationProcessor配置里
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.2.0.Final'
    
    // 如果你的项目用了Lombok，记得加上它的注解处理器（和MapStruct兼容）
    // annotationProcessor 'org.projectlombok:lombok:1.16.20'
}

// 可选但推荐：让Gradle和IntelliJ的APT路径同步
compileJava {
    options.annotationProcessorPath = configurations.annotationProcessor
}

这里要注意：绝对不能把mapstruct-processor放到implementation依赖里，必须用annotationProcessor，不然IntelliJ的APT找不到它。

2. 配置IntelliJ的Annotation Processing设置 #

打开IntelliJ的设置面板（File > Settings），按以下步骤操作：

• 进入Build, Execution, Deployment > Compiler > Annotation Processors
• 勾选Enable annotation processing（这是核心开关，你说已经开了，但再确认下）
• 往下看Processor path：如果IntelliJ没自动加载MapStruct的processor JAR，就点击Add，找到本地Maven仓库里的org.mapstruct:mapstruct-processor:1.2.0.Final.jar添加进去
• 检查Generated sources directory：默认会是$PROJECT_DIR$/build/generated/sources/annotationProcessor/java/main，右键这个目录，选择Mark Directory as > Sources Root，让IntelliJ识别生成的类为源码

3. 清理重建项目 #

做完上面的配置后，按顺序执行：

• Build > Clean Project：清空旧的构建文件
• Build > Rebuild Project：让IntelliJ重新触发APT生成MapStruct的实现类
• 去刚才设置的生成目录里看看，应该能找到*Impl.java的MapStruct实现类了

4. 排查常见的小坑 #

• 版本兼容：IntelliJ 2017支持Java 8/9，MapStruct 1.2.x完全适配，别用太高版本的MapStruct（比如2.x是后来出的，可能和旧版IntelliJ不兼容）
• Gradle设置：如果之前选了委托Gradle构建，记得去File > Settings > Build Tools > Gradle，把Build and run using改成IntelliJ IDEA，这样才会用IntelliJ自己的APT流程
• 如果用Lombok：要确保Lombok的注解处理器也加到了annotationProcessor里，而且IntelliJ的Lombok插件已经启用（Settings > Plugins里搜Lombok，确保是启用状态）

内容的提问来源于stack exchange，提问作者Eric B.