查看原文
其他

高效开发:IntelliJ IDEA天天用,这些Debug技巧你都知道?

Java精选 2022-08-09

击上方蓝色“Java精选”,选择“设为星标”

技术文章第一时间送达!

作者:aneasystonehttps://www.aneasystone.com/
在软件开发的过程中,可以说调试是一项基本技能。调试的英文单词为debug,顾名思义,就是去除bug的意思。俗话说的好,编程就是制造bug的过程,所以 debug的重要性毋庸置疑,如果能熟练掌握调试技能,也就可以很快的定位出代码中的bug。要知道,看的懂代码不一定写的出代码,写的出代码不一定能调试好代码,为了能写出没有bug的代码,我们必须得掌握一些基本的调试技巧。

工欲善其事,必先利其器。无论你的开发工具是IntelliJ IDEA还是Eclipse,调试器都是标配。在遇到有问题的程序时,合理的利用调试器的跟踪和断点技巧,可以很快的定位出问题原因。虽然说合理利用日志也可以方便定位线上问题,但是日志并不是调试工具,不要在开发环境把System.out.println当作调试手段,掌握调试器自带的调试技能才是正道。

实战 IDEA 调试技巧

如果你是做Java开发的,相信你不会没有听过IntelliJ IDEA,和大多数Java开发者一样,我一开始的时候也是用Eclipse来进行开发,但是自从换了IDEA之后,就再也离不开它了,彻底变成了IDEA的忠实粉丝(不好意思,打一波广告)。
不得不说,JetBrains这家来自捷克的软件公司真的是良心企业,所出产品皆是精品,除了IDEA,还有WebStormPhpStormPyCharm等,风格都是很类似的,一些类似的快捷键包括调试技巧也是通用的。
打开 IDEA 的调试面板,如下图所示,可以大致的将其分成五个部分:
1)单步跟踪
2)断点管理
3)求值表达式
4)堆栈和线程
5)变量观察
1、单步跟踪
说起调试,估计很多人第一反应就是对程序进行一步一步的跟踪分析,其实IDEA 提供了很多快捷键来帮助我们跟踪程序,大抵可以列出下面几个技巧:
Show Execution Point
调试时往往需要浏览代码,对代码进行分析,有时候在浏览若干个源文件之后就找不到当前执行到哪了,可能很多人会使用Navigate Back来返回,虽然也可以返回去,但可能需要点多次返回按钮,相对来说使用这个技巧快速定位到当前调试器正在执行的代码行要更简便。
Step Over
这是最基本的单步命令,每一次都是执行一行代码,如果该行代码有方法会直接跳过,可以说真的是一步一个脚印。
Step In / Force Step In
Step Over会跳过方法的执行,可以观察方法的返回值,但如果需要进到方法里面,观察方法的执行细节,则需要使用Step In命令了。另外,Step In命令也会跳过jdk自带的系统方法,如果要跟踪系统方法的执行细节,需要使用Force Step In命令。
关于单步的时候忽略哪些系统方法,可以在IDEA的配置项

Settings -> Build, Execution, Deployment -> Debugger -> Stepping

