AbstractProcessor修改方法失效：JCTree变更未同步至.class文件

1. 初始化核心工具类 #

必须在处理器的init方法中获取TreeMaker和Names实例——这两个是修改语法树的核心依赖，不能在process方法中临时创建：

private TreeMaker treeMaker;
private Names names;

@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
    super.init(processingEnv);
    this.treeMaker = TreeMaker.instance(processingEnv);
    this.names = Names.instance(processingEnv);
}

同时确保处理器的注解配置正确：

• @SupportedAnnotationTypes指定@OnTransform的全类名
• @SupportedSourceVersion返回SourceVersion.latestSupported()，保证适配当前编译版本

2. 正确替换方法体节点 #

不能直接修改原method.body的内容，必须用TreeMaker构建包含try-finally的新JCBlock，再替换原方法的body节点。示例代码：

// 假设已获取到标注@OnTransform的JCMethodDecl节点
JCBlock originalBody = (JCBlock) method.body;

// 构建finally块的执行语句（示例：打印日志）
JCStatement finallyLog = treeMaker.Exec(
    treeMaker.Apply(
        List.nil(),
        treeMaker.Select(treeMaker.Ident(names.fromString("System")), names.fromString("out")),
        List.of(treeMaker.Literal("finally block executed"))
    )
);
JCBlock finallyBlock = treeMaker.Block(0, List.of(finallyLog));

// 构建完整的try-finally块
JCStatement tryFinallyBlock = treeMaker.Try(originalBody, List.nil(), finallyBlock);

// 替换原方法的body
method.body = treeMaker.Block(0, List.of(tryFinallyBlock));

3. 确保操作的是编译器上下文的语法树 #

调试时看到内存中节点变更但字节码没更新，大概率是修改了语法树副本。必须通过Trees工具获取当前编译上下文的节点：

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

    Set<? extends Element> targetElements = roundEnv.getElementsAnnotatedWith(OnTransform.class);
    Trees trees = Trees.instance(processingEnv);

    for (Element elem : targetElements) {
        if (elem.getKind() != ElementKind.METHOD) continue;
        // 获取编译器正在处理的方法语法树路径
        TreePath path = trees.getPath(elem);
        JCMethodDecl methodNode = (JCMethodDecl) path.getLeaf();
        // 执行上述方法体替换逻辑...
    }
    return true;
}

4. 验证处理器触发与编译阶段 #

• 在process方法中加打印语句，确认处理器被正确触发：System.out.println("Processing " + targetElements.size() + " annotated methods");
• 编译时必须显式指定处理器：javac -processor com.your.package.TransformProcessor TargetClass.java，IDE中需在注解处理器配置里添加你的处理器类路径
• 确认@OnTransform的保留期是SOURCE，且处理器运行在字节码生成前的SOURCE阶段

5. 排查语法树修改的有效性 #

修改后可以通过com.sun.source.util.JavacTask将修改后的语法树打印出来，验证是否生效：

JavacTask task = (JavacTask) processingEnv.getJavaCompiler().getTask(
    null, processingEnv.getJavaFileManager(), null, null, null,
    processingEnv.getJavaFileManager().getJavaFileObjects("TargetClass.java")
);
task.parse();
Iterable<? extends CompilationUnitTree> trees = task.parse();
// 遍历trees打印语法树结构，确认try-finally已添加

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