如何分离Java注解处理错误与其他编译错误？（Maven场景）

以下是几种可行的解决方法，帮你快速定位触发注解处理器失败的「真实」错误：

1. 分阶段编译：先单独执行注解处理，再编译主代码 #

将Maven编译拆分为两个阶段，第一阶段仅执行注解处理生成代码，第二阶段再正常编译所有文件。这样注解处理器的错误会单独输出，不会被后续的生成代码缺失错误覆盖。

修改pom.xml中的maven-compiler-plugin配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>${maven-compiler-plugin.version}</version>
    <executions>
        <!-- 第一阶段：仅执行注解处理，输出处理器错误 -->
        <execution>
            <id>process-annotations-only</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <forceJavacCompilerUse>true</forceJavacCompilerUse>
                <compilerArgs>
                    <arg>-proc:only</arg>
                    <arg>-Xmaxerrs</arg>
                    <arg>1000</arg>
                </compilerArgs>
                <!-- 可选：仅包含带注解的文件，加快处理速度 -->
                <includes>
                    <include>**/*Component.java</include> <!-- Dagger组件类 -->
                    <include>**/*Immutable.java</include> <!-- Immutables注解类 -->
                </includes>
            </configuration>
        </execution>
        <!-- 第二阶段：禁用注解处理，编译所有代码（含生成的代码） -->
        <execution>
            <id>compile-with-generated-code</id>
            <phase>compile</phase>
            <goals>
                <goal>compile</goal>
            </goals>
            <configuration>
                <forceJavacCompilerUse>true</forceJavacCompilerUse>
                <compilerArgs>
                    <arg>-proc:none</arg>
                    <arg>-Xmaxerrs</arg>
                    <arg>1000</arg>
                </compilerArgs>
            </configuration>
        </execution>
    </executions>
    <!-- 明确指定注解处理器，避免依赖传递问题 -->
    <dependencies>
        <dependency>
            <groupId>com.google.dagger</groupId>
            <artifactId>dagger-compiler</artifactId>
            <version>${dagger.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.immutables</groupId>
            <artifactId>value</artifactId>
            <version>${immutables.version}</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
</plugin>

执行mvn clean compile时，第一阶段会先输出注解处理器的错误，若此阶段失败，直接终止，不会进入后续编译阶段。

2. 通过日志定位注解处理器错误 #

使用Maven的调试日志，配合关键词快速过滤处理器错误：

• 执行命令：mvn clean compile -X
• 在输出中搜索关键词：error:（注解处理器的错误会带此前缀）、DaggerProcessor或ImmutablesProcessor（对应处理器的错误信息）
• 这些错误会出现在生成代码缺失错误之前，优先查看这部分内容即可找到「真实」错误。

3. IDE中过滤生成代码相关错误 #

如果使用IDE（如IntelliJ IDEA）编译：

• 打开「Problems」窗口，点击右上角的过滤按钮
• 添加过滤规则：排除包含Dagger或Immutable的「找不到符号」错误
• 过滤后剩下的就是原始源文件中的错误，即触发处理器失败的根源。

4. 检查注解处理器配置有效性 #

你之前尝试的-proc:only未生效，可能是因为未明确指定注解处理器依赖。在上述分阶段配置中添加dependencies块，明确引入Dagger和Immutables的编译器依赖，确保注解处理器能被javac识别并执行。

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