快捷導(dǎo)航

java程序遠(yuǎn)程debug原理與配置全過程

更新時間：2025年09月27日 15:32:46 作者：vamViolet

文章介紹了Java遠(yuǎn)程調(diào)試的JPDA體系,包含JVMTI監(jiān)控JVM、JDWP傳輸調(diào)試命令、JDI提供調(diào)試接口,通過-Xdebug、-Xrunjdwp參數(shù)配置調(diào)試模式,其中suspend控制程序是否等待調(diào)試器連接,解決程序閃退問題

背景

日常工作中，每個程序員都會遇到bug。也往往會需要調(diào)試遠(yuǎn)程環(huán)境中的程序，這時候就需要遠(yuǎn)程調(diào)試。

eclipse、idea等IDE工具可以遠(yuǎn)程調(diào)試，本質(zhì)上都是實現(xiàn)了Java 的平臺調(diào)試體系—— JPDA (Java Platform Debugger Architecture，JPDA)。

這個體系為開發(fā)人員提供了一整套用于調(diào)試 Java 程序的 API，是一套用于開發(fā) Java 調(diào)試工具的接口和協(xié)議。也就是說JPDA是JVM的調(diào)試標(biāo)準(zhǔn)，任何JDK都必須實現(xiàn)。

組成

JPDA 由三個獨立的模塊 JVMTI（Java VM工具界面）、JDWP（Java調(diào)試線協(xié)議）、JDI （Java調(diào)試接口）組成。

簡單來說，JPDA把調(diào)試過程分解成幾個很自然的概念：

調(diào)試者（debugger）和被調(diào)試者（debuggee），以及他們中間的通信器。

被調(diào)試者運行于我們想調(diào)試的 Java 虛擬機(jī)之上，它可以通過 JVMTI 這個標(biāo)準(zhǔn)接口，監(jiān)控當(dāng)前虛擬機(jī)的信息；調(diào)試者定義了用戶可使用的調(diào)試接口，通過這些接口，用戶可以對被調(diào)試虛擬機(jī)發(fā)送調(diào)試命令，同時調(diào)試者接受并顯示調(diào)試結(jié)果。

在調(diào)試者和被調(diào)試著之間，調(diào)試命令和調(diào)試結(jié)果，都是通過 JDWP 的通訊協(xié)議傳輸?shù)?。所有的命令被封裝成 JDWP 命令包，通過傳輸層發(fā)送給被調(diào)試者，被調(diào)試者接收到 JDWP 命令包后，解析這個命令并轉(zhuǎn)化為 JVMTI 的調(diào)用，在被調(diào)試者上運行。

類似的，JVMTI 的運行結(jié)果，被格式化成 JDWP 數(shù)據(jù)包，發(fā)送給調(diào)試者并返回給 JDI 調(diào)用。而調(diào)試器開發(fā)人員就是通過 JDI 得到數(shù)據(jù)，發(fā)出指令。

模塊間聯(lián)系

調(diào)試者通過 JDI 發(fā)送接受調(diào)試命令。

JDWP 定義調(diào)試者和被調(diào)試者交流數(shù)據(jù)的格式。
JVMTI 可以控制當(dāng)前虛擬機(jī)運行狀態(tài)。

使用

#對于JDK1.4版本，使用：
-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=9001
#對于JDK1.5以上的版本，JVM參數(shù)是：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=9001

參數(shù)說明：

-Xdebug：通知JVM工作在debug模式下；
-Xrunjdwp：通知JVM使用(java debug wire protocol)來運行調(diào)試環(huán)境；
transport：有兩種形式，分別是socket和shared memory，需要跨機(jī)器，只能用socket；
server：server=y表示當(dāng)前是調(diào)試服務(wù)端，=n表示當(dāng)前是調(diào)試客戶端；
address：端口號，這里采用的是tcp協(xié)議。我們可以使用 cat /etc/services | grep '9001' 來查看該端口是否開啟；
suspend：如果是y，則需要等B機(jī)器上的debugger開啟后，程序才會開始運行。否則，程序啟動時候不會掛起，直接運行；如果設(shè)置為y，它會阻塞程序運行，直到有客戶端連接到對應(yīng)的監(jiān)聽端口(這里是9527)，程序才真正開始執(zhí)行。我們有時候會抱怨程序一閃而過，還沒來得及在本地加載上代碼程序就執(zhí)行完了，這種情況就可以使用suspend參數(shù)。