IntelliJ误标记MapStruct待生成类存在问题，点击后错误消失

针对你遇到的MapStruct接口/抽象类标红波浪线、Auto-Build报javax.annotation.processing.FilerException: Attempt to recreate a file但实际构建运行正常的问题，可尝试以下解决方案：

• 调整IDE注解处理器配置
  打开IDE设置（Settings）→ Build, Execution, Deployment → Compiler → Annotation Processors：

  • 勾选「Enable annotation processing」
  • 选择「Obtain processors from project classpath」，避免IDE与Gradle的注解处理逻辑冲突

• 明确MapStruct生成目录并标记为源码根
  在Gradle构建脚本中指定生成目录，确保路径唯一：

  dependencies {
      annotationProcessor "org.mapstruct:mapstruct-processor:1.5.5.Final" // 使用稳定版
      implementation "org.mapstruct:mapstruct:1.5.5.Final"
  }
  
  compileJava {
      options.annotationProcessorGeneratedSourcesDirectory = file("${project.buildDir}/generated/sources/annotationProcessor/java/main")
      options.compilerArgs += [
          "-Amapstruct.defaultComponentModel=spring", // 按需调整组件模型
          "-Amapstruct.unmappedTargetPolicy=WARN"
      ]
  }
  

  之后在IDE中右键点击该生成目录 → Mark Directory as → Generated Sources Root，让IDE识别为自动生成的源码，避免静态分析报错。

• 避免IDE与Gradle构建冲突

  • 关闭IDE自动构建：Settings → Build, Execution, Deployment → Compiler，取消勾选「Build project automatically」
  • 委托Gradle处理构建：Settings → Build, Execution, Deployment → Build Tools → Gradle，将「Build and run using」和「Run tests using」均设置为「Gradle」，防止IDE与Gradle同时触发注解生成导致文件重复创建。

• 清理缓存与重建项目

  • 执行File → Invalidate Caches...，选择「Invalidate and Restart」清理IDE缓存
  • 手动删除项目根目录下的build文件夹，再执行gradle clean build重新生成所有文件

• 检查版本兼容性

  • 使用MapStruct稳定版本，避免测试版的已知bug
  • 若同时使用Lombok等其他注解处理器，确保版本与MapStruct兼容，避免处理器逻辑冲突

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