IntelliJ IDEA远程debug调试Tomcat

配置Tomcat

在catalina.bat中添加以下配置：

windows版

SET CATALINA_OPTS=-server -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005

centos版

declare -x CATALINA_OPTS="-server -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"

Ubuntu版

CATALINA_OPTS=-server -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005

参数说明

1. -Xdebug：启用调试特性
2. -Xrunjdwp：启用JDWP实现
3. transport：JPDA front-end和back-end之间的传输方法。dt_socket表示使用套接字传输
4. address：JVM在5005端口上监听请求
5. server：y表示启动的JVM是被调试者。如果为n，则表示启动的JVM是调试器
6. suspend：y表示启动的JVM会暂停等待，直到调试器连接上

相关知识

  JPDA顾名思义，JPDA为Java平台上的调试器定义了一个标准的体系结构。该体系结构包括3个主要组成部分：JVM
TI、JDI和JDWP。

JVM TI的全称是Java Virtual Machine Tool
Interface，它定义了JVM为了支持调试而必须提供的功能及相应的访问接口。这些访问接口是以本地语言的形式提供的，由JVM（比如Sun公司的HotSpot
VM）负责实现。

  不过，JVM TI只是JVM提供的一系列函数，调试器（特别是远程的调试器）如何调用呢？其实啊，JVM
TI的直接客户端并不是调试器，而是一个称为“JPDA back-end”的东东。这个东东应该是属于JVM的一部分，在SUN
JRE的bin目录下可以找到jdwp.dll(jdwp.so)的库文件，这就是JPDA back-end的实现。按我理解，JPDA
back-end提供了各种访问方式（共享内存，Socket），通过这些方式接收调试器的请求，然后调用JVM TI接口。

  JDI的全称是Java Debug Interface，它定义了访问JVM
TI接口的高层API，以纯Java语言提供，由JDK实现（在Sun
JDK的tools.jar可以找到）。调试器直接使用JDI来实现调试的功能。与JPDA back-end相对应，JDI实现的角色就是JPDA
front-end。

  JDWP的全称是Java Debug Wire Protocol，它定义了JPDA front-end和JPDA
back-end之间通讯信息的二进制格式。这里的通讯信息主要包括两种：调试器发送给JVM的请求信息和JVM发送给调试器的调试信息。

  总结一下，调试器 调用JDK提供的JDI实现 (JPDA front-end)，经由JDWP协议
，和JVM自带的JPDA back-end(jdwp.dll, jdwp.so, …)进行通讯。JPDA back-end
通过调用JVM TI接口 ，从而获知调试信息，或发送控制命令。然后，JPDA back-end 将调试信息或命令执行结果，通过JDWP协议
，返回给调试器 。

配置IDEA

端口号不一定是5005，但必须和刚才配置Tomcat的相同

点击debug按钮

出现连接到远程信息表示成功了，可以打断点调试了

常见失败原因

• debug的时候，发现断点无效，提示Line numbers info is not available in class
  造成原因：编译的时候没有开启debug模式
  解决办法：
  For plain javac add -g
  For ant add debug="true" to the javac task
  For Maven, the default configuration for the maven-compiler-plugin adds debug information, so the explicit setting not to has to be undone

参考

• Tomcat debug模式启动
• linux下tomcat开启远程调试
• Intellij IDEA Remote Debug invalid breakpoints