WebSocket多节点集群部署难点 解决WebSocket Session同步问题【方案】

月夜之吻

月夜之吻

2026-05-30

787人浏览

原创

websocketsession不可序列化是设计限制,因其持有tcp连接等jvm特有资源;正确方案是本地内存管理会话+redis pub/sub广播消息,各节点监听后按需推送。

websocket多节点集群部署难点 解决websocket session同步问题【方案】

WebSocket Session 无法跨节点同步,不是配置问题,而是设计限制 —— WebSocketSession 对象本身不可序列化,任何试图把它存进 Redis、MySQL 或通过 gRPC 传给其他节点的做法都会失败。

为什么不能直接序列化 WebSocketSession

它内部持有了底层 TCP 连接、线程上下文、Servlet 容器引用等 JVM 特定资源,这些对象在反序列化时无法重建连接状态。强行序列化会导致 NotSerializableException 或运行时 NullPointerException。Spring Boot 的 StandardWebSocketSession 和 Tomcat 的 WsSession 都明确不实现 Serializable 接口。

  • 即使你用 @EnableWebSocketMessageBroker + STOMP,SimpMessageSendingOperations.convertAndSendToUser() 也只在单节点内有效
  • Redis 存储 sessionId → userId 映射可行,但绝不能存 WebSocketSession 实例本身
  • 集群中每个节点必须只管理自己建立的连接,这是底线

正确做法:本地会话 + Redis Pub/Sub 广播

消息发送方不找目标 session,而是广播;所有节点监听频道,各自判断“这条消息是否该推给我本地的某个用户”。这是目前 Spring Boot 2.7+ JDK 8 下最稳定、零依赖 MQ 的方案。

php中将session保存到数据库的函数类代码
php中将session保存到数据库的函数类代码

php中将session保存到数据库的函数类代码

下载
  • 每个节点用 ConcurrentHashMap<string websocketsession></string> 管理本机连接(保留你原有逻辑)
  • 发送消息前,查 Redis 获取目标 userId 对应的所有 sessionId(可选),但更推荐直接广播 + 本地过滤
  • redisTemplate.convertAndSend("ws:topic:msg", payload) 发布消息
  • 每个节点订阅 "ws:topic:msg",收到后遍历本地 WebSocketSession,用 session.getAttributes().get("userId") 匹配再推送

gRPC 或 HTTP 节点间直连转发?慎用

gowebsocket 那样用 gRPC 让 A 节点调 B 节点的接口去发消息,看似精准,实则引入新风险:

  • 节点下线或网络抖动时,gRPC UNAVAILABLE 导致消息丢失,需重试+持久化,复杂度陡增
  • HTTP 转发(如 RestTemplate 调用另一节点的 /ws/push)同样面临超时、重试、幂等难题
  • 相比 Pub/Sub 的“尽力送达+本地兜底”,直连模式把可靠性压力全压在通信链路上

Nginx 配置必须开启 sticky session(IP Hash)

这不是可选项,是避免消息乱序和重复连接的前提。WebSocket 握手是 HTTP 升级请求,Nginx 必须保证同一用户的后续帧始终打到同一台后端节点:

upstream ws_backend {
    ip_hash;  # 关键!不能用 round-robin
    server 10.0.1.10:8089;
    server 10.0.1.11:8089;
}
  • 若用 least_connhash $cookie_jsessionid,用户重连可能落到新节点,旧 session 已失效,造成“已登录却收不到消息”
  • SSL 终结在 Nginx 时,wss:// 请求仍走 IP Hash,无需额外透传 header
  • 此配置仅保障连接粘性,不解决跨节点消息分发 —— 广播逻辑仍不可少

真正容易被忽略的是:广播消息体里必须携带 userIdmessageId,否则多个节点同时推送会造成客户端重复渲染;而 messageId 的去重必须在前端做,后端只负责投递一次。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

1349

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

1536

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

692

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

551

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

909

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

1128

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

1663

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

5538

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

420

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebSocket手册
WebSocket手册

共0课时 | 0人学习

Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习