升级Java 21与Spring Boot 3.3后OKHTTP客户端异常求助

从堆栈信息分析，核心问题是HTTP/2流被远端以CANCEL状态重置，同时触发了OkHttp的超时逻辑。升级到Java 21虚拟线程后出现该问题，大概率和虚拟线程的调度特性、OkHttp默认连接池/线程池与虚拟线程的适配性有关。以下是针对性的配置建议和排查方案：

一、细化OkHttp超时配置 #

原配置仅设置了连接和读超时，缺少写超时和全局调用超时，虚拟线程的调度延迟可能导致IO等待的超时触发逻辑误判。调整后覆盖请求全生命周期：

OkHttpClient httpClient = OkHttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(10))
        .readTimeout(Duration.ofSeconds(15)) // 适当延长读超时，适配虚拟线程调度延迟
        .writeTimeout(Duration.ofSeconds(10)) // 新增写超时，覆盖请求体发送阶段
        .callTimeout(Duration.ofSeconds(30)) // 新增全局调用超时，避免单阶段超时遗漏
        .build();

二、适配虚拟线程调整OkHttp线程池与连接池 #

OkHttp默认的Dispatcher线程池是平台线程，和虚拟线程搭配会出现调度不匹配；默认连接池的参数也可能不适合虚拟线程场景下的高并发：

// 用虚拟线程池替换OkHttp默认的平台线程池
Dispatcher dispatcher = new Dispatcher(Executors.newVirtualThreadPerTaskExecutor());
dispatcher.setMaxRequests(64); // 调高全局最大请求数，适配虚拟线程高并发特性
dispatcher.setMaxRequestsPerHost(16); // 单主机最大请求数，匹配HTTP/2默认并发流限制

// 调整连接池参数，延长空闲连接存活时间，减少重建开销
ConnectionPool connectionPool = new ConnectionPool(
        5,
        30, TimeUnit.MINUTES,
        Executors.newVirtualThreadPerTaskExecutor() // 连接池清理任务用虚拟线程
);

OkHttpClient httpClient = OkHttpClient.newBuilder()
        .dispatcher(dispatcher)
        .connectionPool(connectionPool)
        // 加上前面的超时配置
        .build();

三、临时禁用HTTP/2确认问题根源 #

如果禁用HTTP/2后异常消失，说明问题出在HTTP/2与虚拟线程的交互上，后续可针对性调整HTTP/2参数（比如并发流数、帧大小）：

OkHttpClient httpClient = OkHttpClient.newBuilder()
        .protocols(List.of(Protocol.HTTP_1_1)) // 强制使用HTTP/1.1
        // 其他配置
        .build();

四、开启OkHttp详细日志定位远端重置原因 #

线上无法复现的情况下，通过日志拦截器收集请求/响应全量信息，包括HTTP/2帧数据，能帮排查远端重置流的真实原因（比如后端服务超时、负载过高、防火墙截断）：

HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor(
        msg -> LoggerFactory.getLogger("OkHttp-Detailed").info(msg)
);
loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY); // 开启全量日志

OkHttpClient httpClient = OkHttpClient.newBuilder()
        .addInterceptor(loggingInterceptor)
        // 其他配置
        .build();

五、调整虚拟线程JVM调度参数 #

通过JVM参数优化虚拟线程的调度能力，避免因调度延迟导致OkHttp超时误判：

# 根据CPU核心数调整并行度，比如8核机器设为8
-Djdk.virtualThreadScheduler.parallelism=8
# 调整虚拟线程池最大容量，避免调度阻塞
-Djdk.virtualThreadScheduler.maxPoolSize=1000

额外排查建议 #

线上开启请求采样追踪（比如Micrometer+Zipkin），记录虚拟线程的调度耗时和OkHttp请求各阶段的时间线，确认是否是调度延迟导致的超时触发。

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