IntelliJ IDEA搭配MapStruct构建报bad class file内部错误求助

问题场景 #

使用IntelliJ IDEA 2021.2.2版本搭配MapStruct 1.4.2.Final版本时，IDEA本地构建项目会触发bad class file错误，MapStruct映射处理器内部报错，但通过Maven命令构建却能正常运行。编译器日志如下：

DEBUG - s.incremental.java.JavaBuilder - java:ERROR:Internal error in the mapping processor: com.sun.tools.javac.jvm.ClassReader$BadClassFile: bad class file:    Please remove or make sure it appears in the correct subdirectory of the classpath.  
    at com.sun.tools.javac.jvm.ClassReader.badClassFile(ClassReader.java:357)
  at com.sun.tools.javac.jvm.ClassReader.readEnclosingMethodAttr(ClassReader.java:1276)
  at com.sun.tools.javac.jvm.ClassReader$12.read(ClassReader.java:1130) 
  at com.sun.tools.javac.jvm.ClassReader.readAttrs(ClassReader.java:1381)
  at com.sun.tools.javac.jvm.ClassReader.readClassAttrs(ClassReader.java:1396) 
  at com.sun.tools.javac.jvm.ClassReader.readClass(ClassReader.java:2226) 
  at com.sun.tools.javac.jvm.ClassReader.readClassFile(ClassReader.java:2324)
  at com.sun.tools.javac.jvm.ClassReader.fillIn(ClassReader.java:2511)
  at com.sun.tools.javac.jvm.ClassReader.complete(ClassReader.java:2442) 
  at com.sun.tools.javac.jvm.ClassReader.access$000(ClassReader.java:76) 
  at com.sun.tools.javac.jvm.ClassReader$1.complete(ClassReader.java:240) 
  at com.sun.tools.javac.code.Symbol.complete(Symbol.java:574)
  at com.sun.tools.javac.code.Symbol$ClassSymbol.complete(Symbol.java:1037) 
  at com.sun.tools.javac.code.Symbol$ClassSymbol.flags(Symbol.java:973)
  at com.sun.tools.javac.code.Symbol$TypeSymbol.getEnclosedElements(Symbol.java:734)
  at javax.lang.model.util.ElementScanner6.visitPackage(ElementScanner6.java:167) 
  at com.sun.tools.javac.code.Symbol$PackageSymbol.accept(Symbol.java:901)      
  at com.sun.tools.javac.processing.JavacRoundEnvironment$AnnotationSetScanner.scan(JavacRoundEnvironment.java:158)
  at com.sun.tools.javac.processing.JavacRoundEnvironment$AnnotationSetScanner.scan(JavacRoundEnvironment.java:127) 
  at com.sun.tools.javac.processing.JavacRoundEnvironment.getElementsAnnotatedWith(JavacRoundEnvironment.java:121) 
  at org.mapstruct.ap.MappingProcessor.getMappers(MappingProcessor.java:235)
  at org.mapstruct.ap.MappingProcessor.process(MappingProcessor.java:165) 
  at com.sun.tools.javac.processing.JavacProcessingEnvironment.callProcessor(JavacProcessingEnvironment.java:802)
  at com.sun.tools.javac.processing.JavacProcessingEnvironment.discoverAndRunProcs(JavacProcessingEnvironment.java:713)
  at com.sun.tools.javac.processing.JavacProcessingEnvironment.access$1800(JavacProcessingEnvironment.java:91)
  at com.sun.tools.javac.processing.JavacProcessingEnvironment$Round.run(JavacProcessingEnvironment.java:1043) 
  at com.sun.tools.javac.processing.JavacProcessingEnvironment.doProcessing(JavacProcessingEnvironment.java:1184)
  at com.sun.tools.javac.main.JavaCompiler.processAnnotations(JavaCompiler.java:1170) 
  at com.sun.tools.javac.main.JavaCompiler.compile(JavaCompiler.java:856)

解决办法 #

• 清理IDEA缓存并重启：点击菜单栏File -> Invalidate Caches...，勾选Clear file system cache and local history选项，然后点击Invalidate and Restart，清除IDEA的编译缓存，解决缓存不一致问题。
• 对齐IDEA与Maven的JDK版本：打开File -> Project Structure -> Project Settings -> Project，确认Project SDK和Project language level与Maven pom.xml中配置的JDK版本一致；再进入Build, Execution, Deployment -> Compiler -> Java Compiler，检查每个Module的Target bytecode version是否和pom.xml里的配置匹配。
• 清理编译目录后重新构建：先执行Maven的mvn clean命令，手动删除IDEA生成的out目录，再用IDEA重新全量构建项目，避免旧的编译文件干扰。
• 检查MapStruct依赖配置：确保pom.xml中MapStruct的核心依赖和注解处理器版本一致，配置示例如下：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.4.2.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.4.2.Final</version>
    <scope>provided</scope>
</dependency>

• 关闭增量编译：进入Settings -> Build, Execution, Deployment -> Compiler，取消勾选Build project automatically和Compile independent modules in parallel，然后执行全量构建，避免增量编译的逻辑冲突。

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