服务器响应超4分钟时OkHttpClient偶发Connection reset异常求助

该异常属于TCP层连接被主动断开导致的错误，和OkHttp应用层超时配置无关，核心触发原因如下：

• 近期网络链路中的中间设备（防火墙、NAT网关、外部服务端负载均衡）的空闲TCP连接回收阈值被下调至4分钟以内，超过该时长无数据传输的连接会被设备主动断开，且断开时不会通知通信两端，应用侧读写已被销毁的连接时就会抛出Connection reset错误。
• JVM默认未开启TCP层心跳保活机制，即便手动开启，Linux内核默认的tcp_keepalive_time参数为7200秒（2小时），远高于4分钟的阈值，无法在连接被回收前发送心跳包维持连接存活。
• curl请求正常是因为curl默认每次请求新建独立连接、请求结束立即销毁，不会复用空闲连接，不会触发中间设备的超时回收规则。

方案1：配置OkHttp开启TCP保活并禁用连接复用 #

修改OkHttpClient初始化逻辑，开启TCP心跳保活，同时可选禁用连接池复用，和curl逻辑对齐：

// 禁用连接池，每次请求新建连接
builder.connectionPool(new ConnectionPool(0, 1, TimeUnit.NANOSECONDS));
// 配置自定义套接字工厂开启TCP保活
builder.socketFactory(new SocketFactory() {
    private final SocketFactory defaultFactory = SocketFactory.getDefault();

    @Override
    public Socket createSocket() throws IOException {
        Socket socket = defaultFactory.createSocket();
        // 开启TCP保活
        socket.setKeepAlive(true);
        // Linux系统下调整保活参数
        try {
            Field implField = Socket.class.getDeclaredField("impl");
            implField.setAccessible(true);
            Object socketImpl = implField.get(socket);
            Method setOptMethod = SocketImpl.class.getDeclaredMethod("setOption", int.class, Object.class);
            setOptMethod.setAccessible(true);
            // 空闲30秒后开始发送心跳包
            setOptMethod.invoke(socketImpl, 4 /* TCP_KEEPIDLE */, 30);
            // 每10秒发送一次心跳
            setOptMethod.invoke(socketImpl, 5 /* TCP_KEEPINTVL */, 10);
            // 3次心跳无响应判定连接失效
            setOptMethod.invoke(socketImpl, 6 /* TCP_KEEPCNT */, 3);
        } catch (Exception ignore) {
            // 非Linux系统可忽略该配置
        }
        return socket;
    }

    @Override
    public Socket createSocket(String host, int port) throws IOException {
        return defaultFactory.createSocket(host, port);
    }

    @Override
    public Socket createSocket(String host, int port, InetAddress localHost, int localPort) throws IOException {
        return defaultFactory.createSocket(host, port, localHost, localPort);
    }

    @Override
    public Socket createSocket(InetAddress host, int port) throws IOException {
        return defaultFactory.createSocket(host, port);
    }

    @Override
    public Socket createSocket(InetAddress address, int port, InetAddress localAddress, int localPort) throws IOException {
        return defaultFactory.createSocket(address, port, localAddress, localPort);
    }
});

方案2：调整系统内核TCP参数（全量生效） #

如果有权限修改部署服务器的内核配置，可修改/etc/sysctl.conf添加以下配置：

net.ipv4.tcp_keepalive_time = 30
net.ipv4.tcp_keepalive_intvl = 10
net.ipv4.tcp_keepalive_probes = 3

修改后执行sysctl -p即可生效，全系统所有TCP连接都会使用该保活规则。

方案3：调整网络设备配置 #

联系运维人员确认中间网络设备、外部服务端的空闲连接回收阈值，将阈值调整到5分钟以上，从根源避免连接被提前回收。

Java调用curl异常处理 #

如果使用Java子进程调用curl也出现异常，可在curl命令中添加--keepalive-time 30参数显式指定心跳间隔，确认问题是否解决。

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