Java项目远程debug

今天糗大了，事情缘由是今天生产环境出现了一个bug，但是在测试环境无法复现,项目经理要求我和测试哥们一起找出问题。就出现了现在的远程Debug。

1，远程DEBUG的必要性

由于部署环境的差异性，相信很多朋友都碰到过开发环境正常测试过的功能在测试环境甚至生产环境下出现bug的情况。一般情况下，生产环境可以采取的手段比较单一，即通过日志的方式获取运行中的环境上下文，分析日志文件并尝试重现bug。这会带来的问题还是不少的，首先，日志的分析是一项比较耗时的工作；其次，现有的日志记录不一定能反映出问题，你可能需要多次重复这个过程(分析日志->猜测问题->加日志->部署->获取日志)来慢慢逼近问题。倘若是测试环境，我们还多了一项可供选择的手段——远程调试——将程序在测试环境中以debug模式启动，在本机使用IDEA在工程中设置断点进行调试。
 

2、下面我们简单构建一个Demo来测试远成Debug

POM.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.2.6.RELEASE</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.yuan</groupId>
	<artifactId>remote-debug</artifactId>
	<version>v1.0</version>
	<name>remote-debug</name>
	<description>Demo project for Spring Boot</description>
	<properties>
		<java.version>1.8</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

application.yml

server:
  port: 80
  servlet:
    context-path: /
  tomcat:
    uri-encoding: utf-8

搞个TestController，提供一个Rest接口

package com.yuan.ha.controller;

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {

    @PostMapping("/test")
    public String test(Integer id,String name){
        System.out.println("id="+id);
        System.out.println("name="+name);
        if(id>0){
            return "success "+name;
        }else{
            return "fail";
        }
    }

}

启动项目,我是用Postmapping 测试

测试接口：http://localhost/test 加入Body form-data 参数 id=1，name=wade，Send 测试，返回 success wade，测试OK；

 

3，测试Demo项目配置支持远程调试

pom.xml里配置jvmArguments参数 -Xdebug -Xrunjdwp:transport=dt_socket,address=5005,server=y,suspend=n

<build>
	<plugins>
		<plugin>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-maven-plugin</artifactId>
			<configuration>
				<jvmArguments>-Xdebug -Xrunjdwp:transport=dt_socket,address=5005,server=y,suspend=n</jvmArguments>
			</configuration>
		</plugin>
	</plugins>
</build>

加了此配置后，打包后的项目发布服务器，可支持远程DEBUG；

具体参数详解：

-Xdebug 通知JVM工作在DEBUG模式下；

-Xrunjdwp 通知JVM使用(Java debug wire protocol)运行调试环境。该参数同时包含了一系列的调试选项；

**transport **指定了调试数据的传送方式，dt_socket是指用SOCKET模式，另有dt_shmem指用共享内存方式，其中，dt_shmem只适用于Windows平台；

address 调试服务器的端口号，客户端用来连接服务器的端口号；

server=y/n VM 是否需要作为调试服务器执行；

suspend=y/n 是否在调试客户端建立连接之后启动 VM；
 

4，IDEA打包jar

点击图中的package

 

一般打包跳过test，可以点击箭头所指闪电图标，这样打包速度会快很多；

然后会在target目录下生成一个jar包 

 

 5，启动jar并且带启动参数支持远程调试

我们把remote-debug-v1.0.jar放D盘根目录；

我们启动jar，并且支持远程DEBUG；

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar remote-debug-v1.0.jar

 启动OK，监听socket 5005端口

6，IDEA远程DEBUG配置

IDEA要进行远程DEBUG，需要进行配置；

1，启动项下拉，选择 Edit Configurations...编辑配置

2，点击+，选择Remote JVM Debug，添加远程DEBUG配置

 3，添加远程DEBUG配置项，Host和Port，配置后，点击Apply和OK按钮

 

7，IDEA远程DEBUG测试

1，打测试断点

我们直接在TestController类里的test方法上打点断；

2，选择远程debug启动项，然后点击测试调试按钮启动；

 

 3，postman测试

 

 

进入Debug成功

 我们走完断点；

5，启动的jar包打印信息，测试OK

 

哈哈看完这一篇，恭喜你又学到新东西了，会的同学请多多指出文章中的不对，谢谢。