news 2026/7/21 2:53:09

WebSocket 消息推送:Spring Boot + Vue3 实现一个“网页版即时聊天室”(附源码)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
WebSocket 消息推送:Spring Boot + Vue3 实现一个“网页版即时聊天室”(附源码)

💬 前言:为什么轮询 (Polling) 被淘汰了?

在 Web 1.0 时代,如果我们要实现“收到新消息提醒”,通常只能让前端每隔 2 秒发一次 HTTP 请求问后端:“有新消息吗?”
这叫短轮询

  • 缺点:服务器压力大,99% 的请求都是无用的,且消息有延迟。

到了 Web 2.0,WebSocket横空出世。
它像一条**“专线管道”,一旦建立连接,服务器就可以主动**把消息推给前端。

  • 优点:零延迟,服务器资源消耗极低,全双工通讯。

今天,我们就用最主流的Spring Boot + Vue3,在 30 分钟内手撸一个多人在线聊天室!


🏗️ 系统架构:一条永不断的线

我们要实现的功能:

  1. 用户登录(输入昵称)。
  2. 进入群聊,显示在线人数。
  3. 发送消息,所有人(包括自己)实时收到。

架构设计图:

WebSocket_Server_内存
1. 建立 WS 连接
1. 建立 WS 连接
2. 发送消息 Hello
3. 查找所有在线 Session
4. 推送消息
4. 推送消息
ConcurrentHashMap Session池
用户 A Vue3
Spring Boot 后端
用户 B Vue3

💻 后端实战:Spring Boot + WebSocket

不需要 Netty,Spring Boot 自带的 WebSocket 模块足够应对中小规模场景。

1. 引入依赖
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-websocket</artifactId></dependency>
2. 开启支持 (WebSocketConfig.java)
@ConfigurationpublicclassWebSocketConfig{@BeanpublicServerEndpointExporterserverEndpointExporter(){returnnewServerEndpointExporter();}}
3. 核心服务 (WebSocketServer.java)

这是整个聊天室的心脏。

@ServerEndpoint("/ws/{username}")// 前端连接地址: ws://localhost:8080/ws/张三@Component@Slf4jpublicclassWebSocketServer{// 存放每个客户端对应的 WebSocketServer 对象privatestaticConcurrentHashMap<String,Session>onlineSessions=newConcurrentHashMap<>();@OnOpenpublicvoidonOpen(Sessionsession,@PathParam("username")Stringusername){onlineSessions.put(username,session);broadcast("系统消息: 欢迎用户 ["+username+"] 加入群聊!");}@OnClosepublicvoidonClose(@PathParam("username")Stringusername){onlineSessions.remove(username);broadcast("系统消息: 用户 ["+username+"] 已离开。");}@OnMessagepublicvoidonMessage(Stringmessage,Sessionsession,@PathParam("username")Stringusername){// 收到消息,转发给所有人broadcast("【"+username+"】: "+message);}// 群发消息辅助方法privatevoidbroadcast(Stringmsg){onlineSessions.forEach((user,session)->{try{session.getBasicRemote().sendText(msg);}catch(IOExceptione){e.printStackTrace();}});}}

🎨 前端实战:Vue 3 Composition API

Vue3 写 WebSocket 简直不要太丝滑。