中进行配置,如下图所示。
Step Out
当使用Step In命令跟踪到一个方法的内部时,如果发现自己不想继续调这个方法了,可以直接把这个方法执行完,并停在调用该方法的下一行位置,这就是Step Out命令。
Drop to Frame
这一招可以说是调试器的一大杀器。在单步调试的时候,如果由于粗心导致单步过了头,没有看到关键代码的执行情况,譬如想定位下某个中间变量的值,这个时候如果能回到那行关键代码再执行一遍就好了,Drop to Frame就提供了我们这个能力,它可以回到方法调用的地方(跟Step Out不一样,Step Out是回到方法调用的下一行),让我们可以再调试一次这个方法,这一次可不要再粗心了。
Drop to frame的原理其实也非常简单,顾名思义,它将堆栈的最上面一个栈帧删除(也就是当前正在执行的方法),让程序回到上一个栈帧(父方法),可以想见,这只会恢复堆栈中的局部变量,全局变量无法恢复,如果方法中有对全局变量进行操作的地方,是没有办法再来一遍的。
Run to Cursor / Force Run to Cursor
这两个命令在需要临时断点时非常有用,譬如已经知道自己想分析哪一行代码了,但又不需要下很多无谓的断点,可以直接使用该命令执行到某行,Force Run to Cursor甚至可以无视所有断点,直接到达我们想分析的地方。
2、断点管理
断点是调试器的基础功能之一,可以让程序暂停在需要的地方,帮助我们进行分析程序的运行过程。在IDEA中断点管理如下图所示,合理使用断点技巧可以快速让程序停在我们想停的地方:
可以将断点分成两种类型:行断点指的是在特定的某行代码上暂停下来,而全局断点是在某个条件满足时停下来,并不限于停在固定的某一行,譬如当出现异常时暂停程序。
1)行断点
>Suspend (All / Thread)
>Condition
条件断点。这应该也是每个使用调试器的开发者都应该掌握的一个技巧,当遇到遍历比较大的List或Map对象时,譬如有1000个Person对象,你不可能每个对象都调一遍,你可能只想在person.name = 'Zhangsan'的时候让断点断下来,就可以使用条件断点,如下图所示:
>Log message to console
>Evaluate and log
当看到上面的Suspend这个选项的时候有的人可能会感到奇怪,我下一个断点不就是为了让程序停下来吗?还需要这个选项干什么?是不是有点多余?难道你下个断点却不想让程序停下来?
在发现Evaluate and log这个技巧之前,我对这一点也感觉很奇怪,直到有一天我突然发现Suspend Off + Evaluate and log的配合真的是太有用了。前面有讲过,不要把System.out.println当作调试手段,因为你完全可以用这个技巧来打印所有你想打印的信息,而不需要修改你的源代码。
>Remove once hit
一次性断点。上面介绍的Run to Cursor就是一次性断点的例子。
>Instance filters
>Class filters
>Pass count
这几个我用的不是很多,但应该也是非常有用的技巧可以先记下来。在IDEA里每个对象都有一个实例ID,Instance filters就是用于当断点处代码所处的实例和设定ID匹配则断下来。Pass count则是在断点执行到第几次的时候暂停下来。
2)全局断点
>Exception breakpoints
>Method breakpoints
>Field watchpoints
个人感觉这几个技巧都不是很常用,感兴趣的同学自己实验一把吧。
3、求值表达式
在一堆单步跟踪的按钮旁边,有一个不显眼的按钮,这个按钮就是 “求值表达式”。它在调试的时候很有用,可以查看某个变量的值,也可以计算某个表达式的值,甚至还可以计算自己的一段代码的值,这分别对应下面两种不同的模式:
1)表达式模式(Expression Mode)
2)代码片段模式(Code Fragment Mode)
这两个模式类似于 Eclipse 里面的Expression ViewDisplay View。在Display View里也可以编写一段代码来执行,确实非常强大,但是要注意的是,这里只能写代码片段,不能自定义方法,如下图:
4、堆栈和线程
这个没什么好说的,一个视图可以查看当前的所有线程,另一个视图可以查看当前的函数堆栈。在线程视图里可以进行Thread dump,分析每个线程当前正在做什么;堆栈视图里可以切换栈帧,结合右边的变量观察区,可以方便的查看每个函数里的局部变量和参数。
1)线程视图
2)堆栈视图
5、变量观察
变量区和观察区可以合并在一起,也可以分开来显示(如下图所示),我比较喜欢分开来显示,这样局部变量、参数以及静态变量显示在变量区,要观察的表达式显示在观察区。
观察区类似于求值表达式中的Expression mode,你可以添加需要观察的表达式,在调试的时候可以实时的看到表达式的值。变量区的内容相对是固定的,随着左边的栈帧调整,值也会变得不同。在这里还可以修改变量原有的值。

使用 jdb 命令行调试

