Java Swing宿舍管理系统课程设计：MySQL+JDBC源码解析与避坑指南

简介：这份资源是面向高校计算机相关专业学生的MySQL课程设计参考方案，主题为学生宿舍管理系统，采用Java Swing构建桌面端界面，MySQL负责数据存储，适合正在准备课程设计、毕业设计或需要练手数据库与桌面应用整合的初学者与中级开发者。压缩包共334个文件，约108.12MB，其中47个java源文件承载核心业务逻辑，202个class为编译产物，另有22个png界面素材、9个xml配置、若干C++编译中间文件及1个db数据库文件、1个jar依赖包，整体结构完整，可直接导入运行。内容涵盖管理员管理、宿舍管理、学生管理、学生宿舍分配、学生管理员管理等多个功能组件，并配有对应接口定义，便于理解分层设计与模块划分。目前已有192人学习下载，可作为课程设计选题、功能拆解与代码复用的实用参考，帮助读者快速搭建系统框架、理清数据库表关系与界面交互逻辑，减少从零开发的时间成本。

1. 从一份 class 文件清单说起：这套宿舍管理系统到底能跑出什么

如果你拿到一个压缩包，解压后看到的是一串AdminManageComponent.class、DormManageComponent.class、StuManageComponent.class，先别急着双击运行。这套基于 MySQL + Java + Swing 的学生宿舍管理系统，本质是一个典型的课程设计级桌面应用：Java 负责业务逻辑和界面渲染，Swing 负责窗口、表格、按钮这些交互组件，MySQL 负责持久化学生、宿舍、管理员三类核心数据。它解决的不是高并发场景，而是“如何在两周内交出一个能演示增删改查、能讲清楚三层结构、能写进课程设计报告”的问题。

适合谁？正在做 Java 课程设计、需要一套可运行源码参考分层写法、或者想拿 Swing 练手数据库连接的人。不适合谁？想直接拿去做生产级宿舍管理的人——它的权限模型、事务边界和异常处理都停留在教学层面。但作为“能跑通、能改、能讲”的起点，这份资源的价值在于：它把ManagerInterface、StuManagerInterface这些接口和对应实现类的调用关系摆在了明面上，你顺着 class 文件反推源码结构，比看十篇理论文章都直接。

2. 环境搭建与数据库初始化：把 MySQL 和 JDBC 驱动先钉死

2.1 为什么这套系统对 MySQL 版本和驱动特别敏感

Swing 桌面程序连 MySQL，最常见的翻车点不是 SQL 写错，而是驱动版本和数据库版本对不上。这套课程设计源码大概率用的是mysql-connector-java-5.x或8.x，两者在com.mysql.jdbc.Driver和com.mysql.cj.jdbc.Driver的类名上不兼容。如果你本地装的是 MySQL 8.0，却拿着 5.1 的驱动去连，控制台会直接抛ClassNotFoundException或No suitable driver found。常见做法是：先确认源码lib目录下 jar 包的版本号，再决定本地装哪个版本的 MySQL。我一般会优先匹配驱动版本，而不是反过来改代码。

另一个容易被忽略的是时区参数。MySQL 8.0 之后，JDBC URL 不带serverTimezone会报The server time zone value '???ú±ê×??±??' is unrecognized。这不是玄学，是服务器时区没被驱动识别。解决办法是在 URL 后面追加?serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true。注意useSSL=false在本地开发环境可以关，生产环境不要照抄。

2.2 建库建表：从 class 文件反推数据表结构

源码里没有附带.sql文件时，最笨但最可靠的办法是看StuManagerInterface和ManagerInterface里的方法签名。比如addStudent(Student stu)、deleteDorm(int dormId)、queryAdminByName(String name)，这些方法名直接对应表名和字段。常见做法是建三张核心表：student、dorm、admin，再加一张stu_dorm关联表处理住宿分配。

