Java使用ClassFileTransformer报重复类定义LinkageError如何修复

触发attempted duplicate class definition错误的核心原因是你在ClassFileTransformer的转换逻辑中主动调用了Class.forName(cn)加载目标类。
ClassFileTransformer的触发时机是类正处于类加载器加载流程中、尚未完成类定义的阶段。此时类还没被类加载器标记为「已加载」，你主动调用Class.forName会触发同一个类加载器对同一个类发起第二次加载请求，相当于类定义流程还未结束，又触发了同个类的defineClass流程，直接抛出LinkageError。
除此之外你当前的实现还有两个隐性问题：

• 类转换阶段主动触发类加载，非常容易触发类加载器死锁、类初始化顺序错乱，是Java Agent开发的典型禁忌
• 无修改场景下重新读写字节码返回新数组，会额外触发JVM的类校验逻辑，平白增加启动开销

• 移除转换逻辑中所有主动调用Class.forName加载目标类的代码
  如果你需要获取被转换类的Class实例，不要在类首次加载的转换流程中获取：
  • 首次加载触发transform时，方法入参的classBeingRedefined本身就是null，JVM不允许你在这个阶段拿到未完成定义的类实例
  • 类加载完成后可通过Instrumentation.getAllLoadedClasses()遍历获取对应类实例；如果是手动触发retransformClasses/redefineClasses的重转换场景，直接使用方法入参传入的classBeingRedefined对象即可，不需要主动加载
• 修正转换返回逻辑：如果不需要对当前类做字节码修改，直接返回null即可。JVM约定transform方法返回null时代表不修改类，直接使用原始字节码走原有加载流程，不会触发额外的类定义逻辑；只有你实际修改了字节码时，才返回修改后的byte数组
• 增加类过滤逻辑：提前跳过不需要处理的类（比如JDK核心类、Agent自身的类），减少不必要的转换开销，降低类加载冲突概率

@Override
public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined,
                        ProtectionDomain protectionDomain, byte[] classfileBuffer) {
    // 空字节码直接返回null，不做处理
    if (classfileBuffer == null || classfileBuffer.length == 0) {
        return null;
    }
    // 按需过滤不需要处理的类，示例只处理Minecraft相关类
    if (className == null || !className.startsWith("net/minecraft/")) {
        return null;
    }

    try {
        ClassReader reader = new ClassReader(classfileBuffer);
        ClassNode node = new ClassNode();
        reader.accept(node, 0);
        
        // 此处插入你的字节码修改逻辑
        // 无修改直接返回null，有修改再通过ClassWriter生成新字节码返回
        return null;
    } catch (Exception e) {
        System.out.println("Transform class " + className + " failed:");
        e.printStackTrace();
        // 转换失败返回null，不打断原有类加载流程
        return null;
    }
}

补充说明：ASM做字节码分析修改时，完全基于传入的classfileBuffer字节数组即可完成所有操作，不需要把类加载到JVM中。如果你的自附加逻辑注册Transformer时目标类已经被加载，先调用Instrumentation.addTransformer(transformer, true)开启重转换支持，再手动调用instrumentation.retransformClasses(目标类实例)触发重转换即可，不需要提前主动加载类。

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