使用JDI无阻塞在线调试Java应用
本文介绍了如何利用Java JDI技术在不暂停或重启应用的情况下进行远程调试。通过设置远程调式端口，引用JDI库，连接JVM，并在特定代码行设置断点，实时获取上下文变量信息，实现在线调试Java应用。
平时我们进行程序开发时经常需要通过Debug的方式查看代码运行到某一行时的上下文变量信息，以便进行代码调式分析。但是在生产环境下，正在线上运行的程序如果发现有问题需要进行调式，如果手动SocketRemote连接并设置断点并跟踪断点信息，会造成程序阻塞，影响线上正在运行的业务。本文将通过Java JDI技术，介绍如何在程序正常运行的情况下，通过Java代码在不阻塞程序正常运行的情况下获取某一个代码行执行时的上下文变量信息，可以动态打断点并输出断点信息。
在介绍JDI之前，首先看一下传统的Socket Remote Debug
使用IDE进行Debug，可以使用IDE中内嵌的Tomcat进行调式，或使用Socket Remote方式调式，例如在Intellij IDEA中可以参照如下方式为程序设置远程调式端口：
启动上面的程序。之后设置进行debug的代码，如下设置要debug远程的地址和端口：
配置好后，按照如下方法启动debug即可：
什么时JDI
JPDA(Java Platform Debugger Architecture) 是 Java 平台调试体系结构的缩写，通过 JPDA 提供的API，开发人员可以方便灵活的搭建 Java 调试应用程序。JPDA 主要由三个部分组成：Java 虚拟机工具接口（JVMTI），Java调试线协议（JDWP），以及 Java 调试接口（JDI）。JDI（Java Debug Interface）是 JPDA三层模块中最高层的接口，定义了调试器（Debugger）所需要的一些调试接口。基于这些接口，调试器可以及时地了解目标虚拟机的状态，例如查看目标虚拟机上有哪些类和实例等。另外，调试者还可以控制目标虚拟机的执行，例如挂起和恢复目标虚拟机上的线程，设置断点等。
使用JDI编写代码进行远程调式
1. 被调式程序设置调式端口
被调式程序启动时添加允许远程调式的启动参数：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005
2. 引用类库
每个Java JDK都有自己的JDI接口实现，标准的Oracle JDK的JDI接口放在jdk/lib/tools.jar中，因此写代码时首先需要引入这个jar。
3. 连接远程JVM
/**
* 连接远程JVM
* @param hostname
* @param port
* @return
* @throws Exception
* @author 李文锴
*/
private VirtualMachine connectVirtualMachine(String hostname, Integer port) throws Exception{
VirtualMachineManager vmm = Bootstrap.virtualMachineManager();
List<AttachingConnector> connectors = vmm.attachingConnectors();
SocketAttachingConnector sac = null;
for(AttachingConnector ac : connectors){
if(ac instanceof SocketAttachingConnector){
sac = (SocketAttachingConnector) ac;
}
}
if (sac == null) throw new Exception("未找到可用的SocketAttachingConnector连接器");
Map<String, Connector.Argument> arguments = sac.defaultArguments();
arguments.get("hostname").setValue(hostname);
arguments.get("port").setValue(String.valueOf(port));
return sac.attach(arguments);
}4. 标记断点
如下代码，需指定要标记断点的类和行数。注意一个类或者行可能会有多个线程来调用，但是示例代码中为了简单考虑只获取了第一个调用线程的结果，即get(0)。此外，给行打断点时，所设置的行数必须是有效代码的行。例如如果所设置的行是回车没有Java代码，则会抛出异常。
/**
* 标记断点
* @param clazz
* @param line
* @throws Exception
* @author 李文锴
不同的事件需要被分类地添加到不同的事件集合（EventSet）中，事件集是事件发送的最小单位。事件集一旦创建出来，便不可再被修改。生成的事件将被依次地加入到目标虚拟机的事件队列（EventQueue）中。然后，EventQueue将这些事件集以“先进先出”策略依次地发送到调试器端。EventQueue 负责管理来自目标虚拟机的事件，一个被调试的目标虚拟机上有且仅有一个EventQueue实例。特别地，随着一次事件集的发送，目标虚拟机上可能会有一部分的线程因此而被挂起。如果一直不恢复这些线程，有可能会导致目标虚拟机挂机。因此，在处理好一个事件集中的事件后，建议调用事件集的resume() 方法，恢复所有可能被挂起的线程。
5. 跟踪断点
如下代码，获取事件时需要根据事件类型进行相应的处理：
/**
* 跟踪断点
* @throws Exception
* @author 李文锴
6. 获取断点信息
如下代码：
private void logBreadkpoint(BreakpointEvent event) throws Exception{
ThreadReference threadReference = event.thread();
StackFrame stackFrame = threadReference.frame(0);
logger.log("<<================<< " + stackFrame.location()
+ " / " + stackFrame.location().method().name()
+ " >>================>>");
logger.log("[方法参数]");
List<Value> argsList = stackFrame.getArgumentValues();
for (Value arg : argsList){
logger.log(arg.type().name() + " = " + parseValue(arg));
}
logger.log("[变量信息]");
try {
List<LocalVariable> varList = stackFrame.visibleVariables();
for(LocalVariable localVariable : varList){
logLocalVariable(stackFrame, localVariable);
}
} catch (AbsentInformationException e) {
throw new RuntimeException(e);
}
}
private void logLocalVariable(StackFrame stackFrame, LocalVariable localVariable){
StringBuilder out = new StringBuilder(localVariable.name());
if(localVariable.isArgument()){
out.append("[*]");
}
out.append(" = ");
out.append(parseValue(stackFrame.getValue(localVariable)));
logger.log(out.toString());
}7. 解析获取的变量
private String parseValue(Value value){
StringBuilder out = new StringBuilder();
if(value instanceof StringReference || value instanceof IntegerValue || value instanceof BooleanValue
|| value instanceof ByteValue || value instanceof CharValue || value instanceof ShortValue
|| value instanceof LongValue || value instanceof FloatValue || value instanceof DoubleValue){
out.append(value);
}else if(value instanceof ObjectReference){
ObjectReference obj = (ObjectReference) value;
String type = obj.referenceType().name();
if("java.lang.Integer".equals(type) || "java.lang.Boolean".equals(type) || "java.lang.Float".equals(type)
|| "java.lang.Double".equals(type) || "java.lang.Long".equals(type) || "java.lang.Byte".equals(type)
|| "java.lang.Character".equals(type)){
Field f = obj.referenceType().fieldByName("value");
out.append(obj.getValue(f));
}else if("java.util.Date".equals(type)) {
Field field = obj.referenceType().fieldByName("fastTime");
Date date = new Date(Long.parseLong("" + obj.getValue(field)));
out.append(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(date));
}else if(value instanceof ArrayReference){
ArrayReference ar = (ArrayReference) value;
List<Value> values = ar.getValues();
out.append("[");
for (int i = 0; i < values.size(); i++){
if( i != 0 ) out.append(" ,");
out.append(parseValue(values.get(i)));
}
out.append("]");
}else {
out.append(type);
}
}
return out.toString();
}
8. 测试：启动目标程序
测试目标类如下，计划在System.out.println行打断点，为了演示方便通过Thread.sleep添加暂停事件，以便启动调式程序：
public class Test {
public static void main(String[] args) throws Exception {
test("hello", 100);
}
private static void test(String a, Integer b) throws Exception{
Thread.sleep(10*1000);
Boolean isOk = false;
Date date = new Date();
System.out.println("over");
}
}9. 测试：执行debug程序
代码如下：
public class Debug {
public static void main(String[] args) throws Exception{
DebugRemoteJava drj = new DebugRemoteJava("127.0.0.1", 5005);
drj.markBreakpoint(Test.class, 18);
drj.traceBreakpoint();
}
}
扫一扫
506
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
