Eclipse 遠程調試 Tomcat 應用實戰

專案採用 Ant 編譯部署，團隊成員習慣 Eclipse 圖形化調試。本文記錄啟動 Tomcat JPDA 模式 + Eclipse Remote Java Application 連接的最簡配置，解決「無法在 Eclipse 中斷點調試」痛點。

核心原理

JVM 開啟 JPDA (Java Platform Debugger Architecture) 監聽端口，Eclipse 作為 Debug Client 透過 Socket 連接，實現斷點、單步、變數檢視等完整調試功能。

Tomcat 啟動腳本 (debug-startup.bat)

set JPDA_ADDRESS=8000
set JPDA_TRANSPORT=dt_socket
cd D:\tomcat-5.5.9\bin
catalina jpda start

關鍵環境變數：
- JPDA_ADDRESS：監聽端口 (默認 8000)
- JPDA_TRANSPORT：傳輸協議 dt_socket (Socket 通訊)
- catalina jpda start：啟動 JPDA 模式

Eclipse 遠程調試配置

1. Run → Debug Configurations... → Remote Java Application → New
2. 設定：
   - Name: Tomcat Remote Debug
   - Project: 選擇需調試的專案 (源碼必須與部署類別一致)
   - Host: localhost (或遠程服務器 IP)
   - Port: 8000 (與 JPDA_ADDRESS 一致)
   - 勾選 Allow termination of remote VM (可選，允許從 Eclipse 關閉遠程 JVM)
3. Apply → Debug，Console 顯示 Connected to the target VM 即連接成功。

驗證調試

1. 在 Eclipse 專案源碼設置斷點 (如 Service 層業務邏輯)。
2. 瀏覽器觸發對應請求。
3. Eclipse 自動暫停於斷點，Variables 面板顯示完整上下文變數，支援單步 (F5/F6/F7/F8)、表達式監視、條件斷點。

常見問題排查

進階建議

• 生產環境慎用：JPDA 開放端口有安全風險，建議僅內網/VPN 訪問，或用 SSH Tunnel 轉發端口。
• 多模組專案：Eclipse Debug 配置可添加多個 Source Lookup Path (Java Project / Workspace / Folder)，支援跨模組調試。
• 熱替換 (Hot Code Replace)：修改方法體存檔後自動生效 (需 JVM 支援)，無需重啟 Tomcat 即可驗證修正。

出處：《Enjoy Web Dev With Tapestry》書籍啟發。