自定义注解处理器编译时遭遇ClassCastException：com.sun.proxy代理类无法转换为JavacProcessingEnvironment求助

这个问题的核心是你拿到的ProcessingEnvironment实例被动态代理包装了，直接强转成JavacProcessingEnvironment自然会失败。下面是几个可行的解决方案，按优先级排序：

1. 添加代理解包逻辑，获取真实的JavacProcessingEnvironment实例 #

直接强转前，先通过反射解开代理包装，拿到真实的目标对象。可以写一个工具方法来处理：

private static JavacProcessingEnvironment unwrapProcessingEnv(ProcessingEnvironment env) {
    // 先判断是不是已经是目标类型
    if (env instanceof JavacProcessingEnvironment) {
        return (JavacProcessingEnvironment) env;
    }

    // 处理JDK动态代理的情况
    if (Proxy.isProxyClass(env.getClass())) {
        try {
            // 获取代理的InvocationHandler
            Field handlerField = Proxy.class.getDeclaredField("h");
            handlerField.setAccessible(true);
            InvocationHandler handler = (InvocationHandler) handlerField.get(env);

            // 针对JavacProcessingEnvironment的内部代理类处理
            if (handler.getClass().getName().equals("com.sun.tools.javac.processing.JavacProcessingEnvironment$ProcessorState")) {
                Field targetField = handler.getClass().getDeclaredField("this$0");
                targetField.setAccessible(true);
                return (JavacProcessingEnvironment) targetField.get(handler);
            }

            // 通用的代理目标获取逻辑（适配其他可能的代理实现）
            Method getTargetMethod = handler.getClass().getMethod("getTarget");
            if (getTargetMethod != null) {
                Object target = getTargetMethod.invoke(handler);
                if (target instanceof JavacProcessingEnvironment) {
                    return (JavacProcessingEnvironment) target;
                }
            }
        } catch (NoSuchFieldException | IllegalAccessException | NoSuchMethodException | InvocationTargetException e) {
            throw new RuntimeException("Failed to unwrap ProcessingEnvironment proxy", e);
        }
    }

    throw new IllegalArgumentException("Cannot convert ProcessingEnvironment to JavacProcessingEnvironment");
}

然后在你的init方法中替换强转逻辑：

@Override
public void init(ProcessingEnvironment processingEnvironment) {
    this.processingEnv = processingEnvironment;
    // 用解包方法代替直接强转
    JavacProcessingEnvironment javacProcessingEnvironment = unwrapProcessingEnv(processingEnvironment);
    this.trees = Trees.instance(processingEnvironment);
    TreeMaker treeMaker = TreeMaker.instance(javacProcessingEnvironment.getContext());
    visitor = new HelloTranslator(javacProcessingEnvironment, treeMaker);
}

2. 确保Maven编译器插件的参数生效 #

你的compilerArgs配置看起来没问题，但maven-compiler-plugin默认不会fork新的JVM进程，导致这些--add-opens/--add-exports参数可能没有传递到实际的编译进程中。添加<fork>true</fork>配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.0</version>
  <configuration>
    <source>11</source>
    <target>11</target>
    <fork>true</fork> <!-- 关键：启用fork确保参数传递到编译JVM -->
    <compilerArgs>
      <!-- 你的现有参数 -->
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED</arg>
      <arg>--add-opens=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED</arg>
      <arg>--add-exports=jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED</arg>
    </compilerArgs>
  </configuration>
</plugin>

3. 升级Maven编译器插件版本 #

你当前使用的3.8.0版本是2018年的老版本，对JDK11的兼容性不如新版本。建议升级到3.11.0或更高版本（比如3.12.1），新版本不仅修复了很多兼容性问题，还优化了参数传递逻辑：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.12.1</version>
  <!-- 其他配置不变 -->
</plugin>

4. 确认项目的依赖/模块化配置 #

如果你的项目是模块化项目（带有module-info.java），需要确保添加对jdk.compiler模块的依赖：

module your.annotation.processor.module {
    requires jdk.compiler;
    // 其他requires声明
}

如果是非模块化项目，确保你的依赖中包含了JDK tools相关的类（虽然JDK9+已经模块化，但某些场景下显式依赖能解决类加载问题）：

<dependency>
    <groupId>com.sun</groupId>
    <artifactId>tools</artifactId>
    <version>11.0.15</version>
    <scope>system</scope>
    <systemPath>${java.home}/lib/tools.jar</systemPath>
</dependency>

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