萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> Oracle 教學

解決 Oracle IAS 環境下 HttpClient NoClassDefFoundError 類載入衝突

問題現象

在本機 Tomcat 運行正常的 HttpClient 3.1 程式,部署至 Oracle IAS (OC4J) 即拋出:

java.lang.NoClassDefFoundError: org/apache/commons/httpclient/HttpMethodBase
    at org.apache.commons.httpclient.HttpMethodBase.writeRequestLine(...)

根因分析

  • OC4J 內建舊版 commons-httpclient (如 2.x) 在共享類載入器中。
  • 應用程式自帶 commons-httpclient-3.1.jar 放在 WEB-INF/lib,但類載入順序導致父載入器優先載入舊版類,缺少 3.1 新增方法 → NoClassDefFoundError。

三種解決方案 (按推薦順序)

方案 1:類載入器隔離 (最乾淨)

在 orion-application.xml 設定 class-loader 為 search-local-classes-first="true":

<orion-application ...>
  <class-loader search-local-classes-first="true" />
</orion-application>

強制優先載入 WEB-INF/lib 版本,避免父載入器干擾。

方案 2:移除/升級共享庫

  1. 找到 OC4J 安裝目錄 j2ee/home/applib/ 或 shared/lib/ 下的舊版 commons-httpclient*.jar。
  2. 備份並刪除或替換為 3.1 版。
  3. 重啟 OC4J。

缺點:影響同容器其他應用,需回歸測試。

方案 3:打包為 Shared Library

  1. 建立 httpclient-shared-lib.ear 僅含 commons-httpclient-3.1.jar、commons-codec-1.3.jar 及 META-INF/application.xml。
  2. 部署為 Shared Library,並在應用 orion-application.xml 宣告 <import-shared-library name="httpclient-shared-lib"/>。

優點:版本集中管理,多應用共享。

驗證步驟

  1. 部署應用後,JSP 測試頁呼叫 visitURL()。
  2. 檢查日誌無 NoClassDefFoundError,HTTP 狀態碼 200。
  3. 執行 jar -tf 確認最終類路徑僅含單一版本。

延伸建議

  • 升級至 HttpClient 4.5+ (套件名 org.apache.httpcomponents) 避免舊包衝突。
  • 使用 Maven/Gradle 管理依賴,排除傳遞性依賴中的舊版。
  • OC4J 10.1.3 為終止生命週期產品,規劃遷移至 WebLogic / Tomcat / WildFly。
copyright © 萬盛學電腦網 all rights reserved