1,远程DEBUG的必要性

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

2,IDEA构建SpringBoot测试Demo 

新建SpringBoot测试项目remote-debug,只需要web依赖支持即可;版本选用2.2.6.RELEASE(注意,别用2.5.1版本,有坑,亲测)

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.java1234</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.java1234.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";
        }
    }

}

 

我们启动项目,用postman测试下:

测试接口:http://localhost/test 加入Body form-data 参数 id=1,name=marry,Send 测试,返回 success marry,测试OK;

java远程debug怎么配置 java远程debug原理_开发语言

 

 

 

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 

我们打包jar包;

右侧Maven工具,双击 package打包工具;

java远程debug怎么配置 java远程debug原理_spring_02

 

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

 

java远程debug怎么配置 java远程debug原理_java远程debug怎么配置_03

 打包后,在target目录下,会生成一个jar包;我们把它复制出来即可;

java远程debug怎么配置 java远程debug原理_spring_04

 

 

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

java远程debug怎么配置 java远程debug原理_jar_05

 启动OK,监听socket 5005端口

 

6,IDEA远程DEBUG配置 

IDEA要进行远程DEBUG,需要进行配置; 

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

java远程debug怎么配置 java远程debug原理_jar_06

 

 2,点击+,选择Remote,添加远程DEBUG配置

java远程debug怎么配置 java远程debug原理_java_07

 

 3,添加远程DEBUG配置项,Host和Port,配置后,点击ApplyOK按钮

java远程debug怎么配置 java远程debug原理_开发语言_08

 

7,IDEA远程DEBUG测试

1,打测试断点

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

 

java远程debug怎么配置 java远程debug原理_java远程debug怎么配置_09

 

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

java远程debug怎么配置 java远程debug原理_jar_10

 

 

3,postman测试 

java远程debug怎么配置 java远程debug原理_java远程debug怎么配置_11

 

4,成功进入断点 

java远程debug怎么配置 java远程debug原理_java_12

 

我们走完断点;

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

java远程debug怎么配置 java远程debug原理_开发语言_13