相信很多人都听过gdb,这可以说是调试界的鼻祖,以前在学习C/C++ 的时候,就是使用它来调试程序的。和gdb一样,jdb也是一个命令行版的调试器,用于调试Java程序。而且jdb不需要安装下载,它是JDK自带的工具(在JDK的bin目录中,JRE中没有)。
每研究一项新技术,我总是会看看有没有命令行版本的工具可以替代,在命令行下进行操作给人一种踏实的感觉,每一个指令,每一个参数,都清清楚楚的摆在那里,这相比较于图形界面的工具,可以学习更深层的知识,而不是把技术细节隐藏在图形界面之后,你可以发现命令行下的每一个参数,每一个配置,都是可以学习的点。
1、jdb 基本命令
在jdb中调试Java程序如下图所示,直接使用jdb Test命令加载程序即可。
运行完jdb Test命令之后,程序这时并没有运行起来,而是停在那里等待进一步的命令。这个时候我们可以想好在哪里下个断点,譬如在main()函数处下个断点,然后再使用run命令运行程序:
> stop in Test.main
正在延迟断点Test.main。
将在加载类后设置。
> run
运行Test
设置未捕获的 java.lang.Throwable
设置延迟的未捕获的 java.lang.Throwable
>
VM 已启动:设置延迟的断点:Test.main
可以看出在执行run命令之前,程序都还没有开始运行,这个时候的断点叫做“延迟断点”,当程序真正运行起来时,也就是JVM启动的时候,才将断点设置上。除了stop in Class.Method命令,还可以使用stop at Class:LineNumber的方式来设置断点。
main[1] stop at Test:25
在jdb中下断点,就没有IDEA中那么多名堂了,什么条件断点,什么Instance filters 都不支持,只能乖乖的一步一步来。在断点处,可以使用list命令查看断点附近的代码,或者用step命令单步执行,print或者dump打印变量或表达式的值,locals命令查看当前方法中的所有变量,cont命令继续执行代码。
还有一些其他的命令就不多做介绍了,可以使用help查看所有的命令清单,或者参考jdb的官方文档。
2、探索 class 文件结构
在jdb中调试Java程序时,有可能源代码文件和class文件不在一起,这个时候需要指定源码位置:
# jdb -sourcepath path/to/source Test
如果不指定源码位置,在使用list命令时会提示找不到源码文件,如果真的没有源码文件,那么在jdb里完全就是瞎调了。我们知道Java代码在执行的时候,是以字节码的形式运行在JVM里的,可以猜测到,class文件中必然有着和源码相关联的一些信息,类似于C/C++语言的obj文件一样,要不然list命令怎么可以显示出当前正在执行的代码是哪一行呢?
我们可以使用开源的jclasslib软件查看class文件里的内容,一个标准的class文件包含了下面这些信息:

基本信息
常量池
接口
属性
父类
字段
方法
   >Code 属性
        >行号属性
        >局部变量表

如下图所示,其中最重要的一个部分就是Code属性,Code属性下面有行号属性LineNumberTable,这个LineNumberTable就是调试器用来关联字节码和源代码的关键。关于class文件,可以参考:

http://ginobefunny.com/post/deep_in_jvm_notes_part4/

题外话:没有源码时如何调试?
如果没有源码,虽然在jdb里也可以用step来单步,但是没有办法显示当前正在运行的代码,这简直就是盲调。这个时候只能使用字节码调试工具了,常见的字节码调试器有:Bytecode VisualizerJSwat DebuggerJava ByteCode Debugger (JBCD) 等等,参考:

https://reverseengineering.stackexchange.com/questions/7991/java-class-bytecode-debugger

关于远程调试
通过对jdb的学习,我们已经越来越接近Java调试器的真相了,但是还差最后一步。让我们先看看Java程序在IDEA里是如何被调试的,如果你有很强的好奇心,那么在IDEA里调试程序的时候可能已经发现了下面的秘密:
或者在调试 tomcat 的时候,也有类似的一串仿佛魔咒一般的参数:
这串魔咒般的参数像下面这样,一旦你理解了这串参数,你也就打破了 Java 调试器的魔咒,然后才能认识到 Java 调试器真正的面目:
"C:\Program Files\Java\jdk1.8.0_111\bin\java" -agentlib:jdwp=transport=dt_socket,address=127.0.0.1:20060,suspend=y,server=n Foo
Connected to the target VM, address: '127.0.0.1:20060', transport: 'socket'
这里面有两个关键点:
1)Java程序在运行的时候带着-agentlib参数,这个参数用于指示JVM在启动时额外加载的动态库文件,-agentlib参数和-javaagent不一样,这个库文件应该是由 C/C++编写的原生程序(JNI),类似于这里的jdwp,在Windows上对应一个jdwp.dll库文件,在Linux上对应jdwp.so文件。那么这个jdwp库文件到底是做什么的呢?它后面的一串参数又是什么意思?
2)jdwp的参数里貌似提到了socket,并有address=127.0.0.1:20060这样的IP地址和端口号,而且下面的Connected to the target VM也似乎表示调试器连接到了这么一个网络地址,那么这个地址到底是什么呢?由于这里是本地调试,所以IP地址是127.0.0.1,那么如果是远程调试的话,是不是这里也是支持的呢?
在IDEA的Run/Debug Configuration配置页面,你也可以添加一个远程调试,界面如下图,可以发现上面那串魔咒参数又出现了:

