使用IntelliJ与Gradle时MapStruct无法生成BeanMapperImpl.java

看起来你在从Eclipse迁移到IntelliJ后遇到了MapStruct代码生成的问题，我来帮你一步步排查解决：

1. 开启IntelliJ的注解处理功能 #

这是最常见的诱因——IntelliJ默认可能未启用注解处理器：

• 打开IntelliJ设置（Windows/Linux：File → Settings；Mac：IntelliJ IDEA → Preferences）
• 导航到Build, Execution, Deployment → Compiler → Annotation Processors
• 勾选Enable annotation processing选项
• 建议选择Obtain processors from project classpath，同时确认Generated sources directory指向Gradle生成路径（比如$PROJECT_DIR$/build/generated/sources/apt/main）

2. 补全Gradle依赖配置 #

你用到了net.ltgt.apt插件，要确保MapStruct的注解处理器依赖完整声明，在subprojects的依赖块里补充：

dependencies {
    // MapStruct核心依赖，替换为你实际使用的版本
    implementation 'org.mapstruct:mapstruct:1.5.5.Final'
    // 注解处理器必须和核心依赖版本一致
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.5.Final'
}

如果你的Gradle版本是7.x及以上，其实可以去掉net.ltgt.apt插件，直接用Gradle原生的annotationProcessor配置即可兼容。

3. 重新同步并触发构建 #

• 点击IntelliJ右侧Gradle面板的Refresh all Gradle projects图标，确保项目配置同步到位
• 执行Gradle清理构建命令：./gradlew clean build（Windows用gradlew.bat clean build），强制触发注解处理器生成代码

4. 切换到Gradle构建模式 #

确保IntelliJ用Gradle而非自身构建系统处理项目：

• 进入Settings → Build, Execution, Deployment → Build Tools → Gradle
• 将Build and run using和Run tests using都设置为Gradle

5. 手动标记生成目录为源码根 #

如果IntelliJ没自动识别生成的代码目录，手动设置：

• 在项目结构中找到build/generated/sources/apt/main目录
• 右键该目录 → Mark Directory as → Sources Root，这样IntelliJ就能识别到生成的BeanMapperImpl.java文件

额外确认 #

你的Mapper接口上的@Mapper注解配置（比如componentModel属性）应该没问题——毕竟之前在Eclipse能正常生成，不过可以快速扫一眼确保没有笔误。

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