Eclipse 遠端除錯 JBoss AS 完整設定步驟

背景

企業級應用常需 EJB 容器，Tomcat 無法滿足，JBoss AS 是常見選擇。本文說明如何在 Eclipse 中直接啟動並除錯 JBoss，而非透過外部啟動再 Remote Debug。

原理分析

查看 JBoss_Home/bin/run.bat 最後兩行，核心啟動類為 org.jboss.Main，關鍵參數：

• -Djava.endorsed.dirs=%JBOSS_ENDORSED_DIRS% → JBoss_Home/lib/endorsed
• -classpath %JBOSS_CLASSPATH% → JBoss_Home/lib + 應用程式 classpath

Eclipse Launch Configuration 設定步驟

1. 開啟 Run → Open Run Dialog...（或 Run Configurations...），新增一個 Java Application 配置。
2. Main 類別 填入 org.jboss.Main。
3. 在 Classpath 分頁將 jboss-system.jar 加入 User Entries（或將 JBoss lib 目錄下所有 jar 加入）。
4. 切換到 Arguments → VM arguments，填入：
   -Djava.endorsed.dirs=D:\jboss-4.2.3.GA\lib\endorsed
   （路徑請依實際安裝位置調整）
5. 在 Source 分頁加入專案原始碼目錄，方便中斷點除錯。
6. 點擊 Run，Console 將顯示 JBoss 啟動日誌，此時即可在 Eclipse 中對部署於 JBoss 的應用進行斷點除錯。

優點

• 整合啟動與除錯流程，無需切換視窗。
• 支援熱部署偵測（視 JBoss 設定而定）。
• 原始碼關聯完美，變數檢視、步進除錯無障礙。