Oracle IAS 環境下 HttpClient 衝突排查：棄用第三方包改用 JDK 原生 HttpURLConnection

問題背景

專案需定期呼叫外部 HTTP API 監控服務狀態。開發環境 (Tomcat) 使用 Apache Commons HttpClient 3.1 運作正常；部署至 Oracle IAS (OC4J) 卻拋出 NoClassDefFoundError，堆疊指向 HttpMethodBase.writeRequestLine。

排查過程

1. 確認 JAR 一致：本地與伺服器 commons-httpclient-3.1.jar, commons-codec-1.3.jar 版本、大小、MD5 完全相同。
2. 刪除本地 JAR 測試：移除開發環境兩支 JAR 後，IDE 僅報一處找不到類，其餘引用正常 → OC4J 內建舊版 HttpClient 類別優先被類別載入器載入，導致版本衝突。
3. 嘗試隔離：調整 class-loader 設定、打包進 EAR/lib、設定 imported-shared-libraries 均未果，OC4J 父優先載入機制難以打破。

決策：改用 JDK 原生 HttpURLConnection

考量：

• 需求單純：GET 請求、讀取回應、檢查關鍵字、超時控制。
• HttpClient 功能過剩 (連線池、重試、Cookie、認證等) 反增複雜度與衝突風險。
• JDK 原生類保證相容、零依賴、零部署成本。

重構程式碼

import java.io.*;
import java.net.*;
import java.util.logging.Logger;

public class UrlMonitor {
    private static final Logger LOG = Logger.getLogger(UrlMonitor.class.getName());
    private static final int TIMEOUT_MS = 10_000;
    private static final int BUFFER_SIZE = 4096;

    /**
     * 呼叫 URL 並檢查回應內文是否包含 successFlag
     * @return true=成功且包含關鍵字, false=失敗/不含關鍵字
     */
    public boolean visitUrl(String urlStr, String successFlag) {
        HttpURLConnection conn = null;
        ByteArrayOutputStream baos = new ByteArrayOutputStream();

        try {
            URL url = new URL(urlStr);
            conn = (HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(TIMEOUT_MS);
            conn.setReadTimeout(TIMEOUT_MS);
            conn.setRequestMethod("GET");
            conn.setDoInput(true);
            conn.setUseCaches(false);

            try (InputStream in = conn.getInputStream()) {
                byte[] buf = new byte[BUFFER_SIZE];
                int len;
                while ((len = in.read(buf)) != -1) {
                    baos.write(buf, 0, len);
                }
            }

            String response = baos.toString("UTF-8"); // 依實際編碼調整
            LOG.fine("Response: " + response);

            if (response.contains(successFlag)) {
                LOG.info("Visit URL [" + urlStr + "] SUCCESS");
                return true;
            } else {
                LOG.warning("Visit URL [" + urlStr + "] missing flag: " + successFlag);
                return false;
            }

        } catch (MalformedURLException e) {
            LOG.severe("Invalid URL: " + urlStr + " - " + e.getMessage());
        } catch (IOException e) {
            LOG.severe("Transport error: " + e.getMessage());
        } finally {
            if (conn != null) conn.disconnect();
            try { baos.close(); } catch (IOException ignored) {}
        }
        return false;
    }
}

關鍵優化細節

部署驗證

移除專案所有 HttpClient 相關 JAR，重新打包部署至 OC4J，排程任務執行正常，錯誤日誌歸零。

經驗總結

1. 應用伺服器內建庫衝突 是 Java EE 部署常見痛點 (如 JAXP, JMX, Logging, HttpClient)；優先評估「JDK 原生是否足夠」。
2. 依賴極簡原則：能用標準 API 解決，就不引入第三方庫。
3. 類別載入器機制：OC4J/WebLogic/JBoss 皆為「父優先」，若必須用特定版第三方庫，需配置 class-loader 子優先或打包為共享庫，維護成本高。