如何使用ASM字节码修改实现的Java Agent生成的新增字段？

我正在借助《Java字节码操作指南（ASM）》学习ASM的工作原理，按照教程通过Java Agent的Instrumentation类为ClassX类添加了一个额外的静态字段，以下是Instrumentation类的简化逻辑：

public static void premain(String agentArgs, Instrumentation inst) {
  inst.addTransformer(new ClassFileTransformer() {
    @Override
    public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, final byte[] buffer) {
      if (className.equals("ClassX")) {
        var reader = new ClassReader(buffer); // 注：原代码中bytes应为buffer
        var writer = new ClassWriter(reader, 0);
        var visitor = new ClassVisitor(Opcodes.ASM9, writer) { // 补充ASM版本与父Visitor逻辑
          private boolean isFieldPresent = false;

          @Override
          public FieldVisitor visitField(int access, String name, String descriptor, String signature, Object value) {
            if (name.equals("aNewBooleanField")) {
              isFieldPresent = true;
            }
            return super.visitField(access, name, descriptor, signature, value);
          }

          @Override
          public void visitEnd() {
            if (!isFieldPresent) {
              var fv = super.visitField(ACC_PUBLIC + ACC_STATIC, "aNewBooleanField", "Z", null, true);
              if (fv != null) fv.visitEnd();
            }
            super.visitEnd();
          }
        };
        reader.accept(visitor, 0);
        return writer.toByteArray();
      }
      return buffer;
    }
  });
}

我已用Maven打包该ASM代码，但不知如何使用。我原本期望能像这样访问字段：

public static void main(String[] args) {
    System.out.println(ClassX.aNewBooleanField);
}

但这显然无法编译，因为编译器不知道这个新增字段。我尝试按照教程添加Java Agent参数，但仍不理解其中逻辑：编译器怎么能感知运行时的Agent进程呢？

我的核心问题是：如何使用经ASM字节码修改后的代码？

注：Java Agent参数示例：-javaagent:"/<path>/.m2/repository/org/example/try-asm/1.0-SNAPSHOT/try-asm-1.0-SNAPSHOT.jar"

核心逻辑澄清 #

Java Agent是运行时修改类字节码，而编译器只认源代码中的类定义，两者完全独立。编译器不需要感知Agent的存在，你要做的是绕开编译期的类型检查，或者提前做兼容处理。

可行的使用方式 #

1. 反射访问（最直接）

运行时ClassX的字节码已经被修改，字段真实存在，用反射可以直接读取：

public static void main(String[] args) throws NoSuchFieldException, IllegalAccessException {
    Field field = ClassX.class.getField("aNewBooleanField");
    // 静态字段不需要实例，传入null即可
    System.out.println(field.get(null));
}

反射的本质是直接读取JVM中类的运行时元数据，不受编译期代码定义的限制。

2. 提前做编译期兼容（可选）

如果想避免反射，且有权修改ClassX的源代码，可以提前添加一个空的静态字段或者访问方法，比如：

public class ClassX {
    // 预留字段，运行时ASM会覆盖或补充定义
    public static boolean aNewBooleanField;
}

这样编译时就能直接引用，运行时ASM修改后的字段会生效。如果无法修改原ClassX代码，这个方法不适用。

正确的运行步骤 #

1. 确保Agent包的MANIFEST配置正确
   Maven打包时，需要在MANIFEST.MF中指定Premain类，否则JVM无法识别Agent。可以在pom.xml中添加插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifestEntries>
                        <Premain-Class>com.yourpackage.YourAgentClass</Premain-Class>
                        <Can-Redefine-Classes>true</Can-Redefine-Classes>
                    </manifestEntries>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 运行主程序时加载Agent
   用以下命令启动程序，JVM会先执行Agent的premain方法修改ClassX的字节码，再加载主类运行：

java -javaagent:/完整路径/try-asm-1.0-SNAPSHOT.jar com.yourpackage.YourMainClass

内容的提问来源于stack exchange，提问作者Jacob van Lingen