在真正开始远程调试之前,我们不妨带着这些疑问,来学习Java调试器的基本原理。

Java 调试原理及 JPDA 简介

在武侠世界里,天下武功可以分为两种:一种讲究招式新奇,出招时能出其不意,善于利用兵器的特性和自身的高妙手法攻敌不备;另一种讲究内功心法,就算是最最普通的招式,结合自身的深厚内力,出招时也能有雷霆之势。其实在技术的世界里,武功也可以分为两种:技巧和原理。
上面讲的那么多,无论你是掌握了IDEA的所有调试技巧也好,还是记熟了jdb的所有命令也好,都只是招式上的变化,万变不离其宗,我们接下来就看看调试器的内功心法。
1、JPDA
我们知道,Java程序都是运行在JVM上的,我们要调试Java程序,事实上就需要向JVM请求当前运行态的状态,并对JVM发出一定的指令,或者接受JVM的回调。为了实现Java程序的调试,JVM提供了一整套用于调试的工具和接口,这套接口合在一起我们就把它叫做JPDA(Java Platform Debugger Architecture,Java平台调试体系)。
这个体系为开发人员提供了一整套用于调试Java程序的API,是一套用于开发Java 调试工具的接口和协议。本质上说,它是我们通向虚拟机,考察虚拟机运行态的一个通道,一套工具。
JPDA 由三个相对独立的层次共同组成,而且规定了它们三者之间的交互方式。这三个层次由低到高分别是Java虚拟机工具接口(JVMTI),Java调试线协议(JDWP)以及Java调试接口(JDI),如下图所示(图片来自IBM developerWorks):
这三个模块把调试过程分解成几个很自然的概念:调试者(debugger)和被调试者(debuggee),以及他们中间的通信器。被调试者运行于我们想调试的 Java 虚拟机之上,它可以通过 JVMTI 这个标准接口,监控当前虚拟机的信息;调试者定义了用户可使用的调试接口,通过这些接口,用户可以对被调试虚拟机发送调试命令,同时调试者接受并显示调试结果。
在调试者和被调试者之间,调试命令和调试结果,都是通过JDWP的通讯协议传输的。所有的命令被封装成JDWP命令包,通过传输层发送给被调试者,被调试者接收到JDWP命令包后,解析这个命令并转化为JVMTI的调用,在被调试者上运行。类似的,JVMTI 的运行结果,被格式化成JDWP数据包,发送给调试者并返回给 JDI调用。而调试器开发人员就是通过JDI得到数据,发出指令。
详细的内容,可以参考

https://www.ibm.com/developerworks/cn/java/j-lo-jpda1/index.html

2、Connectors & Transport
到这里,我们已经知道了jdwp是调试器和被调试程序之间的一种通信协议。不过命令行参数 
-agentlib:jdwp=transport=dt_socket,address=127.0.0.1:20060,suspend=y,server=n
中的jdwp貌似还不止于此。
事实上,这个地方上jdwp.dll库文件把JDIJDWPJVMTI三部分串联成了一个整体,它不仅能调用本地JVMTI提供的调试能力,还实现了JDWP通信协议来满足JVMTIJDI之间的通信。
想要完全理解这串参数的意思,我们还需要学习两个概念:Connectors(连接器)和Transport(传输)
常见的连接器有下面5种,它指的是JDWP建立连接的方式:

Socket-attaching connector
Shared-memory attaching connector
Socket-listening connector
Shared-memory listening connector
Command-line launching connector

