【零门槛免费】Spring Boot WebSocket 聊天室:多人群聊与一对一私聊的完整跑通教程
【零门槛免费】Spring Boot WebSocket 聊天室:多人群聊与一对一私聊的完整跑通教程
一个基于 Spring Boot 的 WebSocket 聊天室项目:服务端一个端点同时支撑多人在线聊天和一对一私聊,浏览器打开就能发消息。适合想看懂实时通信链路、又需要一个可二开底子的 Java 开发者。
什么时候用得上
团队内部同步。不想为几十人的小团队上一整套 IM,但又卡在"网页不刷新就收不到新消息"上——每刷新一次,上下文断一次。这个项目里每人开一个 public.html,后端把每条消息广播给全部在线会话,谁发言,其他人的页面立刻出现,不用任何人手动刷。
在线课堂互动。老师抛题、学生抢答,这种高频短消息用轮询很亏:客户端每隔一两秒问一次"有没有新消息",大多数请求空手而归。WebSocket 握手后连接一直保持,消息一到直接推到页面,随堂问答的节奏跟得上。
一对一客服或私信。难点不是收发,而是消息只能让双方看到。仓库里 wukong.html 和 bajie.html 两个页面就是为这个准备的:两个浏览器窗口各开一个,消息经后端按用户编号定向投递,不走公共广播,可以直接当私聊最小实现来读。
背后是怎么跑通的
先看推送为什么成立。HTTP 轮询是客户端反复发问,延迟卡在两次轮询间隔里;WebSocket 在初始 HTTP 握手里升级为一条持久连接,之后服务器随时能往这条连接写数据,客户端不用再开口。
完整工程在 demo.zip 里,解压就是一个标准 Maven 项目。Spring Boot 承担的是容器和装配:WebSocketConfig 注册 ServerEndpointExporter,让标准端点能挂进 Spring 容器;真正干活的是 MyWebSocket——@ServerEndpoint 声明 /websocket/{userno} 端点,用一个静态 ConcurrentHashMap 存每个在线用户的会话,收到消息后按用户编号定向发送,在线人数由 onlineCount 计数。前后端分工很薄:后端只做端点收发和会话管理,前端是 public.html 这类静态页,用原生 JavaScript 调 WebSocket API 收发并渲染消息。
自己动手跑一遍
本地装好 JDK 1.8 和 Maven 后:
git clone https://gitcode.com/open-source-toolkit/7eac9
unzip demo.zip && ./mvnw spring-boot:run
浏览器打开 http://localhost:8080/public.html 进群聊;一对一则在两个窗口分别打开 wukong.html 和 bajie.html。也可以按 README.md 的说法,用 IntelliJ IDEA 打开解压后的工程直接运行 DemoApplication,效果一样。
做得好的,以及还没做好的
做得好的:
- 消息直达不刷新,客户端没有轮询开销,上下线时在线数实时变化;
- 群聊与一对一两种会话并存,端点设计统一,加新的聊天类型基本只需加页面;
- 后端只有四个 Java 文件,核心收发逻辑几十行,读一遍就知道整条链路。
还没做好的:
- 版本偏旧:Spring Boot 2.0.4.RELEASE 配 Java 8,2.0 这条线已停止维护。当学习或原型用没问题,上生产要先升级依赖;
- 会话状态全在内存里,在线数和连接表都是静态字段,多实例部署做负载均衡会丢消息,需要换成外置存储或 STOMP 这类方案。
和社区一起玩
项目采用 MIT 许可(见 LICENSE),商用和二次分发都自由。跑不通的地方或功能想法,直接提 Issues;愿意动手的,fork 后提 Pull Request——把会话状态挪到 Redis、把静态页重写成 Vue,都是现成的切入点。
先把 demo.zip 解压跑起来,让两个窗口把消息对上,再把它改成自己想要的样子。