前言

对于分布式系统的调试不知道大家有什么好的方法。对于我来说，在知道远程调试这个方法之前就是在代码中打各种log，然后重新部署，上线，调试，这样比较费时，有什么更好的办法呢？

有时候，本地调试的时候没有问题，打包部署到测试环境的时候却爆出一堆莫名其妙的问题，这时该怎么办呢？

偶然间了解到的远程调试的功能简直是一把利器，能够非常好地解决上述问题，还不赶紧来了解一下？

远程调试

使用特定JVM参数运行服务端代码

要让远程服务器运行的代码支持远程调试，则启动的时候必须加上特定的JVM参数，这些参数是：

 

-Xdebug -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=${debug_port}

其中的${debug_port}是用户自定义的，为debug端口，本例以5555端口为例。

本人在这里踩过一个坑，必须要说一下。在使用公司内部的自动化部署平台NDP进行应用部署时，该平台号称支持远程调试，只需要在某个配置页面配置一下调试端口号（没有填写任何IP相关的信息），并且重新发布一下应用即可。事实上也可以发现，上述JVM参数中唯一可变的就是${debug_port}。但是实际在本地连接时发现却始终连不上5555 的调试端口，仔细排查才发现，下面截取了NDP发布的应用所有JVM参数列表中与远程调试相关的JVM启动参数如下：

 

-Xdebug -Xrunjdwp:transport=dt_socket,suspend=n,server=y,address=127.0.0.1:5555

将address设置为127.0.0.1:5555，表示将调试端口限制为本地访问，远程无法访问，这个应该是NDP平台的一个bug，我们在自己设置JVM的启动参数时也需要格外注意。

如果只是临时调试，在端口号前面不要加上限制访问的IP地址，调试完成之后，将上述JVM参数去除掉之后重新发布下，防范开放远程调试端口可能带来的安全风险。

本地连接远程服务器debug端口

打开Intellij IDEA，在顶部靠右的地方选择”Edit Configurations…”，进去之后点击+号，选择”Remote”，按照下图的只是填写红框内的内容，其中Name填写名称，这里为remote webserver，host为远程代码运行的机器的ip/hostname，port为上一步指定的debug_port，本例是5555。然后点击Apply，最后点击OK即可

 

本地IDEA启动debug模式

现在在上一步选择”Edit Configurations…”的下拉框的位置选择上一步创建的remote webserver，然后点击右边的debug按钮(长的像臭虫那个)，看控制台日志，如果出现类似“Connected to the target VM, address: ‘xx.xx.xx.xx:5555’, transport: ‘socket’”的字样，就表示连接成功过了。我这里实际显示的内容如下：

 

Connected to the target VM, address: '10.185.0.192:15555', transport: 'socket'

设置断点，开始调试

远程debug模式已经开启，现在可以在需要调试的代码中打断点了，比如：

 

 

如图中所示，如果断点内有√，则表示选取的断点正确。

现在在本地发送一个到远程服务器的请求，看本地控制台的bug界面，划到debugger这个标签，可以看到当前远程服务的内部状态（各种变量）已经全部显示出来了，并且在刚才设置了断点的地方，也显示了该行的变量值。

 

 

备注：需要注意的是，用于远程debug的代码必须与远程部署的代码完全一致，不能发生任何的修改，否则打上的断点将无法命中，切记切记。

远程调试，特别是当你在本地开发的时候，你需要调试服务器上的程序时，远程调试就显得非常有用。

  JAVA 支持调试功能，本身提供了一个简单的调试工具JDB，支持设置断点及线程级的调试同时，不同的JVM通过接口的协议联系，本地的Java文件在远程JVM建立联系和通信。此篇是Intellij IDEA远程调试的教程汇总和原理解释，知其然而又知其所以然。

 
本机Intellij IDEA远程调试配置
 

 

1，打开Inteliij IDEA，顶部菜单栏选择Run-> Edit Configurations，进入下图的运行/调试配置界面。

2，点击左上角'+'号，选择Remote。分别填写右侧三个红框中的参数：Name，Host（想要指定的远程调试端口）。

3，点击界面右下角应用按钮即可。

二，服务器端开启调试模式，增加JVM启动参数，以支持远程调试
  服务器端的catalina.sh文件，在Tomcat的安装目录下，复制到本地，进行编辑，在第一行添加参数配置如下，完成后粘贴回去。

文本：

CATALINA_OPTS="-Xdebug  -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8089"
　 

配置添加之后，重启tomcat即可生效（shutdown.sh /startup.sh）。到此，开始远程调试。

 

三， Intellij IDEA 启动远程调用
最后，打开IDEA，程序上打上断点，运行模式选远程，点击运行。调用服务器端运行的系统程序，系统自动进入断点

4，为什么可以进行远程调试，背后的原理是什么？
   首先，了解下的Java程序的执行过程- 分为以下几个步骤：Java的文件 - - 编译生成的类文件（class文件） - - JVM加载类文件 - - JVM运行类字节码文件 - - JVM翻译器翻译成各个机器认识的不同的机器码。

远程调试原理
   众所周知，Java 程序是运行在Java 虚拟机（JVM ）上的，具有良好跨平台性，是因为Java程序统一以字节码的形式在JVM中运行，不同平台的虚拟机都统一使用这种相同的程序存储格式。因为都是类字节码文件，只要本地代码和远程服务器上的类文件相同，两个JVM通过调试协议进行通信（例如通过插座在同一个端口进行通信），另外需要注意的时，被调试的服务器需要开启调试模式，服务器端的代码和本地代码必须保持一致，则会造成断点无法进入的问题。

<code>Java</code>的调试器架构
 

 

 

   这个架构其实质还是JVM，只要确保本地的Java的源代码与目标应用程序一致，本地的Java的的的的源码就可以用插座连接到远端的JVM，进而执行调试。因此，在这种插座连接模式（下文介绍）下，本地只需要有源码，本地的Java的应用程序根本不用启动。

传输方式，默认为Socket ;

套接字：MACOS，Linux的系统使用此种传输方式;

 

共享内存：WINDOWS系统使用此种传输方式。

调试模式，默认为Attach ;

 

Attach ：此种模式下，调试服务端（被调试远程运行的机器）启动一个端口等待我们（调试客户端）去连接;

Socket ：此种模式下，是我们（调试客户端）去监听一个端口，当调试服务端准备好了，就会进行连接。

 

配置属性说明补充
1.idea的的服务的开启调试模式设置详细说明，

文本：

CATALINA_OPTS="-Xdebug  -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8089"
 

2.各参数解释：
-Xdebug：通知JVM工作在调试模式下
-Xrunjdwp：通知JVM使用（java debug wire protocol）来运行调试环境。参数同时有一系列的调试选项：
<code>session</code>：指定了调试数据的传送方式，dt_socket是指用SOCKET模式，另外dt_shmem指用共享内存方式，其中dt_shmem只适用于窗口平台.server  参数是指是否支持在服务器模式的虚拟机中。
onthrow：指明当产生该类型的异常时，JVM就会中断下来，进行调式该参数任选。
<code>release</code>：指明当JVM被中断下来时，执行的可执行程序该参数可选
<code>suspend</code><：指明：是否在调试客户端建立起来后，再执行 JVM。
onuncaught（= y或n）指明出现未捕获的异常后，是否中断JVM的执行。
3.IDEA设置远程属性说明，以下为谷歌翻译