OkHttp3 callTimeout超时设置未生效问题排查与解决求助

问题原因 #

1. OkHttp 4.2.0版本缺陷：该版本的callTimeout未覆盖完整调用生命周期，当连接池中空闲连接耗尽时，等待获取连接的时间不会被计入callTimeout，导致实际请求等待时间远超设置的400ms。
2. 超时参数覆盖不全：仅设置callTimeout，未配置connectTimeout、readTimeout等细分超时，若在TCP连接建立、响应读取阶段出现阻塞，也可能导致超时失效。

解决办法 #

1. 升级OkHttp版本 #

官方在OkHttp 4.3.0版本修复了callTimeout覆盖范围不全的问题，将连接池等待时间纳入超时计时。直接升级依赖到4.3.0及以上版本是最彻底的解决方案。

2. 补充配置多维度超时参数 #

在暂时无法升级版本的情况下，补充配置细分超时参数，并优化连接池设置，减少连接等待：

private static final OkHttpClient CLIENT = new OkHttpClient.Builder()
        .callTimeout(400, TimeUnit.MILLISECONDS)
        .connectTimeout(300, TimeUnit.MILLISECONDS) // TCP连接超时
        .readTimeout(300, TimeUnit.MILLISECONDS)    // 响应读取超时
        .writeTimeout(300, TimeUnit.MILLISECONDS)   // 请求写入超时
        .connectionPool(new ConnectionPool(5, 5, TimeUnit.MINUTES)) // 调整连接池大小，避免连接耗尽
        .build();

3. 增加代码层兜底超时 #

通过CompletableFuture给同步调用增加强制超时兜底，避免因OkHttp自身超时失效导致的长时间阻塞：

// 替换原同步调用逻辑
long startTime = System.currentTimeMillis();
CheckResultVO result;
try {
    result = CompletableFuture.supplyAsync(() -> {
        try (Response response = CLIENT.newCall(request).execute()) {
            long costTime = System.currentTimeMillis() - startTime;
            // 原响应处理逻辑（读取body、解析等）
            // 保持原有业务逻辑不变
        } catch (Exception e) {
            long costTime = System.currentTimeMillis() - startTime;
            // 原异常处理逻辑
        }
    }, Executors.newFixedThreadPool(10)) // 自定义线程池避免线程耗尽
    .get(400, TimeUnit.MILLISECONDS);
} catch (TimeoutException e) {
    long costTime = System.currentTimeMillis() - startTime;
    log.error("[call security openapi timeout] order: {} costTime: {}", order, costTime, e);
    doMetric(msgClass, costTime, SecurityExecuteMetricConstants.EXECUTE_TIMEOUT, length);
    return CheckResultVO.legal();
}

4. 排查外部服务状态 #

确认目标服务SECURITY_URL的网络可达性、DNS解析速度、服务响应状态，排除因外部服务异常导致的长时间等待。

内容的提问来源于stack exchange，提问作者思远陈