Java「Cannot inherit from final class」類衝突排查：HttpClient 4.x 多版本 Jar 包導致驗證錯誤

錯誤堆疊核心

Caused by: java.lang.VerifyError: Cannot inherit from final class
at org.apache.http.impl.client.DefaultHttpClient.createHttpParams(DefaultHttpClient.java:161)
at com.jp2p.yibao.util.httpclient.HttpClient4Util.(HttpClient4Util.java:88)

根因：類路徑存在多版本 HttpClient 導致「菱形繼承」驗證失敗

• `DefaultHttpClient` (4.5.x) 繼承 `AbstractHttpClient` (4.3+)
  - 4.3 引入 `final class HttpParams`，4.5 中 `DefaultHttpClient.createHttpParams()` 返回 `HttpParams`
  - 若 classpath 同時載入 **4.2.x (無 final HttpParams) 與 4.5.x (final HttpParams)**，JVM 驗證器發現子類試圖繼承/實現不兼容的父類簽名 → `VerifyError`

排查步驟

1. 檢視所有 HttpClient 相關 Jar：
   `mvn dependency:tree | grep httpclient` (Maven)
   `gradle dependencies --configuration compileClasspath | grep httpclient` (Gradle)
2. 典型衝突組合：
   `httpclient-4.2.5.jar` + `httpclient-4.5.13.jar`
   `httpcore-4.2.4.jar` + `httpcore-4.4.14.jar`
3. 統一版本 (推薦 4.5.13 最後維護版)：
   

   <dependencyManagement>
     <dependency>
       <groupId>org.apache.httpcomponents</groupId>
       <artifactId>httpclient</artifactId>
       <version>4.5.13</version>
     </dependency>
     <dependency>
       <groupId>org.apache.httpcomponents</groupId>
       <artifactId>httpcore</artifactId>
       <version>4.4.14</version>
     </dependency>
   </dependencyManagement>

4. 排除傳遞依賴：
   

   <dependency>
     <groupId>com.thirdparty</groupId>
     <artifactId>some-lib</artifactId>
     <exclusions>
       <exclusion><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId></exclusion>
     </exclusions>
   </dependency>

5. 清理部署目錄：`mvn clean` / 刪除 `WEB-INF/lib` 手動複製的舊 Jar

代碼層面修正 (HttpClient4Util.java:88)

// ❌ 舊寫法 (4.2 風格)
HttpClient client = new DefaultHttpClient();
client.getParams().setParameter(CoreConnectionPNames.SO_TIMEOUT, timeout);

// ✅ 4.5+ 推薦：RequestConfig + Builder 模式
RequestConfig config = RequestConfig.custom()
    .setConnectTimeout(5000)
    .setSocketTimeout(timeout)
    .setConnectionRequestTimeout(5000)
    .build();
HttpClient client = HttpClientBuilder.create()
    .setDefaultRequestConfig(config)
    .build();

避坑指南

總結

**`VerifyError: Cannot inherit from final class` 99% 由 HttpClient 多版本共存引起**。統一依賴版本至 4.5.13、遷移至 `RequestConfig` API、啟用 `dependencyManagement` 強制版本，徹底根治。