Eclipse 3.0 + Lomboz 3.0 + JBoss 3.2.6 整合常見問題排查手冊

環境基線

• Eclipse 3.0.1
• Lomboz 3.0.1（需 EMF-SDK-2.0.1）
• JBoss 3.2.6

問題 1：Server Definitions 默認顯示 JBoss 2.4.4

現象

Preferences → Lomboz → Server Definitions 中 Server Types 首項始終是 JBoss 2.4.4，即使已 Apply 選中 JBoss 3.2.6。

根因

Server Types 列表 ≠ 當前項目使用的服務器。列表讀自 eclipse/plugins/com.objectlearn.jdt.j2ee_3.0.1/servers/ 目錄下的所有 *.server 文件，每個文件對應一種服務器模板配置。它只是告訴你「當前 Eclipse 安裝支持哪些服務器類型」，而非「項目正在用哪個」。

解決

1. 項目創建向導中選擇 Target Server 為 JBoss 3.2.6。
2. 或右鍵項目 → Properties → Server → Add/Select JBoss 3.2.6。
3. 清理無用模板：刪除 servers 目錄下 jboss244.server、jboss300all.server 等文件，列表即變乾淨。

問題 2：Server 文件如何編寫/修改

結構對應

Server Definitions 界面的 4 個 Tab 直接映射 .server 文件 XML 節點：

• 屬性頁 1：服務器安裝目錄、Classpath 變量定義（如 ${jboss_home}）。
• Server Classpath / Client Classpath / Project Classpath：三個 Classpath 作用域的 JAR/庫引用列表。

注意

Eclipse 不會實時校驗 Classpath 中引用的 JAR 物理存在性。界面顯示的圖標僅反映配置文件寫法，不代表文件真實可用。

問題 3：找不到 javax.servlet.jar / jboss-boot.jar

現象

專案構建路徑報錯，提示缺少這兩個 JAR。

根因

JBoss 3.2.6 已移除/重命名這些 JAR：

• javax.servlet.jar → 合併至 jbossweb-tomcat50.sar/servlet-api.jar
• jboss-boot.jar → 不再存在，啟動類加載機制變更。
• jdom.jar → 升級為 dom4j.jar

修正方案

1. 下載社區維護的 jboss326.server 模板（如日本站 kawaz.jp 提供）。
2. 或手動編輯 .server 文件，替換 Classpath 節點：

<jar type="variable">${jboss_home}/server/${server_config}/deploy/jbossweb-tomcat50.sar/servlet-api.jar</jar>
<jar type="variable">${jboss_home}/lib/dom4j.jar</jar>

問題 4：Lomboz J2EE View 啟動按鈕失效，只能手動 run.bat

現象

多次手動替換 .server 文件後，Eclipse 內部「啟動服務器」按鈕無響應。

可能原因

• .server 文件 XML 格式損壞（如未閉合標籤、屬性值未轉義）。
• Eclipse 內部模型緩存未刷新：嘗試 Project → Clean、重啟 Eclipse -clean 參數。
• Lomboz 版本與 Eclipse 微版本不匹配（3.0.1 vs 3.0.0），導致啟動委派鏈斷裂。

變通方案

1. 使用外部工具配置：Run → External Tools → New → Program，Location: ${jboss_home}/bin/run.bat，Working Directory: ${jboss_home}/bin。
2. 遷移到 MyEclipse / JBoss IDE / Eclipse WTP（Web Tools Platform）等更成熟的整合方案。

最佳實踐總結

1. 不要手工改 .server 文件，盡量通過 Preferences 界面修改，保證 XML 合法。
2. 版本鎖定：Eclipse + Lomboz + JBoss 三者版本必須來自同一發布測試矩陣。
3. 工作區隔離：不同 JBoss 版本項目使用獨立 Workspace，避免 Server Definitions 互相污染。
4. 遷移建議：新項目優先選擇 Eclipse WTP + JBoss AS 7+/WildFly，獲得原生 JEE 6/7 支持與熱部署體驗。