为什么已加载的JavaAgent在Tomcat中ClassFileTransformer的transform方法不执行

问题排查及修复方案 #

1. 核心错误：transform方法空指针导致转换器被JVM禁用 #

类第一次被JVM加载时，transform方法的classBeingRedefined参数为null，只有类触发重转换（retransform）场景时该参数才会赋值。你直接调用classBeingRedefined.getName()会立刻抛出空指针异常，JVM遇到transform方法抛出未捕获异常时会直接禁用当前转换器，这是你看不到任何输出的最直接原因。

2. 转换器未开启重转换能力 #

你调用instrumentation.addTransformer(interceptingClassTransformer)时默认第二个参数为false，代表转换器仅能处理后续新加载的类，无法处理Agent加载前就已经被JVM加载的类。JDBC驱动大概率在Agent启动前就已经被启动类加载器或Tomcat父类加载器加载，自然不会触发转换逻辑。

3. 类加载器隔离问题 #

Tomcat采用分层类加载器架构，如果JDBC驱动放在Web应用的WEB-INF/lib目录下，会由Web应用独有的类加载器加载，若代码中额外过滤了非系统类加载器的类，也会导致转换逻辑不触发。

修复步骤 #

第一步：修改premain注册逻辑，开启重转换能力

public static void premain(String agentArgs, Instrumentation instrumentation) throws InstantiationException {
    System.out.println("========================== JDBC Leak Detector Agent ==========================");
    // 第二个参数传true，允许转换器处理已加载的类
    MyCT interceptingClassTransformer = new MyCT();
    instrumentation.addTransformer(interceptingClassTransformer, true);
    
    // 主动触发已加载Driver实现类的重转换
    if (instrumentation.isRetransformClassesSupported()) {
        Class<?>[] loadedClasses = instrumentation.getAllLoadedClasses();
        for (Class<?> clazz : loadedClasses) {
            if (java.sql.Driver.class.isAssignableFrom(clazz) && !clazz.equals(java.sql.Driver.class)) {
                try {
                    instrumentation.retransformClasses(clazz);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }
}

第二步：修改transform方法，避免空指针，新增字节码判断逻辑

类第一次加载时还未完成类定义，无法通过反射判断接口，需要通过字节码解析工具（如ASM、Javassist）读取类的接口信息：

@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined,
        ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
    // className为斜杠分隔格式，如com/mysql/cj/jdbc/Driver
    System.out.println("Processing class: " + className);
    // 处理重转换场景（类已加载，可用反射判断接口）
    if (classBeingRedefined != null) {
        for(Class<?> i : classBeingRedefined.getInterfaces()) {
            if(i.getName().equals("java.sql.Driver")) {
                System.out.println("Driver implementation found: " + classBeingRedefined.getName());
                // 此处插入字节码修改逻辑，修改connect方法插入自定义逻辑
            }
        }
    } 
    // 处理首次加载场景，用字节码工具解析接口
    else {
        try {
            // 示例用ASM解析类的接口信息，需引入ASM依赖
            org.objectweb.asm.ClassReader cr = new org.objectweb.asm.ClassReader(classfileBuffer);
            String[] interfaces = cr.getInterfaces();
            for (String itf : interfaces) {
                if (itf.equals("java/sql/Driver")) {
                    System.out.println("Driver implementation found: " + className.replace('/', '.'));
                    // 此处插入字节码修改逻辑
                }
            }
        } catch (Exception ignore) {
            // 字节码解析失败直接跳过
        }
    }
    return classfileBuffer;
}

第三步：补充Agent manifest配置

在Agent Jar的META-INF/MANIFEST.MF中添加以下配置，开启类重定义权限：

Premain-Class: org.wxt.xtools.agents.JDBCLeakDetector
Can-Redefine-Classes: true
Can-Retransform-Classes: true

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