使用ByteBuddy AgentBuilder添加的方法Advice未被调用的问题咨询

1. 重转换能力的前置条件不满足 #

你虽然启用了RETRANSFORMATION策略，但JVM对已加载类的字节码修改有强制约束：

• 目标类my.functions.CassandraFunctions必须被标记为支持重转换。若类加载阶段未开启该权限，JVM会直接拒绝字节码修改，且默认不抛出可见异常。
• 重转换场景下，字节码修改不允许新增类字段、注入额外的类方法。若Advice转换器自动在目标类中生成辅助结构，会直接被JVM拦截静默失败。

2. Advice类的类加载器配置错误 #

当前代码中指定的类加载器是Class.class.getClassLoader()，即引导类加载器。但CassandraFunctionsAdvice是由Agent的独立类加载器加载的，不在引导类加载器的搜索路径内。
当触发已加载类的重转换时，目标类的类加载器无法定位到指定的Advice类，转换逻辑会直接跳过，Advice自然不会触发。

3. 方法匹配规则精度不足 #

当前匹配规则仅通过方法名loadObjectByKey做匹配，既没有限定方法的静态修饰符、参数类型，也没有过滤同名重载方法，极易出现匹配失效。
针对静态方法的重转换场景，未开启内联模式的Advice会因为需要修改方法的调用栈结构，被JVM判定为非法的重转换操作。

4. 转换过程的异常被静默吞掉 #

installOn方法未配置错误监听，ByteBuddy在重转换失败时默认隐藏底层异常，开发者无法定位失败原因，只能观察到Advice不触发的现象。

protected void instrument(boolean t) {
    Instrumentation instrument = null;
    try {
        Class<?> c = Class.forName("my.loader.InstrumentLoader");
        java.lang.reflect.Method m = c.getMethod("getInstrument");
        instrument = (Instrumentation) m.invoke(null);
    } catch (Exception e) {
        e.printStackTrace();
    }
    if(instrument == null) {
        return;
    }

    String clzName = CassandraFunctionsAdvice.class.getName();
    new AgentBuilder.Default()
        .with(AgentBuilder.RedefinitionStrategy.RETRANSFORMATION)
        // 强制使用符合JVM重转换规则的类型策略，禁止注入额外类结构
        .with(AgentBuilder.TypeStrategy.Default.REDEFINE)
        .type(ElementMatchers.named("my.functions.CassandraFunctions"))
        .transform(
            new AgentBuilder.Transformer.ForAdvice()
                // 替换为实际加载Advice类的类加载器，不要用引导类加载器
                .include(CassandraFunctionsAdvice.class.getClassLoader())
                // 提升方法匹配精度，排除重载方法的干扰
                .advice(
                    ElementMatchers.isStatic()
                        .and(ElementMatchers.named("loadObjectByKey"))
                        .and(ElementMatchers.takesArguments(String.class)),
                    clzName
                )
        )
        // 显式注册错误监听，打印重转换阶段的异常，避免静默失败
        .installOn(instrument, new AgentBuilder.Listener.Compound(
            AgentBuilder.Listener.StreamWriting.toSystemOut()
        ));
}

额外注意：如果CassandraFunctions是由自定义类加载器加载的，需要在类加载定义阶段开启重转换权限，否则JVM依然会拒绝字节码修改。

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