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

一、前言

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

二、后端 WebSocket 环境搭建

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

三、聊天消息数据表 message

四、前端 Vue 封装 WebSocket 工具类

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

六、搭建总结

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