java程序遠程debug原理與配置全過程

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

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

背景

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

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

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

組成

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

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

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

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

在調試者和被調試著之間，調試命令和調試結果，都是通過 JDWP 的通訊協(xié)議傳輸?shù)摹Ｋ械拿畋环庋b成 JDWP 命令包，通過傳輸層發(fā)送給被調試者，被調試者接收到 JDWP 命令包后，解析這個命令并轉化為 JVMTI 的調用，在被調試者上運行。

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

模塊間聯(lián)系

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

JDWP 定義調試者和被調試者交流數(shù)據(jù)的格式。
JVMTI 可以控制當前虛擬機運行狀態(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)來運行調試環(huán)境；
transport：有兩種形式，分別是socket和shared memory，需要跨機器，只能用socket；
server：server=y表示當前是調試服務端，=n表示當前是調試客戶端；
address：端口號，這里采用的是tcp協(xié)議。我們可以使用 cat /etc/services | grep '9001' 來查看該端口是否開啟；
suspend：如果是y，則需要等B機器上的debugger開啟后，程序才會開始運行。否則，程序啟動時候不會掛起，直接運行；如果設置為y，它會阻塞程序運行，直到有客戶端連接到對應的監(jiān)聽端口(這里是9527)，程序才真正開始執(zhí)行。我們有時候會抱怨程序一閃而過，還沒來得及在本地加載上代碼程序就執(zhí)行完了，這種情況就可以使用suspend參數(shù)。