0

0

Java远程调试(Remote Debugging)的那些事

蓮花仙者

蓮花仙者

发布时间:2025-09-12 08:02:11

|

583人浏览过

|

来源于php中文网

原创

java远程调试(remote debugging)的那些事

前言 本文将探讨如何处理和调试那些仅在生产环境(或其他远程环境)中发生,而本地开发环境无法重现的“问题”。任何遇到这种情况的人都必须承认,试图找出这种“问题”原因的过程,很可能以一堆无根据的猜测告终:这是一个非常耗时且效率低下的过程。

还有一种情况,你得到了一个可以部署的war/jar包,只有class文件而没有java源代码,而应用在本地/远程部署后,是否可以调试?读完本文,你将明白如何操作。

配置远程调试包括两个步骤:

  1. 启动Tomcat并启用远程调试
  2. 使用IDE(这里使用IntelliJ IDEA)调试远程Tomcat应用

Tomcat启用远程调试 有多种方法可以实现这一点,根据Tomcat运行的操作系统略有不同。然而,无论使用哪种方法,这些配置的背后都是传递特定的启动参数给JVM,让它启用远程调试(remote debugging)。JVM激活远程调试的启动参数有JPDA_OPTS、CATALINA_OPTS和JAVA_OPTS。其中,JAVA_OPTS通常不建议使用,因为基于JAVA_OPTS的参数设置会暴露给所有JVM应用,而CATALINA_OPTS定义的设置值仅限于Tomcat内部。

  1. 使用JPDA_OPTS 在CATALINA_HOME/bin目录下创建可执行脚本文件setenv.sh(Windows下创建setenv.bat),并加入以下内容:

Linux setenv.sh

export JPDA_OPTS="-agentlib:jdwp=transport=dt_socket,address=1043,server=y,suspend=n"

Windows setenv.bat

立即学习Java免费学习笔记(深入)”;

set JPDA_OPTS="-agentlib:jdwp=transport=dt_socket,address=1043,server=y,suspend=n"

这些参数的作用是启用远程调试并配置有效的选项:

  • 指定调试应用和调试者之间的通信协议(例如:transport=dt_socket)
  • 远程被调试应用开启的端口(例如:address=1043),可定义其他端口,如9999
  • server=y表示这个JVM即将被调试
  • suspend=n告知JVM立即执行,不要等待未来将要附着的调试者。如果设置为y,应用将暂停运行,直到有调试者连接

当然,上面的设置也可以直接放到catalina.sh(catalina.bat)内,但使用setenv.*配置文件是更好的选择,因为Tomcat会自动读取。

需要注意的是,有些人可能会使用另一种配置方法来启用远程调试:

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

-Xdebug和-Xrunjdwp与我们推荐的设置不同之处在于,它是一种旧方式,适用于JVM小于JAVA 5.0的版本(包括5.0),而agentlib:jdwp适用于JAVA 5.0及以后版本。

最后,通过以下命令行启动Tomcat,即可完成Tomcat启用远程调试:

$CATALINA_HOME/bin/catalina.sh jpda start
  1. 使用JAVA_OPTS/CATALINA_OPTS 如果你是在Windows系统上将Tomcat作为系统服务来运行的,直接打开Apache Tomcat的属性对话框,在Java选项卡中添加启动参数:
-agentlib:jdwp=transport=dt_socket,address=1043,server=y,suspend=n
请确保每一条配置都是新的一行,参数选项之间没有空格

但如果Tomcat没有作为Windows系统服务,启用方法与前面类似,在setenv.bat文件中写入:

set CATALINA_OPTS="-agentlib:jdwp=transport=dt_socket,address=1043,server=y,suspend=n"

如果运行在Linux上,在setenv.sh中写入:

export CATALINA_OPTS="-agentlib:jdwp=transport=dt_socket,address=1043,server=y,suspend=n"

按照普通的方式启动Tomcat即可:

./startup.sh或者./catalina.sh start
  1. 使用JPDA启动 最后一种启用远程调试的方式是使用JPDA切换,使用以下启动命令将使用默认值自动启用远程调试:
catalina jpda start

该命令默认使用的设置是:

-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

如果你想要修改默认设置中的选项,可以通过修改Tomcat需要的这些环境变量来实现:

