如何使用JVMTI与JNI访问并修改Java局部变量

SetLocalFloat 是JVMTI中用于修改指定线程栈帧内float类型局部变量的API，下面逐个说明各参数的获取方式：

参数详解与获取方法 #

• jvmtiEnv* env
  这是JVMTI的核心环境句柄，获取渠道主要有两个：

  • Agent初始化阶段：Agent_OnLoad 或 Agent_OnAttach 函数的参数会直接传入该指针，只需保存下来后续复用即可。
  • JVMTI回调逻辑中：比如断点触发、方法进入/退出的回调函数里，参数会包含当前有效的jvmtiEnv*。

• jthread thread
  目标线程的引用，获取方式分两种场景：

  • 被动获取：如果是在某个线程的回调（比如断点触发）中执行操作，回调参数会直接提供该线程的jthread实例。
  • 主动获取：调用env->GetAllThreads枚举JVM内所有线程，再根据线程名称、ID等筛选目标；也可以通过JNI的GetCurrentThread()获取当前执行代码的线程（JVMTI与JNI的jthread类型兼容）。

• jint depth
  栈帧深度，0代表当前正在执行的最顶层栈帧（即当前方法的栈帧），数值越大对应调用链中更早的方法栈帧。
  若不确定目标栈帧的深度，可调用env->GetStackTrace获取目标线程的栈帧列表，匹配目标方法后确定对应的depth值。

• jint slot
  局部变量在栈帧中的槽位编号，需先获取目标方法的局部变量表：

  1. 先拿到目标方法的jmethodID（可通过JNI的GetMethodID或JVMTI的相关API获取）。
  2. 调用env->GetLocalVariableTable传入该jmethodID，返回的局部变量信息中包含每个变量的slot编号、类型签名等。

  注意：float类型变量占用1个槽位，long和double类型会占用连续2个槽位，需注意区分。

• jfloat value
  要设置的目标float值，直接传入符合C语言float类型的数值即可（例如2.718f）。

额外说明 #

你之前使用的ByteBuddy是字节码层面的修改工具，更适合类加载阶段修改方法逻辑；而JVMTI是JVM提供的底层调试接口，支持运行时直接操作栈帧、局部变量等内部状态，更适配这类动态修改运行中变量的需求。

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