简介这是一份面向Java初学者与高校课程设计学生的QQ风格聊天系统实战项目可直接用于Java期末大作业或Swing GUI多线程MySQL综合实训。项目完整实现用户注册/登录、密码找回、在线人员列表、群聊与私聊、账号注销及密码修改等核心功能技术栈覆盖Swing界面开发、Socket网络通信、多线程并发控制及MySQL数据库操作附带可一键导入的SQL数据库文件与图文并茂的项目展示PPT含运行效果图。资源包共291个文件含34个Java源码、53个编译后Class文件、178张界面截图PNG、16个XML配置及1个PPTX演示文稿整体21.46MB结构清晰模块职责分明如TKServer为服务端主控、FriendList管理好友关系、Login/Register实现认证逻辑。已有586人学习下载提供开箱即用的可运行工程、调试成功的稳定版本及完整技术闭环是巩固Java基础、理解C/S架构与网络编程实践的理想范例。1. 一个用纯 Java Swing 实现的本地化聊天系统不是 Web不依赖 Spring却完整跑通注册、登录、在线列表、群聊与私聊全链路这不是一个基于 WebSocket 的现代 Web 聊天室也不是 Spring Boot Vue 的工程化项目。它是一套用 Java 基础技术栈扎扎实实搭出来的桌面级聊天系统——核心逻辑全部写在ServerController.class和TKServer.class里UI 全靠Swing组件堆砌通信靠Socket 多线程维持长连接数据存于本地 MySQL 数据库连UserDao.class都是手写 JDBC 封装没用任何 ORM 框架。它能跑起来不是因为用了新潮技术而是把大学《Java 程序设计》《数据库原理》《网络编程》三门课的知识点拧成一股绳Login.class处理账号校验FriendList.class维护内存级好友状态Register$SelectAvatar.class甚至用内部类实现头像选择弹窗。适合正在做 Java 期末大作业的学生——你不需要部署 Tomcat不用配 Maven 依赖只要装好 JDK 8 和 MySQL 5.7导入 SQL 文件、启动服务端、再开多个客户端窗口就能看到“在线人员”实时刷新、“消息气泡”逐条弹出、“私聊窗口”独立弹出——所有效果都在 PPT 的截图页里可验证。它不解决高并发或分布式问题但把“用户怎么登录”“消息怎么发到指定人”“在线状态怎么同步”这些底层动作拆解成了你能一行行 debug 的 Java 代码。2. 从数据库建模到 Swing UI 渲染理解这套系统如何用基础组件拼出完整聊天闭环2.1 MySQL 数据库结构解析五张表支撑全部业务逻辑系统附带的.sql文件通常命名为chatdb.sql或qqchat.sql定义了 5 张核心表全部采用InnoDB引擎并设置外键约束。建表语句中没有使用AUTO_INCREMENT主键以外的高级特性符合课程设计对“可控性”和“可读性”的要求-- 用户主表存储账号密码、昵称、头像路径等基础信息 CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(100) NOT NULL, -- 实际存储为 MD5 加密字符串 nickname VARCHAR(50), avatar_path VARCHAR(200), last_login_time DATETIME, status ENUM(online, offline) DEFAULT offline ); -- 好友关系表记录双向好友关系A 是 B 的好友B 也是 A 的好友 CREATE TABLE friends ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, friend_id INT NOT NULL, FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE, FOREIGN KEY (friend_id) REFERENCES users(id) ON DELETE CASCADE, UNIQUE KEY unique_friendship (user_id, friend_id) ); -- 消息主表type 字段区分群聊(0)与私聊(1)target_id 指向群ID或对方user_id CREATE TABLE messages ( id BIGINT PRIMARY KEY AUTO_INCREMENT, sender_id INT NOT NULL, target_id INT NOT NULL, type TINYINT NOT NULL DEFAULT 0, -- 0: group, 1: private content TEXT NOT NULL, send_time DATETIME DEFAULT CURRENT_TIMESTAMP, is_read TINYINT DEFAULT 0, FOREIGN KEY (sender_id) REFERENCES users(id) ); -- 在线用户快照表服务端启动时清空用户上线插入下线删除 CREATE TABLE online_users ( user_id INT PRIMARY KEY, ip_address VARCHAR(45), login_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE ); -- 密码找回凭证表用于 Forget.class 中的邮箱/手机号验证流程 CREATE TABLE reset_tokens ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, token VARCHAR(64) NOT NULL, expire_time DATETIME NOT NULL, used TINYINT DEFAULT 0, FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE );提示status字段在users表中仅作冗余标记真实在线状态以online_users表为准。服务端每次心跳检测后会同步更新该表避免因客户端异常断连导致状态滞留。2.2 ServerController 与 TKServer多线程 Socket 服务的核心调度器整个服务端由TKServer.class启动它本身不处理具体业务而是创建ServerController实例并交由其调度。ServerController是真正的中枢——它维护一个HashMapInteger, ClientHandler缓存所有已连接客户端的 socket 句柄与用户 ID 映射并通过ExecutorService管理线程池// ServerController.java 片段客户端连接接入与分发 public class ServerController { private final MapInteger, ClientHandler clientMap new ConcurrentHashMap(); private final ExecutorService threadPool Executors.newCachedThreadPool(); public void startServer(int port) throws IOException { ServerSocket serverSocket new ServerSocket(port); System.out.println(Chat Server started on port port); while (true) { Socket clientSocket serverSocket.accept(); // 新连接到来分配独立线程处理 threadPool.submit(new ClientHandler(clientSocket, this)); } } // 向指定用户发送消息私聊 public void sendPrivateMessage(int fromId, int toId, String content) { ClientHandler targetHandler clientMap.get(toId); if (targetHandler ! null targetHandler.isOnline()) { targetHandler.sendMessage(fromId, content, MessageType.PRIVATE); } else { // 对方不在线写入离线消息表实际项目中需补充此逻辑 saveOfflineMessage(fromId, toId, content); } } // 广播消息给所有在线用户群聊 public void broadcastMessage(int fromId, String content) { clientMap.values().parallelStream() .filter(ClientHandler::isOnline) .forEach(handler - handler.sendMessage(fromId, content, MessageType.GROUP)); } }ClientHandler类继承自Thread每个实例绑定一个Socket连接负责解析客户端发来的 JSON 格式指令如{cmd:login,username:abc,password:123}调用UserDao执行数据库校验登录成功后将自身注册进ServerController.clientMap持续监听 socket 输入流收到消息即调用ServerController分发捕获IOException或SocketException时主动从clientMap中移除并清理资源。2.3 Swing UI 层的关键组件组织如何让聊天窗口“活”起来客户端 UI 全部基于JFrameJPanelJTextAreaJTextField构建无第三方 UI 库。主窗口ChatView.class采用BorderLayout布局North区顶部工具栏含“修改密码”“注销”“退出”按钮Center区主消息显示区使用JScrollPane包裹JTextArea禁用编辑但支持自动滚动South区输入框JTextField “发送”按钮回车触发actionPerformed()West区JList显示在线用户列表双击某用户触发私聊窗口创建East区JTabbedPane管理多个私聊标签页每个标签页对应一个PrivateChatView实例。私聊窗口PrivateChatView是独立JDialog其构造函数接收目标用户 ID 和昵称并在WindowListener.windowOpened()中启动一个后台线程持续轮询数据库messages表中type1 AND target_id?的新消息实际项目中应优化为服务端推送但本作业采用 polling 模拟// PrivateChatView.java 片段轮询获取私聊消息 private void startPolling() { pollingThread new Thread(() - { while (isShowing() !isDisposed) { try { ListMessage newMessages messageDao.getNewPrivateMessages( currentUserId, targetUserId, lastCheckedTime); for (Message msg : newMessages) { appendMessageToUI(msg.getSenderNickname(), msg.getContent()); lastCheckedTime msg.getSendTime(); } Thread.sleep(2000); // 2秒轮询间隔 } catch (InterruptedException e) { break; } } }); pollingThread.start(); }注意这种轮询方式在真实项目中会造成数据库压力但在课程设计中可接受。若需优化可将online_users表变更事件通过MySQL Trigger UDF推送至服务端内存再由ServerController主动推送给对应ClientHandler。3. 从零部署导入数据库、编译运行、调试关键断点的完整操作链3.1 数据库初始化与连接配置第一步创建数据库并导入 SQL 文件在 MySQL 命令行中执行mysql -u root -p # 输入密码后进入 MySQL CLI CREATE DATABASE chatdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE chatdb; SOURCE /path/to/chatdb.sql; -- 替换为你的 SQL 文件绝对路径第二步确认 JDBC 连接参数打开UserDao.class或DBUtil.class若存在查找类似以下代码private static final String URL jdbc:mysql://localhost:3306/chatdb?useSSLfalseserverTimezoneAsia/Shanghai; private static final String USERNAME root; private static final String PASSWORD 123456; // 注意此处密码需与你 MySQL 实际密码一致提示若使用 MySQL 8.0驱动类名需改为com.mysql.cj.jdbc.Driver并在 URL 中添加allowPublicKeyRetrievaltrue参数否则抛出SQLException: Unknown system variable query_cache_size。第三步验证数据库可连通编写一个最小测试类DBTest.javaimport java.sql.*; public class DBTest { public static void main(String[] args) { String url jdbc:mysql://localhost:3306/chatdb?useSSLfalseserverTimezoneAsia/Shanghai; try (Connection conn DriverManager.getConnection(url, root, 123456); Statement stmt conn.createStatement()) { ResultSet rs stmt.executeQuery(SELECT COUNT(*) FROM users); if (rs.next()) { System.out.println(✅ 数据库连接成功当前用户数 rs.getInt(1)); } } catch (SQLException e) { System.err.println(❌ 连接失败 e.getMessage()); e.printStackTrace(); } } }编译并运行javac DBTest.java java DBTest输出 ✅ 即表示数据库层就绪。3.2 服务端与客户端编译运行流程项目未提供pom.xml说明采用传统javac编译方式。假设源码目录结构如下chat-project/ ├── src/ │ ├── com/chat/server/TKServer.java │ ├── com/chat/server/ServerController.java │ ├── com/chat/client/ChatView.java │ └── com/chat/dao/UserDao.java ├── lib/ │ └── mysql-connector-java-5.1.49.jar # 必须存在否则 ClassNotFound └── db/ └── chatdb.sql执行以下命令完成编译JDK 8 环境# 进入 src 目录编译所有 .java 文件 cd src javac -cp .:../lib/mysql-connector-java-5.1.49.jar \ com/chat/server/TKServer.java \ com/chat/server/ServerController.java \ com/chat/client/ChatView.java \ com/chat/dao/UserDao.java \ com/chat/dao/MessageDao.java \ com/chat/dao/FriendDao.java # 编译完成后回到项目根目录运行服务端 cd .. java -cp src:lib/mysql-connector-java-5.1.49.jar com.chat.server.TKServer服务端启动成功后控制台应输出Chat Server started on port 8080端口号在TKServer.java中硬编码常见为8080或9999。此时再开两个终端分别运行客户端# 终端1启动第一个客户端模拟用户A java -cp src:lib/mysql-connector-java-5.1.49.jar com.chat.client.ChatView # 终端2启动第二个客户端模拟用户B java -cp src:lib/mysql-connector-java-5.1.49.jar com.chat.client.ChatView3.3 关键调试断点与典型错误排查表当客户端无法登录或消息不显示时按以下顺序检查故障现象定位文件关键断点位置常见原因验证方法登录按钮无响应Login.classloginButton.addActionListener(...)内部JTextField.getText()返回空字符串未做非空校验在 if (username.isEmpty()登录成功但不跳转首页Login.classnew ChatView(userId).setVisible(true)后ChatView构造函数中initComponents()抛出NullPointerException检查JList初始化是否在SwingUtilities.invokeLater()外执行在线列表为空ServerController.classbroadcastOnlineUsers()方法内online_users表无数据或ClientHandler未正确调用registerOnlineUser()登录后立即执行SELECT * FROM online_users查看是否插入记录私聊消息不显示PrivateChatView.classstartPolling()循环内messageDao.getNewPrivateMessages()SQL 语句WHERE type1 AND target_id?条件错误手动执行该 SQL确认target_id是否等于当前对话对方的user_id消息发送后对方收不到ServerController.classsendPrivateMessage()方法中clientMap.get(toId)返回 null对方用户已下线但未从clientMap移除或toId传参错误在sendPrivateMessage()开头加System.out.println(targetIdtoId, mapSizeclientMap.size())提示所有 Swing 组件的更新如JTextArea.append()必须在 Event Dispatch Thread 中执行。若在ClientHandler线程中直接调用 UI 方法会导致界面卡死。正确做法是使用SwingUtilities.invokeLater()包裹 UI 操作。4. 进阶技巧为课程答辩准备 PPT 动效、添加消息时间戳、以及规避 Swing 线程安全陷阱4.1 PPT 展示中的三个高光动效设计建议课程答辩 PPT 不需要炫技动画但三个细节能让评委立刻感知项目完成度登录流程对比页左侧放Login.class的actionPerformed()方法截图高亮UserDao.login(username, password)调用右侧放 MySQL Workbench 执行SELECT * FROM users WHERE usernametest的结果集箭头标注statusonline字段变化——体现“代码→SQL→数据库”全链路可追踪。在线列表实时性演示页用两张截图并列——第一张是用户 A 登录后online_users表只有一条记录第二张是用户 B 登录后同一张表新增第二条记录并在ChatView界面JList中同步显示两个用户名。标注“服务端每 5 秒扫描online_users表并广播更新”。私聊窗口独立性验证页截取任务管理器显示三个java.exe进程服务端 客户端A 客户端B再截取 Wireshark 抓包过滤tcp.port8080展示ACK数据包中包含msg:hello的明文 payload——证明通信未加密但协议清晰符合课程设计对“透明性”的要求。4.2 为消息添加精确到秒的时间戳无需改数据库当前messages表已有send_time DATETIME字段只需在 UI 层格式化显示。修改ChatView.java中追加消息的方法// 原有代码可能只是textArea.append(sender : content \n); // 替换为 SimpleDateFormat sdf new SimpleDateFormat(HH:mm:ss); String timeStr sdf.format(message.getSendTime()); textArea.append([ timeStr ] sender : content \n); textArea.setCaretPosition(textArea.getDocument().getLength()); // 自动滚动到底部注意SimpleDateFormat不是线程安全的若在多线程环境如多个ClientHandler同时触发 UI 更新中使用需每次新建实例或改用DateTimeFormatterJava 8。4.3 Swing 线程安全的黄金法则所有 UI 更新必须包裹在 invokeLater这是学生最容易踩的坑——在ClientHandler线程中直接调用ChatView.textArea.append()导致界面冻结或IllegalStateException。正确写法必须强制切回 EDTEvent Dispatch Thread// ❌ 错误在非EDT线程中直接操作UI textArea.append(Received: msg \n); // ✅ 正确使用 invokeLater 确保在EDT执行 SwingUtilities.invokeLater(() - { textArea.append(Received: msg \n); textArea.setCaretPosition(textArea.getDocument().getLength()); });更进一步可封装为工具方法避免重复书写public static void updateUIText(JTextArea area, String text) { SwingUtilities.invokeLater(() - { area.append(text \n); area.setCaretPosition(area.getDocument().getLength()); }); }然后在任意线程中调用updateUIText(chatView.textArea, Hello World);即可。这个模式适用于所有 Swing 组件更新JLabel.setText()、JList.setListData()、JTable.setValueAt()等。最后提醒一个隐蔽陷阱JFrame.setVisible(true)必须在SwingUtilities.invokeLater()中调用否则在某些 JVM 版本下窗口可能不显示。标准启动模板应为public static void main(String[] args) { SwingUtilities.invokeLater(() - { new ChatView().setVisible(true); }); }本文还有配套的精品资源点击获取