Java WebSocket会话超时：setMaxIdleTimeout(-1)无效，求排查方案

你已经在服务端设置了setMaxIdleTimeout(-1L)禁用空闲超时，但连接还是会在1-2分钟后断开，这大概率不是代码本身的问题，而是中间件、网络设备或客户端层面的限制导致的。下面分点给你分析和解决办法：

1. 优先排查中间件/负载均衡的超时配置 #

这是最常见的原因！如果你的WebSocket服务部署在Nginx、Apache、AWS ALB这类反向代理后面，这些中间件通常有自己的连接超时规则，优先级可能高于服务端代码配置：

• Nginx：默认proxy_read_timeout是60秒，超过时间无数据传输就会主动断开。需要在配置中修改：

  location /ws {
      proxy_pass http://your-websocket-server;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      proxy_read_timeout 86400s; # 设置足够长的时间，比如1天
      proxy_send_timeout 86400s;
  }
  

• AWS ALB：默认空闲超时60秒，需要在控制台把目标组的空闲超时调整到更长时间（最长1小时）。

2. 给客户端添加心跳机制 #

即使服务端禁用了超时，网络中的路由器、防火墙或部分浏览器也会主动断开长时间无流量的连接。解决办法是让客户端定期发送心跳包，保持连接活跃：

let websocket;
let heartbeatTimer;

// 初始化连接
function initWebSocket() {
  websocket = new WebSocket("wss://dummy.org");
  
  websocket.onopen = () => {
    console.log("WebSocket连接成功");
    // 每30秒发送一次心跳包
    heartbeatTimer = setInterval(() => {
      if (websocket.readyState === WebSocket.OPEN) {
        websocket.send("ping"); // 用任意标识心跳的消息即可
      }
    }, 30000);
  };

  websocket.onmessage = onMessage;

  websocket.onclose = (event) => {
    console.log(`连接关闭，状态码：${event.code}，原因：${event.reason}`);
    clearInterval(heartbeatTimer);
    // 延迟重连，避免频繁请求
    setTimeout(initWebSocket, 5000);
  };

  websocket.onerror = (error) => {
    console.error("WebSocket错误：", error);
  };
}

// 初始化连接
initWebSocket();

// 你的消息处理函数
function onMessage(event) {
  const message = event.data;
  // 服务端回应pong时无需处理，仅确认连接正常
  if (message === "pong") return;
  // 处理业务消息逻辑
  console.log("收到消息：", message);
}

对应的，服务端可以选择性回应心跳（也可忽略，只要有流量传输即可）：

@OnMessage
public void onMessage(String message, Session session) throws IOException {
  if ("ping".equals(message)) {
    // 回应pong，让客户端确认连接状态
    session.getBasicRemote().sendText("pong");
  } else {
    // 处理你的业务逻辑
  }
}

3. 检查服务端框架的全局超时配置 #

如果你用Tomcat、Jetty这类Java Web框架，它们可能有全局WebSocket超时设置，会覆盖会话级配置：

• Tomcat：检查conf/server.xml中Connector标签的connectionTimeout或专属WebSocket超时配置。
• Jetty：查看jetty-websocket.xml里的idleTimeout，确认全局设置没有强制短超时。

4. 完善重连逻辑细节 #

你已经尝试了重连，注意几个容易踩的坑：

• 重连时必须重新创建WebSocket实例，并重新绑定所有事件（onmessage、onclose等），避免旧实例事件绑定失效。
• 添加重连退避策略（比如第一次5秒，第二次10秒，最多到30秒），避免给服务端造成压力。
• 在onclose中判断状态码，比如1000（正常关闭）可以选择不重连，减少不必要的重试。

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