//JPDA_TRANSPORT: 指定jpda传输协议
//JPDA_ADDRESS: 指定远程调试端口
//JPDA_SUSPEND: 指定jvm启动暂缓
export JDPA_ADDRESS="8080"

然后再运行catalina jpda start,远程调试的端口将变成8080。

配置IntelliJ IDEA 确定远程Tomcat启动的应用已经开启了远程调试,接下来就是配置IntelliJ IDEA了。这里有两种方式:Remote Tomcat或Remote。

  1. 使用Remote Tomcat配置 首先确保IDEA中已经打开了需要远程调试的工程源码,然后点击Run ➝ Edit Configurations ➝ +按钮 ➝ Tomcat Server ➝ Remote。

输入必要的远程IP地址和端口(Tomcat http端口);

Android配合WebService访问远程数据库 中文WORD版
Android配合WebService访问远程数据库 中文WORD版

采用HttpClient向服务器端action请求数据,当然调用服务器端方法获取数据并不止这一种。WebService也可以为我们提供所需数据,那么什么是webService呢?,它是一种基于SAOP协议的远程调用标准,通过webservice可以将不同操作系统平台,不同语言,不同技术整合到一起。 实现Android与服务器端数据交互,我们在PC机器java客户端中,需要一些库,比如XFire,Axis2,CXF等等来支持访问WebService,但是这些库并不适合我们资源有限的android手机客户端,

下载

然后转到Startup/Connection选项卡页,选择“Debug”,输入远程调试端口,我们的例子是1043。

保存后,开始调试启动远程调试,如果运行成功会显示如下的界面,然后在源码中加断点开始调试。

  1. 使用Remote配置(推荐) 第一个方法有一个缺陷,你打开的工程源码必须是编译通过的工程,否则会启动时报错;而介绍的这第二种方法可以在你的工程目录乱七八糟,不是一个完整的可以部署的工程,甚至是一个解压缩的war/jar的情况下都可以调试。

同上步骤,只是选择“Remote”,然后输入Name,修改Host,Port(1043)即可,保存后开始Debug。

设置比Remote Tomcat更简单,这里介绍一个实际案例。

我手上有一个可部署的war包,没有源码,在远程已经部署完毕。这时我想调试那个远程应用,怎么做呢?

解压缩war包到一个文件夹,然后用IntelliJ IDEA打开这个文件夹,如图的结构,编译的Class都在WEB-INF/classes目录下。

找到我要调试的那个class,这里示例Handler.class,通过Idea反编译出来的类代码,拷贝到一个新的文件Handler.java。

虽然如图可以看到各种编译错误,但完全不影响你启动,代码中加断点和调试哦。

远程JVM调试的工作原理源于被称为Agents的东西。

运行各种编译后的.class文件的JVM,有一种特性,可以允许外部的库(Java或C++写的libraries)在运行时注入到JVM中。这些外部的库就称为Agents,它们有能力修改运行中的.class文件的内容。

这些Agents拥有的这些JVM的功能权限,是在JVM内运行的Java Code所无法获取的,它们能用来做一些有趣的事情,比如修改运行中的源码,性能分析等。像JRebel工具就是利用这些功能达到魔术般的效果。

通过添加-agentlib:libname[=options]格式的启动参数,可以将一个Agent Lib传递给JVM。像上面的远程调试我们用的就是-agentlib:jdwp=...来引入jdwp这个Agent的。

jdwp是一个JVM特定的JDWP(Java Debug Wire Protocol)可选实现,用来定义调试者与运行JVM之间的通信,它是通过JVM本地库的jdwp.so或者jdwp.dll支持实现的。

它到底是如何工作的呢?简单来说,jdwp agent会建立运行应用的JVM和调试者(本地或远程)之间的桥梁。既然它是一个Agent Library,它就有能力拦截运行的代码。

在JVM架构中,调试功能在JVM本身的内部是找不到的,它是一种抽象到外部工具的方式(也称为调试者debugger)。这些调试工具可以运行在JVM的本地或远程。这是一种解耦,模块化的架构。

更多关于远程部署相关,以及JDWP的深入说明,大家有兴趣可以自己研究一下。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

831

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

396

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7万人学习

Git 教程
Git 教程

共21课时 | 2.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号