SpringBoot 整合 WebSocket 实现校园二手平台私信聊天,环境配置 + 踩坑记录

📅 2026/7/2 20:00:52 👁️ 阅读次数 📝 编程学习
SpringBoot 整合 WebSocket 实现校园二手平台私信聊天,环境配置 + 踩坑记录

一、前言

校易淘需要买卖双方实时沟通,因此使用 WebSocket 实现点对点私信聊天,本文完整记录后端 WebSocket 服务配置、前端 ws 工具封装、消息表设计,整理连接断开、跨域、离线消息丢失等全部踩坑。

二、后端 WebSocket 环境搭建

  1. 引入 WebSocket 依赖
  2. WebSocket 配置类,开启 @ServerEndpoint 支持;
  3. ChatServer 端点类,管理在线会话集合,实现连接建立、消息接收、连接关闭、异常处理;
  4. 消息持久化 message 数据表,收发消息同时存入数据库

三、聊天消息数据表 message

四、前端 Vue 封装 WebSocket 工具类

封装 ws 连接、心跳检测、断线重连,页面刷新自动重连服务端,统一发送消息方法

六、搭建总结

WebSocket 属于长连接,和 http 短连接逻辑完全不同,必须处理断线重连、会话并发、消息持久化三大问题,否则聊天功能无法稳定使用。