其中attaching connectorlistening connector的区别在于到底是调试器作为服务端,还是被调试程序作为服务端。
传输指的是JDWP的通信方式,一旦调试器和被调试程序之间建立起了连接,他们之间就需要开始通信,目前有两种通信方式:Socket(套接字)和Shared-memory(共享内存,只用在Windows平台)。
3、实战远程调试
通过上面的学习我们了解到,Java调试器和被调试程序是以C/S架构的形式运行的,首先必须有一端以服务器的形式启动起来,然后另一段以客户端连接上去。如果被调试程序以服务端运行,必须加上下面的命令行参数:
# java -agentlib:jdwp=transport=dt_socket,server=y,address=5005 Test
# java -agentlib:jdwp=transport=dt_shmem,server=y,address=javadebug Test
第一句是以socket通信方式来启动程序,第二句是以共享内存的方式来启动程序,socket方式需要指定一个端口号,调试器通过该端口号来连接它,共享内存方式需要指定一个连接名,而不是端口号。
在程序运行起来之后,可以使用jdb的 -attach参数将调试器和被调试程序连接起来:
# jdb -attach 5005
# jdb -attach javadebug
在 Windows 平台上,第一条命令会报这样的错:
java.io.IOException: shmemBase_attach failed: The system cannot find the file specified
这是由于jdb -attach使用系统默认的传输来建立连接,而在Windows上默认的传输是 共享内存 。要想在Windows上使用socket方式来连接,要使用jdb -connect命令,只是命令的参数在写法上不太好记忆:
# jdb -connect com.sun.jdi.SocketAttach:hostname=localhost,port=5005
# jdb -connect com.sun.jdi.SharedMemoryAttach:name=javadebug
如果反过来,想让调试器以服务端运行,执行下面的命令:
# jdb -listen javadebug
然后 Java 程序通过下面的参数来连接调试器:
# java -agentlib:jdwp=transport=dt_shmem,address=javadebug, suspend=y Test
# java -agentlib:jdwp=transport=dt_socket,address=127.0.0.1:5005,suspend=y,server=n
最后我们再回过头来看一看IDEA打印出来的这串魔咒参数,可以大胆的猜测,IDEA在调试的时候,首先以服务器形式启动调试器,并在20060端口监听,然后 Java程序以socket通信方式连接该端口,并将JVM暂停等待调试。
"C:\Program Files\Java\jdk1.8.0_111\bin\java" -agentlib:jdwp=transport=dt_socket,address=127.0.0.1:20060,suspend=y,server=n Foo
Connected to the target VM, address: '127.0.0.1:20060', transport: 'socket'

如果在IDEA下进行远程调试,可以参考IBM developerWorks上的另一篇与调试相关的主题:使用Eclipse远程调试Java应用程序。

总结

这篇文章首先介绍了IDEA的一些常用调试技巧,然后通过使用jdb进行Java程序的调试,学习了jdb的常用命令,最后通过远程调试引出调试器原理的话题,对JPDAJVMTIJDWPJDI等概念有了一个初步的认识。从招式到心法,由技巧到原理,逐步揭开了Java调试器的神秘面纱。
对于开发人员来说,如果只懂招式,只会一些奇淫技巧,那么他只是把工具用得更得心应手而已,很难在技术上得到质的突破;而如果只懂心法,只沉浸于基本原理和理论,那么他只能做一个眼高手低的学院派,空有满腹大道理却无用武之地。我们更应该内外兼修,把招式和心法结合起来,融会贯通,方能成正果。

最后的最后,关于调试的话题不得不补充一句:调试程序是一个费时费力的过程,一旦需要调试来定位问题,说明代码的逻辑性和清晰性有问题,最好的代码是不需要调试的。所以,少一点调试,多一点单元测试,多一点重构,将代码写的更清晰才是最好的编程方式。

番外篇:关于调试器的测不准效应

在量子物理学中,有一个名词叫 测不准原理,又叫不确定性原理,讲的是粒子的位置与动量不可同时被确定,位置的不确定性越小,则动量的不确定性越大,反之亦然。
说白点就是,你如果要很准确的测量粒子的位置,那么就不能准确的测量粒子的动量;如果要很准确的测量粒子的动量,那么粒子的位置就测不准;正是由于测量本身,会导致系统受影响。
把这个现象套在调试器领域里,也有着类似的效果。由于调试器本身的干扰,程序已经不是以前的程序了。所以问题来了,在调试器下运行出来的结果,真的可信吗?
下面是我想出来的一个有趣的例子,假设我们在第4行下一个断点,程序最后输出结果会是什么呢?
关注我,回复“Java”免费领取视频教程和资料

加入专业技术讨论QQ群:248148860 ^^

往期精选

Spring 和 Spring Boot 之间到底有什么区别?

33种IDEA配置,让你的IDEA有飞一般的感觉

面试必问:给我说一下Spring MVC拦截器的原理?

经典面试:Spring Boot中的条件注解底层是如何实现的?

为什么Spring Boot构造的jar包能直接运行?

分布式缓存Redis集群搭建,一次性帮你搞定!

2020年Java多线程与并发系列22道高频面试题解析

面试官问:说说你对 Java 中锁以及 sychronized 实现机制的理解

Spring 常用注解大全,快看看哪些你还不知道?

MyBatis 框架中动态 SQL 语句常用标签的基本用法,值得一看!

35 个 Java 代码优化的小技巧,你知道几个?

搞懂这10个 Maven 问题,带你“吊打”面试官!

我就知道你“在看”!

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存