解决 Agent JAR loaded but agent failed to initialize

寂夜了无痕

已于 2024-09-04 14:04:35 修改

阅读量5.3k

点赞数

分类专栏： java 文章标签： java agent agent动态替换class agent failed

于 2021-12-13 10:06:43 首次发布

本文链接：https://blog.csdn.net/a15835774652/article/details/121898857

版权

java 专栏收录该内容

92 篇文章 0 订阅

订阅专栏

前言

在Java应用中，使用Java Agent进行类转换是一种强大的技术，它允许我们在运行时动态地修改类的行为。然而，在使用Agent进行类转换时，我们可能会遇到各种问题。本文将详细探讨一个典型的错误及其解决方案，帮助开发者更有效地使用Java Agent。

错误分析

在使用agent进行动态替换class时遇到错误，遇到了以下错误：

com.sun.tools.attach.AgentInitializationException: Agent JAR loaded but agent failed to initialize
	at sun.tools.attach.HotSpotVirtualMachine.loadAgent(HotSpotVirtualMachine.java:121)
	at com.sun.tools.attach.VirtualMachine.loadAgent(VirtualMachine.java:540)
	at com.style.note.base.instrument.Attache.main(Attache.java:18)
Disconnected from the target VM, address: '127.0.0.1:54359', transport: 'socket'```

这个错误通常表明Agent JAR文件已成功加载，但Agent初始化失败。通过进一步分析，我们发现问题出在类名的指定上。

业务代码分析

我们的源码如下：

public class CustomTransformer implements ClassFileTransformer {

    @Override
    public byte[] transform(ClassLoader loader, String className, Class<?> classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer) throws IllegalClassFormatException {
        ClassPool classPool = ClassPool.getDefault();
        try {
            // 错误的包名
            CtClass ctClass = classPool.get("com.style.note.base.Instrument.Base");
            CtMethod method = ctClass.getDeclaredMethod("process");
            method.insertBefore("{System.out.println(\"start\");}");
            method.insertAfter("{System.out.println(\"end \");}");
            return ctClass.toBytecode();
        } catch (NotFoundException | CannotCompileException | IOException e) {
            e.printStackTrace();
        }
        return null;
    }
}

问题定位

我们发现，CtClass ctClass = classPool.get(“com.style.note.base.Instrument.Base”); 这一行中的包名是错误的。正确的包名应该是 com.style.note.base.instrument.Base。
instrument 包名的首字母应该是小写的

解决方案

更新包名：

将错误的包名 com.style.note.base.Instrument.Base 更新为正确的包名 com.style.note.base.instrument.Base。

检查MANIFEST.MF文件：

确保MANIFEST.MF文件中的类名和Agent类名完全匹配。例如：

Premain-Class: com.style.note.base.instrument.Agent

确保agentmain方法签名正确：

agentmain 方法的签名必须严格遵循以下格式：

public static void agentmain(String args, 
					Instrumentation instrumentation){
}

注意参数类型，args 应为 String 而不是 String[]。

其他导致加载失败的原因

MANIFEST.MF文件错误：
确保MANIFEST.MF文件中的类名完全正确，没有拼写错误。

Agent类的方法签名：
确保 agentmain 方法的签名完全正确，特别是参数类型。
agent类的方法 agentmain 一定要正确

 public class Agent {
	 /**
     * agentmain
     *
     * @param args  args  注意参数为String 而不是String数组
     * @param instrumentation instrumentation
     */
    public static void agentmain(String args, Instrumentation instrumentation) {
       //....
    }
}