Java Agent修改方法访问权限报错：class redefinition failed问题求助

核心结论：Java Agent的类重定义（redefine）不能修改方法访问修饰符 #

JVM的Instrumentation.redefineClasses() API有严格限制，不允许修改类的结构信息，包括但不限于方法的访问修饰符、方法签名、字段定义等，仅能修改方法体的字节码逻辑。你遇到的java.lang.UnsupportedOperationException就是因违反该规则导致的。

修复方案 #

根据目标类是否已完成加载，分两种场景处理：

1. 目标类未被加载：使用类转换（Class Transformation） #

在类加载阶段通过ClassFileTransformer修改字节码，此阶段JVM尚未完成类的加载验证，允许修改方法修饰符。

修改你的Agent代码如下：

public static void premain(String args, Instrumentation instrumentation) {
    final ClassPool pool = ClassPool.getDefault();
    pool.appendClassPath(new LoaderClassPath(Thread.currentThread().getContextClassLoader()));

    instrumentation.addTransformer(new ClassFileTransformer() {
        @Override
        public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
            // 只处理目标类，注意className是"/"分隔格式，例如com/example/TargetClass
            if (!"com/example/TargetClass".equals(className)) {
                return null;
            }
            try {
                CtClass ctClass = pool.get(className.replace("/", "."));
                CtMethod targetMethod = ctClass.getDeclaredMethod("targetMethod");
                // 修改方法访问修饰符为PUBLIC
                targetMethod.setModifiers(Modifier.PUBLIC);
                byte[] modifiedBytes = ctClass.toBytecode();
                ctClass.detach(); // 释放CtClass避免内存泄漏
                return modifiedBytes;
            } catch (Exception e) {
                e.printStackTrace();
                return null;
            }
        }
    }, true); // true表示允许重转换，可选配置
}

你的MANIFEST配置无需修改，已正确声明Can-Redefine-Classes和Can-Retransform-Classes。

2. 目标类已被加载：曲线救国（新增代理方法） #

若类已完成加载，无法直接修改原有方法的修饰符，可新增一个public的代理方法，内部调用原方法：

public static void premain(String args, Instrumentation instrumentation) throws Exception {
    final ClassPool pool = ClassPool.getDefault();
    pool.appendClassPath(new LoaderClassPath(Thread.currentThread().getContextClassLoader()));

    CtClass ctClass = pool.get("com.example.TargetClass");
    CtMethod originalMethod = ctClass.getDeclaredMethod("targetMethod");
    // 复制原方法作为代理方法
    CtMethod proxyMethod = CtNewMethod.copy(originalMethod, ctClass, null);
    proxyMethod.setName("publicTargetMethod");
    proxyMethod.setModifiers(Modifier.PUBLIC);
    // 代理方法内部调用原方法
    proxyMethod.setBody("{ return " + originalMethod.getName() + "($$); }");
    ctClass.addMethod(proxyMethod);

    byte[] modifiedBytes = ctClass.toBytecode();
    ctClass.detach();

    // 重定义类，仅新增方法不修改原有结构，符合JVM规则
    instrumentation.redefineClasses(new ClassDefinition(Class.forName("com.example.TargetClass"), modifiedBytes));
}

其他运行时修改字节码的方式 #

除Javassist外，常用工具还有：

• ASM：直接操作字节码指令，性能高、灵活性强，适合复杂字节码修改场景，但学习成本较高。
• Byte Buddy：API简洁易用，封装了JVM字节码操作细节，支持类重定义与转换，对JVM规则兼容性更好，是很多框架的动态增强方案首选。
• CGLIB：基于ASM实现，主要用于生成子类进行动态代理，也可修改字节码，但更多聚焦于方法增强而非通用字节码修改。

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