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,保持默认即可
- 如果站点使用HTTP协议访问,不要配置
- 如果使用反向代理,确认代理配置正确透传了Cookie头,没有修改Cookie的域、路径属性。
内容的提问来源于stack exchange,提问作者mi0
相关产品推荐
相关产品推荐

