如何在不修改第三方库的情况下解决IBM JDK中HttpClient调用失败问题

问题概述 #

第三方库基于Apache HttpClient 5.5.4，内部调用HttpClients.createDefault()方法，在IBM JDK环境下执行HTTPS请求时抛出如下错误：

Caused by: java.lang.UnsupportedOperationException: The method shutdownOutput() is not supported in SSLSocket
    at com.ibm.jsse2.au.shutdownOutput(au.java:58)
    at org.apache.hc.core5.http.impl.io.BHttpConnectionBase.close(BHttpConnectionBase.java:252)
    at org.apache.hc.core5.http.impl.io.DefaultBHttpClientConnection.close(DefaultBHttpClientConnection.java:71)
    at org.apache.hc.client5.http.impl.io.DefaultManagedHttpClientConnection.close(DefaultManagedHttpClientConnection.java:176)
    at org.apache.hc.core5.pool.PoolEntry.discardConnection(PoolEntry.java:180)
    at org.apache.hc.core5.pool.StrictConnPool$PerRoutePool.shutdown(StrictConnPool.java:839)
    at org.apache.hc.core5.pool.StrictConnPool.close(StrictConnPool.java:142)
    at org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager.close(PoolingHttpClientConnectionManager.java:277)
    at org.apache.hc.client5.http.impl.classic.InternalHttpClient.close(InternalHttpClient.java:198)
    at org.apache.hc.client5.http.impl.classic.InternalHttpClient.close(InternalHttpClient.java:188)

因无法修改第三方库代码、无法传入自定义HttpClient实例，且使用HttpClient的类为final类，以下提供除fork库之外的可行解决方案：

可行解决方案 #

1. 通过JVM系统属性强制启用系统属性配置 #

添加JVM启动参数，让HttpClient默认配置自动适配系统属性（等效于useSystemProperties()），绕过IBM JSSE的shutdownOutput()限制：

-Dorg.apache.hc.client5.http.useSystemProperties=true

该属性会让HttpClient加载系统层面的SSL配置，同时调整连接处理逻辑以兼容IBM JDK的JSSE实现。

2. 替换JSSE实现 #

通过JVM参数强制使用兼容shutdownOutput()的JSSE实现，替代IBM默认的JSSE：

# 方案一：指定IBM JSSE的兼容实现
-Djavax.net.ssl.SSLSocketFactory=com.ibm.jsse2.SSLSocketFactoryImpl
# 方案二：使用OpenJDK的JSSE实现（需确保类路径包含对应依赖）
-Djavax.net.ssl.SSLSocketFactory=sun.security.ssl.SSLSocketFactoryImpl

3. 字节码增强动态修改HttpClient实例 #

借助ByteBuddy、ASM等字节码增强工具，在应用启动时通过Agent注入逻辑，将第三方库中HttpClients.createDefault()的调用替换为HttpClients.custom().useSystemProperties().build()：
示例（ByteBuddy）：

new ByteBuddy()
  .redefine(ThirdPartyFinalClass.class)
  .method(ElementMatchers.named("getHttpClient"))
  .intercept(FixedValue.value(HttpClients.custom().useSystemProperties().build()))
  .make()
  .load(ThirdPartyFinalClass.class.getClassLoader(), ClassReloadingStrategy.fromInstalledAgent());

此方式无需修改第三方库源码，仅在运行时动态调整类行为。

4. 调整连接关闭策略 #

通过系统属性禁用连接关闭时的shutdownOutput()调用（需确认HttpClient 5.5.4支持该属性）：

-Dorg.apache.hc.core5.http.impl.io.BHttpConnectionBase.close.shutdownOutput=false

该参数会让连接直接关闭Socket，跳过shutdownOutput()步骤，避免触发IBM JSSE的不支持异常。

内容的提问来源于stack exchange，提问作者solutionsDeveloper