-- 学生表：字段名参考 StuManageComponent 里的 setter/getter CREATE TABLE student ( stu_id VARCHAR(20) PRIMARY KEY, -- 学号，Swing 表格里通常作为唯一标识 stu_name VARCHAR(50) NOT NULL, -- 姓名 stu_sex VARCHAR(4) DEFAULT '男', -- 性别，Swing 里常用 JComboBox stu_class VARCHAR(50), -- 班级 stu_phone VARCHAR(20), -- 联系电话 dorm_id INT, -- 外键，指向宿舍表 FOREIGN KEY (dorm_id) REFERENCES dorm(dorm_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 宿舍表：DormManageComponent 里操作的核心对象 CREATE TABLE dorm ( dorm_id INT PRIMARY KEY AUTO_INCREMENT, dorm_building VARCHAR(20) NOT NULL, -- 楼栋，如"3号楼" dorm_room VARCHAR(10) NOT NULL, -- 房间号 dorm_capacity INT DEFAULT 4, -- 容纳人数 dorm_occupied INT DEFAULT 0 -- 已住人数，增删学生时同步更新 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 管理员表：AdminManageComponent 对应 CREATE TABLE admin ( admin_id INT PRIMARY KEY AUTO_INCREMENT, admin_name VARCHAR(30) NOT NULL UNIQUE, admin_pwd VARCHAR(64) NOT NULL -- 教学项目常存明文，实际要加盐哈希 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

建表时字符集统一用utf8mb4，否则 Swing 界面输入中文姓名后写入会变成问号。dorm_occupied这个字段是很多课程设计的扣分点：学生入住和退宿时如果没有同步更新，宿舍容量显示就会对不上。我一般会在StuDormManageComponent对应的业务方法里，把“插入学生记录”和“更新宿舍已住人数”放在同一个try-catch块里，手动控制事务提交。

2.3 JDBC 连接工具类：把 URL、用户名、密码抽出来

源码里通常有一个DBUtil或BaseDao类，但 class 文件反编译后变量名可能丢失。与其硬啃反编译结果，不如自己写一个连接工具类，把配置外置到db.properties。

// DBUtil.java：统一管理连接，避免每个 Component 里都写一遍 DriverManager import java.sql.*; import java.util.Properties; import java.io.InputStream; public class DBUtil { private static String url; private static String user; private static String password; static { try (InputStream in = DBUtil.class.getClassLoader() .getResourceAsStream("db.properties")) { Properties props = new Properties(); props.load(in); url = props.getProperty("jdbc.url"); user = props.getProperty("jdbc.user"); password = props.getProperty("jdbc.password"); // 显式加载驱动，兼容老版本 mysql-connector Class.forName(props.getProperty("jdbc.driver")); } catch (Exception e) { throw new ExceptionInInitializerError("数据库配置加载失败: " + e.getMessage()); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, user, password); } // 关闭资源的标准写法，Swing 事件里容易漏掉 public static void close(Connection conn, Statement stmt, ResultSet rs) { try { if (rs != null) rs.close(); } catch (SQLException ignored) {} try { if (stmt != null) stmt.close(); } catch (SQLException ignored) {} try { if (conn != null) conn.close(); } catch (SQLException ignored) {} } }

对应的db.properties放在src根目录下：

jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/dorm_system?serverTimezone=Asia/Shanghai&useSSL=false&characterEncoding=utf8 jdbc.user=root jdbc.password=你的密码

参数说明：characterEncoding=utf8要和建表时的utf8mb4配合，虽然驱动层写utf8也能跑，但遇到 emoji 或生僻字会丢。serverTimezone必须显式指定，否则 MySQL 8.0 直接拒绝连接。useSSL=false只建议在本地用，如果数据库不在本机，改成useSSL=true并配置证书，否则就是裸奔。

3. Swing 界面与业务分层：从 ManagerInterface 看调用链怎么走

3.1 接口与实现类分离：为什么 class 文件清单里有两套 Manager

解压后的 class 清单里，ManagerInterface.class和StuManagerInterface.class同时出现，说明这套代码用了面向接口编程。ManagerInterface大概率定义了管理员相关的登录、增删改查方法，StuManagerInterface定义了学生和宿舍的操作。对应的实现类可能是ManagerInterfaceImpl或直接由AdminManageComponent内部类实现。这种写法在教学项目里算加分项，但反编译后接口方法没有方法体，你得靠实现类里的 SQL 语句反推。

常见做法是：先找到AdminManageComponent里actionPerformed方法中调用的manager.xxx()，再顺着manager变量的声明类型找到接口，最后在实现类里定位PreparedStatement。如果源码完全丢失，只能靠 class 文件反编译，推荐用 JD-GUI 或 CFR，但注意反编译出来的for循环和try块可能错位，别直接复制运行。

3.2 登录模块：Swing 事件线程里做数据库查询的坑

Swing 是单线程模型，所有界面更新必须在 Event Dispatch Thread（EDT）里执行。但数据库查询是阻塞操作，如果直接在actionPerformed里写DBUtil.getConnection()，查询慢的时候界面会假死。教学项目通常不管这个，但你自己改的时候要注意：要么把查询放到SwingWorker的doInBackground里，要么至少加一个“正在登录”的模态对话框。

// 登录按钮事件：先校验非空，再查库，最后根据结果切换主窗口 loginBtn.addActionListener(e -> { String name = nameField.getText().trim(); String pwd = new String(pwdField.getPassword()).trim(); if (name.isEmpty() || pwd.isEmpty()) { JOptionPane.showMessageDialog(this, "用户名和密码不能为空"); return; } // 教学项目常用明文比对，实际应查库后做哈希校验 String sql = "SELECT admin_id FROM admin WHERE admin_name=? AND admin_pwd=?"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, name); ps.setString(2, pwd); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { // 登录成功，关闭登录窗，打开主界面 this.dispose(); new MainFrame().setVisible(true); } else { JOptionPane.showMessageDialog(this, "用户名或密码错误"); } } } catch (SQLException ex) { // 不要把 ex.printStackTrace() 直接暴露给用户，记日志即可 JOptionPane.showMessageDialog(this, "数据库连接异常，请检查配置"); } });

逻辑说明：PreparedStatement用?占位，避免 SQL 注入，这是课程设计里少数必须做对的地方。try-with-resources保证连接和语句自动关闭，比手动finally干净。注意pwdField.getPassword()返回char[]，转成String后驻留内存，教学项目无所谓，但知道这个细节面试时能多说一句。

3.3 学生管理模块：JTable 刷新与数据库同步的时机

StuManageComponent里最典型的操作是：点击“添加”弹出输入框，保存后表格要立刻显示新数据。很多课程设计在这里翻车——数据插进数据库了，但JTable的TableModel没重新加载，用户以为没保存成功，又点一次，结果插了两条。正确做法是：每次增删改之后，重新执行一次SELECT，用新的ResultSet重建DefaultTableModel，再table.setModel(model)。

// 刷新学生表格：先清空旧数据，再重新查库填充 private void refreshStudentTable() { String sql = "SELECT s.stu_id, s.stu_name, s.stu_sex, s.stu_class, d.dorm_building, d.dorm_room " + "FROM student s LEFT JOIN dorm d ON s.dorm_id = d.dorm_id"; DefaultTableModel model = new DefaultTableModel( new String[]{"学号", "姓名", "性别", "班级", "楼栋", "房间号"}, 0); try (Connection conn = DBUtil.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql)) { while (rs.next()) { model.addRow(new Object[]{ rs.getString("stu_id"), rs.getString("stu_name"), rs.getString("stu_sex"), rs.getString("stu_class"), rs.getString("dorm_building"), rs.getString("dorm_room") }); } } catch (SQLException e) { JOptionPane.showMessageDialog(this, "加载学生数据失败"); } stuTable.setModel(model); // 重新绑定，触发界面重绘 }

参数说明：LEFT JOIN保证没有分配宿舍的学生也能显示出来，楼栋和房间号为null时表格显示空白，比INNER JOIN丢记录更符合管理直觉。DefaultTableModel的第二个参数0表示初始行数为零，每次刷新都重建，避免旧数据残留。如果数据量大，应该用TableModel的fireTableDataChanged()，但课程设计级别直接重建更省事。

4. 避坑与排查：class 文件反编译、驱动冲突和中文乱码

4.1 反编译后变量名变成 var1、var2，怎么读

现象：用 JD-GUI 打开StuManageComponent.class，方法里全是var1、var2，SQL 语句里的表名和字段名还在，但局部变量完全看不懂。原因：编译时没有保留局部变量表（-g参数没加），反编译工具只能按顺序编号。解决：不要试图还原变量名，直接看字符串常量和方法调用链。SQL 语句里的SELECT、INSERT是硬编码字符串，反编译不会丢；PreparedStatement.setString(1, var1)里的var1对应哪个界面控件，靠actionPerformed里的getText()调用顺序推断。

4.2 报错 No suitable driver found，但 jar 包明明在 lib 里

现象：IDEA 里lib目录下能看到mysql-connector-java-8.0.x.jar，运行却抛No suitable driver found for jdbc:mysql://...。原因：jar 包没有加到模块的 classpath 里，或者Class.forName的类名写成了旧版com.mysql.jdbc.Driver。解决：在 IDEA 的 Project Structure → Modules → Dependencies 里确认 jar 包是Compile级别；如果用的是 Maven，检查pom.xml里mysql-connector-java的scope是不是provided。另外，MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver，少一个cj就找不到。

4.3 Swing 界面中文显示成方块，数据库里却是好的

现象：数据库里stu_name存的是“张三”，Swing 的JTable里显示成“口口”或乱码。原因：Swing 默认字体不支持中文，或者JTable的DefaultTableModel在填充时用了错误的字符集。解决：在main方法开头设置全局字体，比如UIManager.put("Label.font", new Font("微软雅黑", Font.PLAIN, 14))，对Table、Button也分别设置。如果数据库连接 URL 里没加characterEncoding=utf8，查询结果在驱动层就已经错了，界面怎么调都没用。

4.4 删除宿舍时外键约束报错，但学生已经退宿了

现象：执行DELETE FROM dorm WHERE dorm_id=?时抛Cannot delete or update a parent row: a foreign key constraint fails。原因：student表里还有记录的dorm_id指向这个宿舍，即使界面上显示“已退宿”，数据库里的外键还在。解决：退宿操作应该是UPDATE student SET dorm_id=NULL WHERE stu_id=?，而不是直接删学生记录。如果业务要求删宿舍，先把关联学生的dorm_id置空，再删宿舍，两步放在同一个事务里。

4.5 打包成 jar 后双击没反应，命令行却能看到报错

现象：IDEA 里运行正常，mvn package后双击 jar 文件，窗口一闪而过。原因：Swing 程序在 EDT 里抛了未捕获异常，没有控制台看不到堆栈。解决：用java -jar xxx.jar在命令行运行，看完整报错。常见的是db.properties没被打进 jar，或者MANIFEST.MF里没指定Main-Class。Maven 项目用maven-shade-plugin或maven-assembly-plugin打可执行 jar，确保资源文件在src/main/resources下。

5. 从能跑到能讲：把课程设计改成面试能聊的项目

5.1 给登录加一层密码哈希，把明文存储这个扣分项补掉

教学项目最容易被面试官挑刺的就是admin_pwd存明文。改造成本很低：登录时用MessageDigest做 SHA-256，注册或初始化管理员时存哈希值。注意不要用 MD5，虽然课程设计没人管，但面试时提 MD5 会减分。加盐更稳妥，但课程设计级别 SHA-256 不加盐已经能说明你懂“不存明文”这个原则。

// 密码哈希工具：登录比对时用，初始化 admin 表时也用它生成密文 import java.security.MessageDigest; import java.nio.charset.StandardCharsets; public class PasswordUtil { public static String sha256(String raw) { try { MessageDigest md = MessageDigest.getInstance("SHA-256"); byte[] digest = md.digest(raw.getBytes(StandardCharsets.UTF_8)); StringBuilder sb = new StringBuilder(); for (byte b : digest) { sb.append(String.format("%02x", b)); } return sb.toString(); } catch (Exception e) { throw new RuntimeException("哈希计算失败", e); } } }

改造步骤：第一步，把admin表里现有密码全部更新为PasswordUtil.sha256(原密码)；第二步，登录 SQL 改成WHERE admin_name=? AND admin_pwd=?，第二个参数传PasswordUtil.sha256(pwd)；第三步，新增管理员时同样存哈希。这样面试时你可以说“原始代码是明文，我改成了 SHA-256，并且说明了为什么不用 MD5”。

5.2 用事务把“分配宿舍”和“更新已住人数”绑在一起

StuDormManageComponent里分配宿舍的逻辑，通常是先UPDATE student SET dorm_id=?，再UPDATE dorm SET dorm_occupied=dorm_occupied+1。如果第一条成功第二条失败，数据就不一致了。手动事务的写法：

// 分配宿舍：两条更新要么都成功，要么都回滚 public boolean assignDorm(String stuId, int dormId) { String sql1 = "UPDATE student SET dorm_id=? WHERE stu_id=?"; String sql2 = "UPDATE dorm SET dorm_occupied=dorm_occupied+1 " + "WHERE dorm_id=? AND dorm_occupied < dorm_capacity"; Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交 try (PreparedStatement ps1 = conn.prepareStatement(sql1); PreparedStatement ps2 = conn.prepareStatement(sql2)) { ps1.setInt(1, dormId); ps1.setString(2, stuId); if (ps1.executeUpdate() == 0) { conn.rollback(); return false; } ps2.setInt(1, dormId); if (ps2.executeUpdate() == 0) { conn.rollback(); // 宿舍已满，回滚学生分配 return false; } conn.commit(); return true; } } catch (SQLException e) { if (conn != null) { try { conn.rollback(); } catch (SQLException ignored) {} } return false; } finally { if (conn != null) { try { conn.setAutoCommit(true); conn.close(); } catch (SQLException ignored) {} } } }

参数说明：sql2里的dorm_occupied < dorm_capacity是并发安全的写法，即使两个人同时分配同一间宿舍，数据库行锁会保证不会超员。conn.setAutoCommit(false)之后必须显式commit或rollback，否则连接关闭时未提交的操作会丢失。这个改造能让你的课程设计在“数据一致性”这个点上站住脚。

5.3 验证改造是否生效：三个必查点

改完之后不要只点界面，按下面三步验证。第一，查数据库：SELECT admin_name, admin_pwd FROM admin，确认密码是 64 位十六进制字符串，不是明文。第二，模拟宿舍满员：把某间宿舍的dorm_occupied改成等于dorm_capacity，再调分配方法，应该返回false且学生表的dorm_id没变。第三，断网测试：把db.properties里的密码改错，启动程序，登录时应该弹“数据库连接异常”而不是白屏或堆栈直接打在控制台。

从那以后我每次拿到这种课程设计源码，都先跑一遍“改密码→测满员→断连接”这三步，确认分层和事务边界是真的能改，而不是只能演示。希望帮到你。

本文还有配套的精品资源，点击获取