远程debug调试，小伙伴们都很惊讶！

ゝ一世哀愁。 2022-10-08 00:57 146阅读 0赞

![加油][20210515142150468.gif]

**文末附上视频教程下载地址（白嫖0积分下载）**

## 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/> 
    	</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;
    
    /**
     * @author java1234_小锋
     * @site www.java1234.com
     * @company Java知识分享网
     * @create 2021-06-12 15:37
     */
    @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；

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qPf6tyol-1623688298210)(image-20210613222730931.png)\]][img-qPf6tyol-1623688298210_image-20210613222730931.png]

## 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打包工具；

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3t35X1S1-1623688298215)(image-20210613224738500.png)\]][img-3t35X1S1-1623688298215_image-20210613224738500.png]

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gjGv5k7R-1623688298218)(image-20210613224828589.png)\]][img-gjGv5k7R-1623688298218_image-20210613224828589.png]

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-K5FN6ULx-1623688298222)(image-20210613224918420.png)\]][img-K5FN6ULx-1623688298222_image-20210613224918420.png]

## 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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RERGHClm-1623688298225)(image-20210613225414441.png)\]][img-RERGHClm-1623688298225_image-20210613225414441.png]

启动OK，监听socket 5005端口

## 6，IDEA远程DEBUG配置 ##

--------------------

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

1，启动项下拉，选择 `Edit Configurations...`编辑配置  
![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3UGDXNMD-1623688298228)(image-20210613225801811.png)\]][img-3UGDXNMD-1623688298228_image-20210613225801811.png]

2，点击`+`，选择`Remote`，添加远程DEBUG配置  
![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3rzwtdYm-1623688298229)(image-20210613230023399.png)\]][img-3rzwtdYm-1623688298229_image-20210613230023399.png]

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-l0edF9KU-1623688298231)(image-20210613230200362.png)\]][img-l0edF9KU-1623688298231_image-20210613230200362.png]

## 7，IDEA远程DEBUG测试 ##

--------------------

1，打测试断点

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2MqDENbp-1623688298232)(image-20210613230809384.png)\]][img-2MqDENbp-1623688298232_image-20210613230809384.png]

2，选择远程debug启动项，然后点击测试调试按钮启动；  
![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-HWmN2f6b-1623688298234)(image-20210613230646749.png)\]][img-HWmN2f6b-1623688298234_image-20210613230646749.png]

3，postman测试

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VJrvld2D-1623688298236)(image-20210613231151240.png)\]][img-VJrvld2D-1623688298236_image-20210613231151240.png]

4，成功进入断点

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-BeCKrJS3-1623688298238)(image-20210613231235544.png)\]][img-BeCKrJS3-1623688298238_image-20210613231235544.png]

我们走完断点；

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

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-waIbt2vf-1623688298241)(image-20210613231336792.png)\]][img-waIbt2vf-1623688298241_image-20210613231336792.png]

## 8，eclipse远程DEBUG实现 ##

--------------------

1，右击项目 -> Debug As -> Debug Configurations…

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-NCIa03JQ-1623688298243)(image-20210613232154571.png)\]][img-NCIa03JQ-1623688298243_image-20210613232154571.png]

2，找到 `Remote Java Application` 然后右击 `New`

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-o1TZdUQg-1623688298245)(image-20210613232409021.png)\]][img-o1TZdUQg-1623688298245_image-20210613232409021.png]

3，配置`Host`和`Port`，点击`Debug`按钮，即可实现远程DEBUG

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-pDNULzPO-1623688298248)(image-20210613232629335.png)\]][img-pDNULzPO-1623688298248_image-20210613232629335.png]

## 9，打war包方式配置远程DEBUG ##

--------------------

如果打的是war包，需要两个步骤：

1.  将 web 应用部署到 Tomcat 的 webapp 目录下
2.  修改 Tomcat/bin/startup.bat 文件，在最前面加上如下代码：
    
    SET CATALINA\_OPTS=-server -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt\_socket,server=y,suspend=n,address=5005

## 10，远程debug视频教程+文档+源码下载 ##

链接：[https://pan.baidu.com/s/1Xd75eAOXcvAnBax7VFsnjQ][https_pan.baidu.com_s_1Xd75eAOXcvAnBax7VFsnjQ]  
提取码：**1234**

--------------------

![format_png][]

**想要实时关注更多干货好文，扫描下图关注：**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTcwNjU4_size_16_color_FFFFFF_t_70][]

[20210515142150468.gif]: /images/20221005/d7e3640781be4a64a2ad521201e21d7d.png
[img-qPf6tyol-1623688298210_image-20210613222730931.png]: /images/20221005/6b3310cfccd940e1b0b2b62cc0079507.png
[img-3t35X1S1-1623688298215_image-20210613224738500.png]: /images/20221005/9a0bc9b0cbf04b7eae42cc23766b63db.png
[img-gjGv5k7R-1623688298218_image-20210613224828589.png]: /images/20221005/99618a7050664a7d89ebe771a93136f3.png
[img-K5FN6ULx-1623688298222_image-20210613224918420.png]: /images/20221005/e9487a71dac9476bbb7c77e48affc417.png
[img-RERGHClm-1623688298225_image-20210613225414441.png]: /images/20221005/6b117844b2f248c584cc2259a881a51f.png
[img-3UGDXNMD-1623688298228_image-20210613225801811.png]: /images/20221005/f370024160b74583943c834e80cbe2a0.png
[img-3rzwtdYm-1623688298229_image-20210613230023399.png]: /images/20221005/56775094a35f40c0b4baadbfc7ad1937.png
[img-l0edF9KU-1623688298231_image-20210613230200362.png]: /images/20221005/f362701d865c4516adfba8ae3687734f.png
[img-2MqDENbp-1623688298232_image-20210613230809384.png]: /images/20221005/b2e355bbd98b4c9f8e5c6fa61c21782d.png
[img-HWmN2f6b-1623688298234_image-20210613230646749.png]: /images/20221005/3652d1224a224a18b4f479a467a0893d.png
[img-VJrvld2D-1623688298236_image-20210613231151240.png]: /images/20221005/ac970afac4434ea6bbad978398ebb244.png
[img-BeCKrJS3-1623688298238_image-20210613231235544.png]: /images/20221005/6d21048fc57b431b997e65e9a3159a79.png
[img-waIbt2vf-1623688298241_image-20210613231336792.png]: /images/20221005/1a8944f0bfc94ad684511a1000324c30.png
[img-NCIa03JQ-1623688298243_image-20210613232154571.png]: /images/20221005/cba257c889f94a838b480f595c309edb.png
[img-o1TZdUQg-1623688298245_image-20210613232409021.png]: /images/20221005/00f4617d34c9470b9e51e35a72bee516.png
[img-pDNULzPO-1623688298248_image-20210613232629335.png]: /images/20221005/7ab1fe502d804dd3924938fe7c4e54ac.png
[https_pan.baidu.com_s_1Xd75eAOXcvAnBax7VFsnjQ]: https://pan.baidu.com/s/1Xd75eAOXcvAnBax7VFsnjQ
[format_png]: /images/20221005/104b68efca8a47e6854bb7a6f1779149.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTcwNjU4_size_16_color_FFFFFF_t_70]: /images/20221005/44d6aae6e49f45de93e870ba0d9d200a.png