Java Agent无法拦截/修改java.lang.StringBuilder的原因咨询

这个问题我之前也碰到过，核心原因和Java的类加载机制以及Java Agent的默认行为有关，咱们一步步拆解：

1. Core Classes Are Loaded Before Your Agent Runs #

java.lang.String、java.lang.StringBuilder这类核心类是由Bootstrap ClassLoader（JVM最底层的类加载器）负责加载的，而且它们会在JVM启动的极早期阶段就被加载完成——甚至早于你的Java Agent的premain方法执行。默认情况下，Java Agent的ClassFileTransformer只会对后续加载的类生效，所以它根本看不到这些已经提前加载好的核心类。

2. Missing Manifest Configurations #

要修改已经加载的类，你的Agent必须获得JVM的授权。如果你的Agent的MANIFEST.MF文件里没有声明以下两个属性，就无法触发已加载类的重新转换：

Can-Redefine-Classes: true
Can-Retransform-Classes: true

这两个参数是允许Agent重新定义、重新转换类的必要前提。

3. Java 9+ Module System Restrictions #

从Java 9开始，模块化系统（JPMS）对核心模块（比如java.base）进行了强封装。默认情况下，外部代码（包括你的Agent）没有权限修改java.lang包下的类。如果你的JDK版本是9或以上，这个权限限制会直接导致Agent无法拦截这些核心类。

4. Incorrect Class Name Matching in Transformer #

在ClassFileTransformer的transform方法中，类名的格式是斜杠分隔的（比如java/lang/StringBuilder），而不是我们日常用的点分隔格式（java.lang.StringBuilder）。很多人会在这里犯错误，导致匹配不到目标类。

Fix Steps to Make It Work #

Step 1: Update Your Agent's MANIFEST.MF #

确保MANIFEST.MF包含以下内容（替换为你的Agent主类路径）：

Premain-Class: com.youragent.package.YourAgentMain
Can-Redefine-Classes: true
Can-Retransform-Classes: true

打包Agent JAR时要确保这个配置被正确包含。

Step 2: Explicitly Retransform Core Classes in premain #

在你的Agent主类的premain方法中，注册转换器后，主动触发对目标核心类的重新转换：

public static void premain(String agentArgs, Instrumentation inst) throws Exception {
    // 注册转换器，第二个参数设为true表示支持重新转换
    inst.addTransformer(new YourCustomTransformer(), true);
    // 主动触发对String和StringBuilder的重新转换
    inst.retransformClasses(String.class, StringBuilder.class);
}

Step 3: Add JPMS Permissions (Java 9+) #

如果使用Java 9或以上版本，在启动命令中添加模块化参数，开放对java.lang包的访问权限：

java --add-opens java.base/java.lang=ALL-UNNAMED -javaagent:agentclass/bugfixagent.jar -cp classes com.test.Test

Step 4: Fix Class Name Matching in Transformer #

修改你的transform方法，使用斜杠分隔的类名进行判断：

@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined,
                        ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
    // 匹配斜杠格式的类名
    if ("java/lang/StringBuilder".equals(className) || "java/lang/String".equals(className)) {
        // 在这里执行你的字节码修改逻辑
        return modifyBytecode(classfileBuffer);
    }
    return null; // 返回null表示不修改该类
}

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