本项目是一个基于 Spring Boot 和 WebSocket 技术实现的轻量级实时聊天室系统。采用前后端分离架构，后端使用 MyBatis 和 MySQL 进行数据持久化，前端结合 HTML/CSS/JavaScript 及 jQuery 实现交互。核心功能包括用户认证、好友管理、一对一私聊及消息历史记录。系统通过 WebSocket 建立持久连接实现消息秒级推送，支持 RESTful API 接口调用。
一个基于 Spring Boot 和 WebSocket 技术实现的轻量级实时聊天室项目。
这是一个采用 前后端分离 架构的 Web 聊天应用。它专注于提供一个稳定、实时的消息通信平台，支持用户认证、好友管理、以及核心的一对一私聊功能。
| 特性 | 描述 |
|---|---|
| 实时通信 | 基于 WebSocket 实现，消息秒级推送。 |
| 核心功能 | 用户注册登录、好友列表、私聊会话、消息历史记录。 |
| 后端架构 | Spring Boot 配合 MyBatis，快速构建 RESTful API。 |
| 前端技术 | 传统 HTML/CSS/JavaScript + jQuery，轻量易维护。 |
| 类别 | 技术名称 | 角色与描述 |
|---|---|---|
| 后端框架 | Spring Boot 2.7.6 | 快速开发 Web 应用，简化配置。 |
| 实时通信 | Spring WebSocket | 实现客户端与服务器的双向持久连接。 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
| MyBatis |
| 灵活的持久层框架，SQL 与代码分离。 |
| 数据库 | MySQL | 关系型数据库，存储用户信息和聊天记录。 |
| 构建工具 | Maven | 项目依赖管理与构建。 |
| 前端基础 | HTML/CSS/JS | 负责页面结构、样式和交互逻辑。 |
| 交互库 | jQuery/Ajax | 简化 DOM 操作和发起异步 HTTP 请求。 |
本项目最核心的部分是 Spring Boot + WebSocket 实现的实时通信机制。
/login 登录成功后，获取会话信息。/WebSocketMessage。清晰的模块化结构，便于开发者理解和维护：
java_chatroom/
├── src/
│ ├── main/
│ │ ├── java/com/example/java_chatroom/
│ │ │ ├── api/ # Controller 层
│ │ │ ├── component/ # 组件类
│ │ │ ├── config/ # 配置类
│ │ │ └── model/ # 数据模型
│ │ ├── resources/
│ │ │ ├── mapper/ # MyBatis XML 映射文件
│ │ │ └── static/ # 前端静态资源 (HTML/CSS/JS)
│ │ └── db.sql # 数据库初始化脚本
├── pom.xml # Maven 依赖配置
└── README.md # 项目说明文档
系统采用 5 个核心数据表来实现用户关系和消息存储。
| 表名 | 描述 | 关键字段 | 关系说明 |
|---|---|---|---|
| user | 用户基本信息 | userId, username, password | 存储登录凭证 |
| friend | 用户好友关系 | userId, friendId | 记录谁是谁的好友 |
| message_session | 会话信息 | sessionId, lastTime | 私聊会话的主键 |
| message_session_user | 会话用户关联 | sessionId, userId | 多对多：一个会话关联多个用户 |
| message | 消息内容 | messageId, fromId, sessionId, content, postTime | 存储具体的聊天记录 |
项目主要通过 RESTful API 和 WebSocket 端点实现功能。
| 模块 | 接口/端点 | 方式 | 描述 |
|---|---|---|---|
| 用户注册 | /register | POST | 创建新用户 |
| 用户登录 | /login | POST | 校验并建立用户会话 |
| 获取信息 | /userInfo | GET | 获取当前登录用户的基本信息 |
| 模块 | 接口/端点 | 方式 | 描述 |
|---|---|---|---|
| 获取列表 | /friendList | GET | 查看当前用户的所有好友 |
| 获取列表 | /sessionList | GET | 查看所有进行中的私聊会话 |
| 创建会话 | /session | POST | 与指定好友创建一个新的会话 |
| 模块 | 接口/端点 | 方式 | 描述 |
|---|---|---|---|
| 历史消息 | /message | GET | 根据 sessionId 分页获取历史聊天记录 |
| 实时推送 | /WebSocketMessage | WebSocket | 核心：建立实时双向通信通道 |
java_chatroom 的数据库。src/main/resources/application.yml 文件。username 和 password 为您的 MySQL 账户信息。spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/java_chatroom?...
username: root
password: your_password
mysql -u root -p < src/main/java/db.sql
mvn clean install
mvn spring-boot:run
http://localhost:8080/login.html本项目可进一步扩展以实现更丰富的功能：