【独家整理】Spring Boot WebSocket 聊天室实战:群聊到一对一私聊,开箱即用

原创2026-11-11 23:51:111,869 阅读

【独家整理】Spring Boot WebSocket 聊天室实战:群聊到一对一私聊,开箱即用

想给应用加实时聊天,还在靠页面轮询?这个项目可以直接跑起来看效果。Spring Boot WebSocket 聊天室接好了端点、配好了三个页面,多人聊天和单人聊天两种玩法,克隆下来就能验证。

🧩 它是什么,解决什么问题

这是一个基于 Spring Boot 和 WebSocket 的聊天室应用,面向想快速搞懂双向通信、又需要现成可运行示例的开发者。核心能力是两条:多人同房间收发消息,以及指定用户之间的一对一私聊。仓库里 demo.zip 打包了完整源码,导入 IDE 即可运行,不依赖额外的中间件。

核心功能拆解

多人会话:开几个标签页,消息立刻流转

多人聊天入口是 public.html,页面打开后自动生成形如"风清扬+随机数"的昵称并连上服务器。你可以在本地开多个浏览器标签页,各自发消息,其他页面无需刷新就能看到新消息——这是演示多人场景最快的方式。

单人私聊:两个固定页面,消息只发给对方

单人聊天提供了 wukong.html 和 bajie.html 两个固定页面,模拟两人对话。服务端收到消息后按昵称(nickname/nickname2)在连接表里查对端,只对双方投递,并给各自打上 isSelf 标记,前端据此把消息显示在左右两侧。

连接管理:上线下线自动计数

端点用 @OnOpen 和 @OnClose 维护了一个静态的在线人数计数,每次有人加入或断开都会打印当前在线数,方便你观察连接状态,也省去了自己写这部分代码的功夫。

⚙️ 技术实现速览

技术 承担的角色 选型理由
Spring Boot 2.0.4 后端框架,托管 8080 端口 自动配置,导入 Maven 项目直接运行
spring-boot-starter-websocket 实时通信核心 全双工推送,服务端主动下发消息
Java 8 + json-lib 消息组装与 JSON 序列化 轻量,客户端消息格式统一为 JSON
jQuery + Amaze UI 聊天页面 UI 纯静态页面,前端零构建

数据流向很短:浏览器执行 new WebSocket("ws://localhost:8080/websocket/" + 昵称) 建立连接 → @ServerEndpoint("/websocket/{userno}") 标注的 MyWebSocket 用 @OnMessage 收消息 → ConcurrentHashMap 按用户标识找到对端连接并 sendMessage → 页面拿到 JSON(nickname/date/content/isSelf)后渲染气泡。

配置类只注册了一个 ServerEndpointExporter Bean,整个服务端逻辑集中在一个文件里,读起来没有负担。

🎯 适合哪些场景

  • 课堂演示与学习 —— 一个文件读懂 WebSocket 端点的完整生命周期
  • 团队群聊原型 —— 验证消息实时性,再往登录、房间上扩展
  • 一对一客服 Demo —— 参考私聊的双向投递写法
  • 二次开发基线 —— 代码结构简单,加认证、换存储成本低

🚀 快速上手,三步跑起来

  1. 克隆仓库:git clone https://gitcode.com/open-source-toolkit/7eac9
  2. 解压 demo.zip,用 IntelliJ IDEA 或 Eclipse 导入这个 Maven 项目(需 Java 8 与 Maven)
  3. 运行 DemoApplication,浏览器打开:多人聊天 http://localhost:8080/public.html,单人聊天 http://localhost:8080/wukong.html 与 http://localhost:8080/bajie.html

仓库内资料:README.md 写有使用说明,demo.zip 是完整源码包(含 pom.xml 与全部页面),LICENSE 是许可文本。

🤝 参与与社区

项目采用 MIT 许可证,可自由使用和修改。作者已注明"登录等功能待后续完善",这是现成的入手点。有问题或想法直接在 Issues 里提,也欢迎提交 Pull Request。

去仓库把项目跑一遍,卡住了就把报错贴到 Issue 里,顺便看看私聊那段 sendToUser 的实现。

登录后查看全文
SpringBootWebSocket聊天室多人聊天单人聊天