Spring Boot自定义注解处理器触发Java内部编译器错误求助

• 开发环境：Spring Boot 2.7.8 + Java 17
• 操作场景：实现自定义注解处理器AnalyzeDataAnnotationProcessor，仅在一个测试类上使用了@AnalyzeData注解
• 异常现象：
  1. 初始阶段注解处理器完全不执行（曾用System.out.println测试无输出）
  2. 编译2-3次后触发java: Compilation failed: internal java compiler error
  3. 即使删除新增的注解、处理器代码，项目依然无法编译通过
• 不同编译器报错细节：
  • Javac：直接报内部编译器错误
  • Eclipse：Module 'server' production: java.util.ServiceConfigurationError: javax.annotation.processing.Processor: Provider com.storely.server.statistics.AnalyzeDataAnnotationProcessor not found
  • Groovy-Eclipse：Groovy-Eclipse: Invalid jar path in the compiler settings: '

相关代码 #

注解定义

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface AnalyzeData {
}

注解处理器

@SupportedAnnotationTypes({"com.storely.server.statistics.AnalyzeData"})
@AutoService(Processor.class)
public class AnalyzeDataAnnotationProcessor extends AbstractProcessor {

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        return false;
    }

}

1. 彻底清理编译缓存 #

缓存残留是这类删代码仍报错问题的核心原因：

• IDEA：执行File -> Invalidate Caches...，勾选"Clear file system cache and local history"后重启
• Eclipse：执行Project -> Clean，选择当前项目清理
• 手动删除项目下的target/classes、target/generated-sources目录，以及IDE生成的缓存目录（如IDEA的.idea、Eclipse的.metadata）

2. 确认AutoService依赖配置 #

@AutoService注解需要依赖Google AutoService库，需确保依赖已正确引入：

Maven配置（pom.xml）

<dependency>
    <groupId>com.google.auto.service</groupId>
    <artifactId>auto-service</artifactId>
    <version>1.0.1</version>
    <scope>provided</scope>
</dependency>

Gradle配置（build.gradle）

annotationProcessor 'com.google.auto.service:auto-service:1.0.1'
compileOnly 'com.google.auto.service:auto-service:1.0.1'

3. 修正注解处理器的服务配置 #

• 检查META-INF/services/javax.annotation.processing.Processor文件，确认其中包含com.storely.server.statistics.AnalyzeDataAnnotationProcessor这一行。如果文件不存在或内容错误，可手动创建该文件并添加该行
• 可将@SupportedAnnotationTypes的参数改为AnalyzeData.class.getName()，避免全类名拼写错误，或临时改为"*"测试处理器是否能被触发

4. 统一JDK与编译器版本配置 #

确保项目编译环境与运行环境一致为Java 17：

• IDEA：File -> Project Structure中，Project SDK、Language Level均设为17；Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler中，Project bytecode version设为17
• Eclipse：Project Properties -> Java Build Path中，JRE System Library选择Java 17；Project Properties -> Java Compiler中，Compiler compliance level设为17

5. 隔离测试排除干扰 #

新建一个极简Spring Boot项目，仅添加注解和处理器代码，测试是否能正常编译执行。如果新项目正常，说明原项目存在其他依赖或配置冲突，可逐步迁移代码排查问题

6. Groovy-Eclipse编译器专项修复 #

针对Groovy-Eclipse的报错，检查编译器配置：

• 打开Window -> Preferences -> Groovy -> Compiler
• 查看"Groovy Libraries"或"Classpath"配置，删除空的或无效的Jar路径
• 确保Groovy-Eclipse插件版本与Java 17兼容

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