Maven项目编译失败：Javac未运行注解处理器排查求助

结合你已经做的详细排查，我梳理了几个可能遗漏的关键环节，你可以逐一验证：

1. 检查Maven编译插件的注解处理器路径配置 #

Maven 3.5+之后，maven-compiler-plugin推荐通过annotationProcessorPaths显式配置注解处理器依赖，而不是将其放在普通的<dependencies>中。如果你的项目之前依赖旧版Maven，或者pom.xml里没配置这个，新环境的Maven可能无法自动识别处理器。

你可以检查pom.xml中是否有类似配置，若没有则添加：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <!-- 建议使用3.8.1及以上版本，支持annotationProcessorPaths -->
      <version>3.8.1</version>
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <annotationProcessorPaths>
          <!-- 添加上所有需要的注解处理器依赖 -->
          <path>
            <groupId>org.immutables</groupId>
            <artifactId>value</artifactId>
            <version>2.3.9</version>
          </path>
          <path>
            <groupId>com.google.dagger</groupId>
            <artifactId>dagger-compiler</artifactId>
            <version>2.4</version>
          </path>
          <path>
            <groupId>com.google.auto.factory</groupId>
            <artifactId>auto-factory</artifactId>
            <version>1.0-beta3</version>
          </path>
        </annotationProcessorPaths>
      </configuration>
    </plugin>
  </plugins>
</build>

配置完成后执行mvn clean compile，查看target/generated-sources/annotations是否生成源码。

2. 验证注解处理器依赖的完整性 #

你提到依赖中包含META-INF/services/javax.annotation.processing.Processor条目，但需要确认对应的处理器jar包是否完整下载：

• 检查$HOME/.m2/repository/org/immutables/processor/2.3.9/是否存在（若你的版本需要单独引入processor包）
• 打开org.immutables.value-2.3.9.jar，确认内部是否包含org.immutables.processor.ProxyProcessor类
  如果依赖缺失或损坏，执行mvn clean install -U强制更新依赖。

3. 检查源代码中的注解使用情况 #

当你用-proc:only指定处理器时，如果源代码中没有使用该处理器对应的注解（比如Immutables的@Value.Immutable），处理器不会生成任何类，也不会输出处理轮次日志。你需要：

• 确认目标源代码（比如Main.java或其他相关类）中是否正确使用了org.immutables.value.Value等注解
• 检查注解的包路径是否正确，有没有拼写错误（比如误写成com.immutables.value.Value）

4. 排查Maven全局配置与环境变量 #

新系统的Maven全局配置可能影响编译：

• 检查~/.m2/settings.xml是否有特殊配置（比如镜像、profile）导致依赖加载异常
• 查看环境变量：执行echo $JAVA_TOOL_OPTIONS和echo $MAVEN_OPTS，确认没有添加-proc:none或其他干扰注解处理的参数

5. 检查target目录权限与清理情况 #

High Sierra的权限控制可能更严格，你可以：

• 手动删除整个target目录（避免mvn clean可能残留的文件）
• 执行mkdir -p target/generated-sources/annotations手动创建目录，赋予读写权限
• 重新执行mvn compile，观察目录是否生成源码

6. 验证Maven版本兼容性 #

不同版本的Maven对注解处理器的处理逻辑可能有差异：

• 执行mvn -v查看当前Maven版本，对比你之前项目使用的版本
• 如果版本差异较大，尝试切换到旧版本Maven（比如3.3.x）重新编译

内容的提问来源于stack exchange，提问作者Rolf W.