<template><divclass="chat-box"><divclass="msg-list"ref="msgRef"><divv-for="msg in msgList":key="msg">{{ msg }}</div></div><divclass="input-area"><inputv-model="inputMsg"placeholder="输入消息..."/><button@click="sendMsg">发送</button></div></div></template><scriptsetup>import{ref,onMounted,onUnmounted}from'vue';constusername='User_'+Math.floor(Math.random()*1000);constsocketUrl=`ws://localhost:8080/ws/${username}`;constmsgList=ref([]);constinputMsg=ref('');letws=null;onMounted(()=>{initWebSocket();});constinitWebSocket=()=>{ws=newWebSocket(socketUrl);ws.onopen=()=>{msgList.value.push("✅ 连接服务器成功...");};ws.onmessage=(event)=>{// 收到后端推送的消息msgList.value.push(event.data);};};constsendMsg=()=>{if(ws&&inputMsg.value){ws.send(inputMsg.value);inputMsg.value='';}};onUnmounted(()=>{if(ws)ws.close();// 页面销毁时断开连接});</script>

🛡️ 进阶挑战:心跳检测与断线重连

在真实生产环境中,网络是不稳定的。如果用户断网了,WebSocket 连接会“假死”。
你需要实现心跳机制 (Heartbeat)

  1. Ping/Pong:前端每隔 30 秒发送一个 “PING”,后端回复 “PONG”。
  2. 断线重连:前端监听ws.onclose事件,如果非主动断开,则在 5 秒后尝试重新new WebSocket()

(这部分代码在下方的源码中均有体现)


🎁 源码推荐与下载

如果你想看企业级的 IM 架构(支持千万级并发、集群部署、Redis 存储离线消息),那么仅仅看 Spring Boot 原生 WebSocket 是不够的,你需要引入Netty

我为你精选了一个 GitHub 上1.4万+ Star的神级项目,它是 Java 领域即时通讯的标杆。

开源项目:CIM (Cross-platform Instant Messaging)

  • GitHub 地址https://github.com/crossoverJie/cim
  • 推荐理由
    1. 基于Netty + Spring Boot + Redis构建,性能吊打原生 WebSocket。
    2. 代码结构清晰,包含命令行客户端、Web 客户端、安卓客户端。
    3. 文档极其详细,适合做毕业设计或企业内部通讯系统的底座。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/7/17 16:24:25

Apache Mesos集群运维实战:故障恢复与版本管理完全指南

Apache Mesos集群运维实战&#xff1a;故障恢复与版本管理完全指南 【免费下载链接】mesos Apache Mesos 项目地址: https://gitcode.com/gh_mirrors/mesos2/mesos 在现代分布式系统中&#xff0c;Mesos集群维护是确保业务连续性的关键环节。本指南将深入解析Mesos集群运…

作者头像 李华
网站建设 2026/7/19 23:25:26

探索式测试的Session管理法:提升软件测试效率与可追溯性

探索式测试作为一种强调测试者自主性与创造性的软件测试方法&#xff0c;在快速迭代的现代开发环境中日益重要。然而&#xff0c;其非结构化的特性可能导致测试过程难以追踪和评估。Session管理法应运而生&#xff0c;它通过引入时间盒&#xff08;Time-boxed&#xff09;会话和…

作者头像 李华
网站建设 2026/7/17 23:59:21

购物省钱参考:爱创猫电商优惠券领取方式

外卖网购“隐形开支”太多&#xff1f;这份极致省钱手册&#xff0c;让你每月轻松多省几百块你有没有算过&#xff0c;自己每个月花在外卖和网购上的钱有多少&#xff1f;打开手机账单&#xff0c;那些十几二十块的外卖订单&#xff0c;几十上百的“凑单”商品&#xff0c;看似…

作者头像 李华
网站建设 2026/7/20 13:43:25

12、Red Hat Enterprise Linux硬件分析与管理指南

Red Hat Enterprise Linux硬件分析与管理指南 1. RPM包安装与信息查看 在安装示例包时,如果未安装 vpnc 包,会显示如下错误: error: Failed dependencies: vpnc is needed by startvpn-1.1-1.noarch若要强制安装该包以测试从示例中构建的软件包,可使用以下命令: r…

作者头像 李华
网站建设 2026/7/20 23:11:39

35、Linux 内核监控与调试:NUMA、AltSysRq 及 Kdump 全解析

Linux 内核监控与调试:NUMA、AltSysRq 及 Kdump 全解析 在 Linux 系统的运维和管理中,对内核的监控与调试至关重要。本文将深入探讨 NUMA 统计信息、AltSysRq 系统请求以及 Kdump 内核转储工具的使用,帮助你更好地理解和管理 Linux 内核。 1. NUMA 统计信息 NUMA(Non-Un…

作者头像 李华
网站建设 2026/7/19 16:24:32

DataEase开源BI工具完整指南:从零开始的数据可视化之旅

DataEase开源BI工具完整指南&#xff1a;从零开始的数据可视化之旅 【免费下载链接】DataEase 人人可用的开源 BI 工具 项目地址: https://gitcode.com/feizhiyun/dataease DataEase是一款人人可用的开源BI工具&#xff0c;让数据分析变得简单直观。作为一款基于GPLv3协…

作者头像 李华