You need to enable JavaScript to run this app. Spring Boot集成WebSocket打包WAR部署独立Tomcat握手会话不一致问题
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot集成WebSocket打包WAR部署独立Tomcat握手会话不一致问题

问题根因
  • 上下文路径不匹配:内嵌Tomcat默认使用根路径/部署应用,WAR包部署到独立Tomcat时通常会带应用上下文路径(例如/myapp),如果前端WebSocket连接地址没有补全上下文路径,握手请求会无法匹配原应用的会话Cookie,导致Tomcat为请求分配新的会话。
  • 会话获取逻辑问题:现有拦截器中调用无参getSession()方法,该方法在当前请求没有匹配到已有会话时会自动创建新会话,因此你排查时看到的新会话ID实际是这个逻辑自动生成的,并不是WebSocket真的没有携带原会话Cookie。
  • Tomcat会话Cookie配置差异:独立Tomcat可能存在自定义的会话Cookie配置(例如开启Secure属性、修改SameSite策略、自定义Cookie路径),如果配置和当前站点的访问协议、路径不匹配,会导致原会话Cookie无法在WebSocket握手时被携带。
解决方案
  • 修正前端WebSocket连接地址:WAR包部署后,需要在连接地址前补全应用的上下文路径,例如上下文为/myapp时,连接地址应为ws://{域名}:{端口}/myapp/ws-endpoint。
  • 调整拦截器的会话获取逻辑:将无参getSession()改为带false参数的重载方法,避免不存在会话时自动创建新会话,同时增加会话非空判断:
@Override
public boolean beforeHandshake(ServerHttpRequest request, ServerHttpResponse response, WebSocketHandler wsHandler,
        Map attributes) throws Exception {
    if (request instanceof ServletServerHttpRequest) {
        ServletServerHttpRequest servletRequest = (ServletServerHttpRequest) request;
        // 传入false表示不存在会话时直接返回null,不自动创建
        HttpSession session = servletRequest.getServletRequest().getSession(false);
        if (session == null) {
            // 无有效会话直接终止握手,避免后续空指针
            return false;
        }
        System.out.println(session.getId());
        attributes.put(AppVariables.MODEL_PARAM_SESSION, session.getAttribute(AppVariables.MODEL_PARAM_SESSION));
    }
    return true;
}
  • 检查独立Tomcat的会话Cookie配置:打开Tomcat安装目录下conf/context.xml,确认没有不合理的会话Cookie配置:
    • 如果站点使用HTTP协议访问,不要配置sessionCookieSecure="true",否则HTTP请求不会携带会话Cookie
    • 不要配置和应用上下文不匹配的sessionCookiePath,保持默认即可
  • 如果使用反向代理,确认代理配置正确透传了Cookie头,没有修改Cookie的域、路径属性。

内容的提问来源于stack exchange,提问作者mi0

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 22:06:04