Idea线上联调的原理及步骤

1、为什么要远程联调

当我们的代码在线上/测试环境运行出现异常需要进行问题定位时，之前的传统做法是：查看异常日志，根据日志定位到出错代码，然后再根据相关参数及异常信息进行推断。但是很多异常问题需要更细致的进行debug才能够更精准的去定位和解决，这种情况下，我们希望能够像在本地调试一样去debug线上/测试环境的代码，这样可以大大提升bug修复的效率。IDEA远程调试为我们提供了解决方案，像运行本地代码一样调试远程主机上的程序，以排查远程程序的BUG或代码执行流程。

2、远程联调的原理

本地远程调试服务器端的代码原理： 本地和服务器端建立一个socket连接监听，当客户端访问服务器的时候，服务器端会先去问本地idea有没有断点，如果有会停在当前断点，如果没有就返回给客户端。

2.1、理论基础

JPDA（Java Platform Debugger Architecture是Java平台调试体系结构的缩写。由3个规范组成，分别是JVMTI(JVM Tool Interface)，JDWP(Java Debug Wire Protocol)，JDI(Java Debug Interface)。

• JVMTI定义了虚拟机应该提供的调试服务，包括调试信息（Information譬如栈信息）、调试行为（Action譬如客户端设置一个断点）和通知（Notification譬如到达某个断点时通知客户端），该接口由虚拟机实现者提供实现，并结合在虚拟机中
• JDWP定义调试服务和调试器之间的通信，包括定义调试信息格式和调试请求机制
• JDI在语言的高层次上定义了调试者可以使用的调试接口以能方便地与远程的调试服务进行交互，Java语言实现，调试器实现者可直接使用该接口访问虚拟机调试服务。

2.2、远程调试的分类

• 主动连接调试：服务端配置监控端口，本地IDE连接远程监听端口进行调试，一般调试问题用这种方式；
• 被动连接调试：本地IDE监听某端口，等待远程连接本地端口。一般用于远程服务启动不了，启动时连接到本地调试分析。

3、主动连接调试

3.1、远程服务中开启debug服务

3.1.1、SpringBoot项目

# 命令行添加选项，并重启，注意新参数必须在 -jar 之前
java -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005 -jar springbootfirst.jar

3.1.2、tomcat

# 启动脚本中添加选项，并重启
##  方法1、sudo vim $CATALINA_HOME/bin/catalina.sh
JAVA_OPTS="$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005"
## 方法2、使用sed命令
sed -i '$a\JAVA_OPTS=\"$JAVA_OPTS -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000\"' /opt/huawei/fce/apps/platform/bin/setenv.sh

3.2、IDEA中指定Debug服务器

• 点击主窗口菜单Run / Edit Configurations，打开Run/Debug Configurations窗口；
• 点击工具栏上的+按钮，下拉菜单中选择Remote；
• 设置 Host 为远程服务器的域名或IP，保持 Port=5005 无需调整；
• Use module classpath配置为程序模块名称；
• Command line arguments for remote JVM配置：配置Debug远程服务的命令行启动参数，
• 形如 -Xdebug -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005，参数说明如下：
  • Xdebug： JVM在DEBUG模式下工作；
  • -agentlib： jvm参数用于装载本地lib包；其中libname为本地代理库文件名，默认搜索路径为环境变量PATH中的路径，options为传给本地库启动时的参数，多个参数之间用逗号分隔
  • jwdp： Java Debug Wire Protocol的缩写；
  • transport： 用于在调试程序和VM使用的进程之间通讯；
  • dt_socket： 套接字传输；
  • server=y/n： VM是否需要作为调试服务器执行；
  • suspend=y/n： 是否在调试客户端建立连接立后启动VM;
  • address： 调试服务器监听的端口号。
    

3.3、远程服务器防火墙端口放行

# 1、直接关闭防火墙
systemctl stop firewalld.service
# 2、开启某个端口并重启
firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --reload

3.4、重启服务

4、被动连接调试

首先需要IDEA配置监听，如主动连接调试的IDEA配置图片，Debugger mode选择：Listen to remote JVM，配置本地监听端口，比如默认5005。点击Debug开始等待远程连接调试。

4.1、Tomcat

# 配置远程服务启动脚本
JAVA_OPTS="$JAVA_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=127.0.0.1:5005,suspend=y"

4.2、Spring Boot

参数含义和主动连接调试一样，只是这里suspend=y表示启动时就中断，需要连接本地IDE调试启动。address=ip:port，ip需要修改为本地的对外IP。

# 命令行添加选项，并重启，注意新参数必须在 -jar 之前
java -Xdebug -Xrunjdwp:transport=dt_socket,address=127.0.0.1:5005,suspend=y -jar springbootfirst.jar

5、开始调试

• 要求：双方代码一致，否则远程调试无法启动；
• 本地启动刚刚配置的 Remote Server，正常时会看到日志: Connected to the target VM, address: 'xxx:5005', transport: 'socket'
• 本地 IDEA 代码中设置断点
• 浏览器或手机 HTTP 访问服务器
• IDEA 即可在断点暂停并跟踪

6、关闭调试

• 服务器上多开放个端口是不安全的，调试完毕后可恢复防火墙设置。
• Java 服务器关闭 Debug 服务器的功能，因为debug会影响性能。