J2EE 開發常見錯誤與解決方案速查表：服務器啟動、編譯部署、客戶端運行與 Web 訪問故障排除

服務器啟動錯誤

命名目錄服務端口衝突 (1050)

現象：J2EE server listen port: 1050 RuntimeException: Could not initialize server
解決：停止已運行的 J2EE 服務 (j2ee -stop) 或修改 config/orb.properties 更改默認端口。

Web 服務端口衝突 (8000)

現象：LifecycleException: HttpConnector[8000].open: Address in use
解決：修改 config/orb.properties 中的默認端口 8000。

XML 解析錯誤

現象：FactoryConfigurationError: org.apache.xerces.jaxp.SAXParserFactoryImpl
解決：刪除 J2SE 安裝目錄下的 jre/lib/jaxp.properties。

編譯構建錯誤

Ant 找不到構建文件

現象：Buildfile: build.xml does not exist!
解決：切換到 j2eetutorial/examples/src 目錄運行 ant，或用 -buildfile 指定路徑。

編譯器無法解析符號

現象：大量 cannot resolve symbol 錯誤
解決：檢查 J2EE_HOME 環境變量是否正確配置。

Ant 1.4 與客戶端運行衝突

現象：The filename, directory name, or volume label syntax is incorrect
解決：改用 Ant 1.3 版本，因 1.4 的 JAVACMD 環境變量與 SDK 腳本衝突。

部署錯誤

類路徑中 XML 解析器不兼容

現象：Bad mapping of key{0} class{1}, not found: com.sun.enterprise.deployment.xml.ApplicationNode
解決：刪除 J2SE jre/lib/ext/jaxp.jar 或從類路徑移除 Tomcat 的 XML 解析器。

遠程 Home 接口被誤指定為本地 Home 接口

現象：LocalHomeImpl must be declared abstract...
解決：刪除該 Enterprise Bean，用向導重建並選擇 Remote Home Interface 與 Remote Interface。

應用程序客戶端運行錯誤

• NoClassDefFoundError：檢查客戶端 JAR 部署步驟
• 找不到 ConverterApp.ear：確認文件存在並用 runclient -client ConverterApp.ear -name ConverterClient
• 找不到 ConverterClient 組件：檢查組件是否創建及 -name 參數
• 登錄失敗：用戶名 guest，密碼 guest123
• 應用未部署 / JNDI 命名錯誤：部署應用，確認 JNDI 名稱匹配 ejb/SimpleConverter

Web 客戶端運行錯誤

• URL 路徑不正確 (404)：檢查 Web Context 與 Component 設置是否一致，注意大小寫
• 應用未部署 (404)：執行部署操作
• JNDI 命名錯誤 (Servlet Exception)：檢查 ConverterBean 與 ConverterWAR 的 JNDI 名稱匹配

驗證工具與其他

使用 verifier (deploytool → Tools → Verifier) 檢測部署描述符與方法簽名的不一致。若上述方法無效，嘗試：j2ee -stop && cleanup && j2ee -verbose 重新安裝並清理服務器存儲。