尧图网站建设 
简介这是一套面向高校计算机相关专业学生的JavaFxJDBCMySQL学生宿舍管理系统完整项目适合用作期末大作业、课程设计或毕业设计参考难度适中源码经本地编译可运行评审分达98分内容经助教老师审定。资源包共101个文件约472KB以36个java源文件、28个fxml界面文件、10个xml配置、4个css样式及1个sql脚本为主另含properties配置、md说明与图片素材覆盖登录、管理员、学生、宿舍楼等模块的界面与业务逻辑。已有105人学习下载。读者可获得完整可运行的项目源码、数据库脚本与文档说明便于快速理解JavaFx界面布局、JDBC数据访问与MySQL表结构设计并在此基础上二次开发或撰写设计文档是兼顾学习与提交的实用参考。1. 从一份能跑起来的 JavaFx 宿舍管理源码说起很多同学做 Java 期末大作业或课程设计时最头疼的不是写代码而是拼不出一套完整能跑的系统。网上搜到的源码要么缺数据库脚本要么 FXML 和 Controller 对不上导入 IDE 直接一片红。这份 JavaFxJDBCMySQL 实现的学生宿舍管理系统恰好是那种解压即用的完整包源码、数据库、文档说明三件套齐全本地编译过、可运行评审分 98 分难度适中适合直接拿来做课程设计或毕业设计的底子。它用 JavaFx 做界面JDBC 直连 MySQL 做数据层没有引入 Spring 那套重框架对刚学完 Java 基础、数据库原理的同学非常友好。整个项目围绕宿舍管理的核心业务展开楼栋、宿舍、学生、管理员四类角色登录、增删改查、分配宿舍这些操作都能跑通。如果你正被Java 课程设计案例源码卡住这份资源能让你把精力放在理解和二次开发上而不是从零搭架子。2. 拆开资源包FXML、CSS 与 JDBC 三层怎么咬合拿到压缩包先别急着导入 IDE花五分钟把目录结构看清楚后面能省掉大量找不到文件的玄学问题。这个项目是典型的 JavaFx MVC 分层FXML 负责界面结构CSS 负责样式Controller 负责逻辑JDBC 负责数据。2.1 界面层FXML 与 CSS 的对应关系从项目正文给出的文件清单能看出界面层的组织方式login.fxmllogin.css登录窗口admin.fxmladmin.css管理员主界面student.fxmlstudent.css学生主界面super.fxmlsuper.css超级管理员界面building.fxml楼栋管理界面这里有个新手最容易翻车的点FXML 里通过stylesheetsxxx.css引用样式路径是相对 FXML 文件本身的。如果你把 FXML 和 CSS 放到了不同目录或者导入 IDE 后资源没被复制到target/classes界面就会变成裸奔的默认控件样式按钮灰扑扑一片。常见做法是把 FXML 和同名 CSS 放在同一个包目录下构建时一起打包。FXML 里每个控件都带fx:idController 通过FXML注解注入。比如登录界面的用户名输入框!-- login.fxml 片段控件 fx:id 必须与 Controller 字段名一致 -- TextField fx:idusernameField promptText请输入用户名/ PasswordField fx:idpasswordField promptText请输入密码/ Button fx:idloginButton text登录 onAction#handleLogin/onAction#handleLogin里的方法名必须在对应的 Controller 里存在且带FXML注解否则点击按钮直接抛IllegalArgumentException。这是 JavaFx 反射绑定机制决定的不是 bug是约定。2.2 数据层JDBC 连接 MySQL 的配置与封装数据层用原生 JDBC没有 ORM。这意味着 SQL 全部手写好处是透明、好调试坏处是连接管理要自己兜住。项目里通常会有一个DBUtil或BaseDao类集中管理连接。// DBUtil.java集中管理数据库连接避免每个 DAO 重复写驱动加载 public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/dorm_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8; private static final String USER root; private static final String PASSWORD 你的密码; static { try { // MySQL 8.x 用 com.mysql.cj.jdbc.Driver5.x 用 com.mysql.jdbc.Driver Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { throw new RuntimeException(MySQL 驱动未加载, e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }几个参数必须说清楚useSSLfalse是本地开发常用写法避免自签证书握手失败serverTimezoneAsia/Shanghai不加的话MySQL 8.x 插入时间字段可能报时区异常characterEncodingutf8保证中文姓名不乱码。这三个参数是 JDBC 连 MySQL 最高频的踩坑点缺一个都可能让你调半天。DAO 层典型写法是打开连接 → 预编译 SQL → 设参 → 执行 → 关资源用 try-with-resources 自动关闭// StudentDao.java查询某楼栋下的所有学生 public ListStudent listByBuilding(int buildingId) { String sql SELECT id, name, dorm_id FROM student WHERE building_id ?; ListStudent list new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, buildingId); // 参数从 1 开始计数不是 0 try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setName(rs.getString(name)); s.setDormId(rs.getInt(dorm_id)); list.add(s); } } } catch (SQLException e) { e.printStackTrace(); } return list; }PreparedStatement的setInt(1, ...)索引从 1 开始这是 JDBC 规范和数组从 0 开始不一样写惯了数组的人第一次很容易写成 0然后报Parameter index out of range。用PreparedStatement而不是拼接字符串既防 SQL 注入又能让 MySQL 复用执行计划。2.3 业务层Controller 如何串起界面与数据Controller 是中间人接收界面事件调用 DAO把结果塞回界面控件。以登录为例// LoginController.java登录校验并跳转 FXML private TextField usernameField; FXML private PasswordField passwordField; FXML private void handleLogin(ActionEvent event) throws IOException { String user usernameField.getText().trim(); String pwd passwordField.getText().trim(); if (user.isEmpty() || pwd.isEmpty()) { showAlert(用户名和密码不能为空); return; } Admin admin adminDao.login(user, pwd); // DAO 返回 null 表示失败 if (admin null) { showAlert(账号或密码错误); return; } // 加载主界面替换当前场景 Parent root FXMLLoader.load(getClass().getResource(/fxml/admin.fxml)); Stage stage (Stage) ((Node) event.getSource()).getScene().getWindow(); stage.setScene(new Scene(root)); stage.show(); }getResource(/fxml/admin.fxml)里的路径以/开头表示从 classpath 根目录找不带/则是相对当前类所在包。这两种写法混用是 FXML 加载失败的头号原因报错通常是NullPointerException或Location is not set。我一般统一用绝对路径带/省得记相对位置。3. 从零跑通数据库建库、导数据、改配置、启动这一章是纯操作照着做就能把系统跑起来。顺序不能乱先有数据库再改连接配置最后启动程序。3.1 建库与导入 SQL 脚本资源包里一般带一个.sql文件里面是建库、建表、插初始数据的完整语句。用命令行或 Navicat 都行命令行更稳# 登录 MySQL8.0 版本 mysql -u root -p # 在 MySQL 交互界面里执行 source /path/to/dorm_db.sql; # 验证切库、看表、看数据 USE dorm_db; SHOW TABLES; SELECT * FROM admin;如果脚本里没有CREATE DATABASE语句需要先手动建库再导入CREATE DATABASE dorm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;字符集用utf8mb4而不是utf8因为 MySQL 的utf8其实是阉割版存不了 emoji 和部分生僻字学生姓名里偶尔会有生僻字用utf8mb4一劳永逸。导入后重点确认三张表admin管理员、student学生、building楼栋以及它们之间的外键关系。3.2 修改 JDBC 连接参数打开DBUtil.java把 URL、用户名、密码改成你本机的参数示例值说明URLjdbc:mysql://localhost:3306/dorm_db库名必须和实际一致useSSLfalse本地开发关掉避免证书握手失败serverTimezoneAsia/Shanghai不设可能报时区异常characterEncodingutf8防中文乱码USERroot按你本机账号改PASSWORD你的密码空密码也要写改完别急着跑先确认 MySQL 服务在运行。Windows 下services.msc看 MySQL 服务状态Linux 下systemctl status mysql。服务没起后面所有报错都是白搭。3.3 导入 IDE 与依赖配置项目用 Maven 管理依赖的话pom.xml里至少要有 MySQL 驱动和 JavaFx 相关依赖!-- pom.xml 关键依赖 -- dependencies !-- MySQL 驱动8.x 版本 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- JavaFx 控件库JDK 11 之后需单独引入 -- dependency groupIdorg.openjfx/groupId artifactIdjavafx-controls/artifactId version17.0.2/version /dependency dependency groupIdorg.openjfx/groupId artifactIdjavafx-fxml/artifactId version17.0.2/version /dependency /dependenciesJDK 8 自带 JavaFxJDK 11 之后 JavaFx 被移出 JDK必须单独引依赖否则import javafx.*全部报红。这是从 JDK 8 升上来的同学最容易懵的地方。如果你的项目是 JDK 8 环境上面 JavaFx 依赖可以不加但 MySQL 驱动版本要和 JDK 匹配。启动类通常继承Application重写start方法加载登录界面// Main.java程序入口 public class Main extends Application { Override public void start(Stage stage) throws Exception { Parent root FXMLLoader.load(getClass().getResource(/fxml/login.fxml)); stage.setTitle(学生宿舍管理系统); stage.setScene(new Scene(root, 600, 400)); stage.show(); } public static void main(String[] args) { launch(args); } }launch(args)会回调start方法。如果启动后窗口一闪而过或直接报错先看控制台第一行异常八成是 FXML 路径或数据库连接的问题。4. 避坑排查FXML 加载失败、中文乱码、驱动不匹配这一章是我自己踩过、也帮别人调过的真实问题按现象 → 原因 → 解决整理遇到报错直接对号入座。4.1 现象启动报Location is not set或NullPointerException原因FXMLLoader.load()的路径写错或者 FXML 文件没被复制到target/classes。Maven 默认只把src/main/resources下的文件复制到 classpath如果你的 FXML 放在src/main/java里构建后不会被打包。解决把 FXML、CSS 统一挪到src/main/resources/fxml/和src/main/resources/css/下加载路径写成/fxml/login.fxml。改完执行mvn clean再重新编译确保资源被复制。4.2 现象界面中文显示成方块或问号原因编码链路上某一环不是 UTF-8。可能是 Java 源文件编码、MySQL 库表字符集、JDBC 连接参数三者不一致。解决三处统一。IDE 里把项目编码设为 UTF-8建库用utf8mb4JDBC URL 加characterEncodingutf8。如果已经建了库用ALTER DATABASE dorm_db CHARACTER SET utf8mb4;补救表也要ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4;。4.3 现象No suitable driver found for jdbc:mysql://...原因MySQL 驱动 jar 没进 classpath或者驱动类名写错。MySQL 5.x 是com.mysql.jdbc.Driver8.x 是com.mysql.cj.jdbc.Driver。解决确认pom.xml里有mysql-connector-java依赖且版本与数据库匹配Class.forName里的类名按版本改。如果用的是非 Maven 项目手动把 jar 加到WEB-INF/lib或 IDE 的 Libraries 里。4.4 现象插入时间字段报The server time zone value ... is unrecognized原因MySQL 8.x 默认时区是 UTCJDBC 没指定时区时无法解析。解决URL 里加serverTimezoneAsia/Shanghai。如果还不行在 MySQL 里执行SET GLOBAL time_zone 8:00;临时改服务端时区。4.5 现象按钮点击没反应控制台无报错原因FXML 里onAction绑定的方法名和 Controller 里的不一致或者方法忘了加FXML。JavaFx 反射找不到方法时有时不抛异常只是静默失败。解决逐字核对onAction#handleLogin和FXML private void handleLogin(...)方法名、大小写、参数类型都要对上。参数一般是ActionEvent也可以无参。5. 二次开发与验证把宿舍分配逻辑改成你自己的跑通只是第一步课程设计要拿高分得有自己的东西。这份源码的扩展点很清晰我一般从宿舍分配这个核心业务下手因为它最能体现业务逻辑也最容易加校验。5.1 给宿舍分配加容量校验原始逻辑可能是选学生、选宿舍、点分配就完事但真实场景里宿舍有容量上限。加一段校验// DormService.java分配前检查宿舍是否已满 public boolean assignStudent(int studentId, int dormId) { // 1. 查宿舍容量和当前人数 Dorm dorm dormDao.findById(dormId); int current studentDao.countByDorm(dormId); if (current dorm.getCapacity()) { throw new IllegalStateException(宿舍已满容量 dorm.getCapacity()); } // 2. 查学生是否已分配 Student s studentDao.findById(studentId); if (s.getDormId() ! null s.getDormId() 0) { throw new IllegalStateException(该学生已分配宿舍); } // 3. 执行分配 return studentDao.updateDorm(studentId, dormId) 0; }这段逻辑的关键是先查后写但严格来说有并发问题两个管理员同时分配最后一个床位可能都通过校验。课程设计层面够用如果想更严谨把校验和更新放进一个事务或者用UPDATE ... WHERE current capacity的原子写法。5.2 用事务保证分配的一致性JDBC 默认自动提交每条 SQL 独立事务。分配涉及更新学生表 更新宿舍人数两步必须手动控制事务// 手动事务两步操作要么都成功要么都回滚 Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交 studentDao.updateDorm(conn, studentId, dormId); dormDao.incrementCount(conn, dormId); conn.commit(); // 两步都成功才提交 } catch (SQLException e) { if (conn ! null) conn.rollback(); // 任一步失败就回滚 throw new RuntimeException(分配失败, e); } finally { if (conn ! null) { conn.setAutoCommit(true); conn.close(); } }注意 DAO 方法要接收外部传入的Connection而不是自己DBUtil.getConnection()否则事务管不到。这是 JDBC 事务处理最常见的坑连接不共享事务形同虚设。5.3 验证清单改完怎么确认没改坏改完代码别只看能启动按这个清单过一遍验证项操作预期结果登录用 admin 表里的账号登录进入管理员主界面楼栋增删新增一个楼栋再删除列表实时刷新宿舍分配给未分配学生分配宿舍学生表 dorm_id 更新容量校验给已满宿舍分配弹出宿舍已满提示事务回滚手动让第二步抛异常第一步的更新被回滚中文显示输入中文姓名保存数据库和界面都不乱码这份资源本身经过本地编译验证评审分 98 分说明基础功能是扎实的。你要做的是在它之上加自己的业务点而不是推倒重来。从那以后我每次拿到一份课程设计源码都强制先跑通原始版本、再动一行代码确认基线可用再改这个习惯帮我省了无数次改了半天发现是环境问题的后悔药。希望这份拆解能帮你把这份 JavaFxJDBCMySQL 宿舍管理系统真正用起来。本文还有配套的精品资源点击获取 JavaFx+JDBC+MySQL宿舍管理系统源码解析与实战避坑指南
简介这是一套面向高校计算机相关专业学生的JavaFxJDBCMySQL学生宿舍管理系统完整项目适合用作期末大作业、课程设计或毕业设计参考难度适中源码经本地编译可运行评审分达98分内容经助教老师审定。资源包共101个文件约472KB以36个java源文件、28个fxml界面文件、10个xml配置、4个css样式及1个sql脚本为主另含properties配置、md说明与图片素材覆盖登录、管理员、学生、宿舍楼等模块的界面与业务逻辑。已有105人学习下载。读者可获得完整可运行的项目源码、数据库脚本与文档说明便于快速理解JavaFx界面布局、JDBC数据访问与MySQL表结构设计并在此基础上二次开发或撰写设计文档是兼顾学习与提交的实用参考。1. 从一份能跑起来的 JavaFx 宿舍管理源码说起很多同学做 Java 期末大作业或课程设计时最头疼的不是写代码而是拼不出一套完整能跑的系统。网上搜到的源码要么缺数据库脚本要么 FXML 和 Controller 对不上导入 IDE 直接一片红。这份 JavaFxJDBCMySQL 实现的学生宿舍管理系统恰好是那种解压即用的完整包源码、数据库、文档说明三件套齐全本地编译过、可运行评审分 98 分难度适中适合直接拿来做课程设计或毕业设计的底子。它用 JavaFx 做界面JDBC 直连 MySQL 做数据层没有引入 Spring 那套重框架对刚学完 Java 基础、数据库原理的同学非常友好。整个项目围绕宿舍管理的核心业务展开楼栋、宿舍、学生、管理员四类角色登录、增删改查、分配宿舍这些操作都能跑通。如果你正被Java 课程设计案例源码卡住这份资源能让你把精力放在理解和二次开发上而不是从零搭架子。2. 拆开资源包FXML、CSS 与 JDBC 三层怎么咬合拿到压缩包先别急着导入 IDE花五分钟把目录结构看清楚后面能省掉大量找不到文件的玄学问题。这个项目是典型的 JavaFx MVC 分层FXML 负责界面结构CSS 负责样式Controller 负责逻辑JDBC 负责数据。2.1 界面层FXML 与 CSS 的对应关系从项目正文给出的文件清单能看出界面层的组织方式login.fxmllogin.css登录窗口admin.fxmladmin.css管理员主界面student.fxmlstudent.css学生主界面super.fxmlsuper.css超级管理员界面building.fxml楼栋管理界面这里有个新手最容易翻车的点FXML 里通过stylesheetsxxx.css引用样式路径是相对 FXML 文件本身的。如果你把 FXML 和 CSS 放到了不同目录或者导入 IDE 后资源没被复制到target/classes界面就会变成裸奔的默认控件样式按钮灰扑扑一片。常见做法是把 FXML 和同名 CSS 放在同一个包目录下构建时一起打包。FXML 里每个控件都带fx:idController 通过FXML注解注入。比如登录界面的用户名输入框!-- login.fxml 片段控件 fx:id 必须与 Controller 字段名一致 -- TextField fx:idusernameField promptText请输入用户名/ PasswordField fx:idpasswordField promptText请输入密码/ Button fx:idloginButton text登录 onAction#handleLogin/onAction#handleLogin里的方法名必须在对应的 Controller 里存在且带FXML注解否则点击按钮直接抛IllegalArgumentException。这是 JavaFx 反射绑定机制决定的不是 bug是约定。2.2 数据层JDBC 连接 MySQL 的配置与封装数据层用原生 JDBC没有 ORM。这意味着 SQL 全部手写好处是透明、好调试坏处是连接管理要自己兜住。项目里通常会有一个DBUtil或BaseDao类集中管理连接。// DBUtil.java集中管理数据库连接避免每个 DAO 重复写驱动加载 public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/dorm_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8; private static final String USER root; private static final String PASSWORD 你的密码; static { try { // MySQL 8.x 用 com.mysql.cj.jdbc.Driver5.x 用 com.mysql.jdbc.Driver Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { throw new RuntimeException(MySQL 驱动未加载, e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }几个参数必须说清楚useSSLfalse是本地开发常用写法避免自签证书握手失败serverTimezoneAsia/Shanghai不加的话MySQL 8.x 插入时间字段可能报时区异常characterEncodingutf8保证中文姓名不乱码。这三个参数是 JDBC 连 MySQL 最高频的踩坑点缺一个都可能让你调半天。DAO 层典型写法是打开连接 → 预编译 SQL → 设参 → 执行 → 关资源用 try-with-resources 自动关闭// StudentDao.java查询某楼栋下的所有学生 public ListStudent listByBuilding(int buildingId) { String sql SELECT id, name, dorm_id FROM student WHERE building_id ?; ListStudent list new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, buildingId); // 参数从 1 开始计数不是 0 try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setName(rs.getString(name)); s.setDormId(rs.getInt(dorm_id)); list.add(s); } } } catch (SQLException e) { e.printStackTrace(); } return list; }PreparedStatement的setInt(1, ...)索引从 1 开始这是 JDBC 规范和数组从 0 开始不一样写惯了数组的人第一次很容易写成 0然后报Parameter index out of range。用PreparedStatement而不是拼接字符串既防 SQL 注入又能让 MySQL 复用执行计划。2.3 业务层Controller 如何串起界面与数据Controller 是中间人接收界面事件调用 DAO把结果塞回界面控件。以登录为例// LoginController.java登录校验并跳转 FXML private TextField usernameField; FXML private PasswordField passwordField; FXML private void handleLogin(ActionEvent event) throws IOException { String user usernameField.getText().trim(); String pwd passwordField.getText().trim(); if (user.isEmpty() || pwd.isEmpty()) { showAlert(用户名和密码不能为空); return; } Admin admin adminDao.login(user, pwd); // DAO 返回 null 表示失败 if (admin null) { showAlert(账号或密码错误); return; } // 加载主界面替换当前场景 Parent root FXMLLoader.load(getClass().getResource(/fxml/admin.fxml)); Stage stage (Stage) ((Node) event.getSource()).getScene().getWindow(); stage.setScene(new Scene(root)); stage.show(); }getResource(/fxml/admin.fxml)里的路径以/开头表示从 classpath 根目录找不带/则是相对当前类所在包。这两种写法混用是 FXML 加载失败的头号原因报错通常是NullPointerException或Location is not set。我一般统一用绝对路径带/省得记相对位置。3. 从零跑通数据库建库、导数据、改配置、启动这一章是纯操作照着做就能把系统跑起来。顺序不能乱先有数据库再改连接配置最后启动程序。3.1 建库与导入 SQL 脚本资源包里一般带一个.sql文件里面是建库、建表、插初始数据的完整语句。用命令行或 Navicat 都行命令行更稳# 登录 MySQL8.0 版本 mysql -u root -p # 在 MySQL 交互界面里执行 source /path/to/dorm_db.sql; # 验证切库、看表、看数据 USE dorm_db; SHOW TABLES; SELECT * FROM admin;如果脚本里没有CREATE DATABASE语句需要先手动建库再导入CREATE DATABASE dorm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;字符集用utf8mb4而不是utf8因为 MySQL 的utf8其实是阉割版存不了 emoji 和部分生僻字学生姓名里偶尔会有生僻字用utf8mb4一劳永逸。导入后重点确认三张表admin管理员、student学生、building楼栋以及它们之间的外键关系。3.2 修改 JDBC 连接参数打开DBUtil.java把 URL、用户名、密码改成你本机的参数示例值说明URLjdbc:mysql://localhost:3306/dorm_db库名必须和实际一致useSSLfalse本地开发关掉避免证书握手失败serverTimezoneAsia/Shanghai不设可能报时区异常characterEncodingutf8防中文乱码USERroot按你本机账号改PASSWORD你的密码空密码也要写改完别急着跑先确认 MySQL 服务在运行。Windows 下services.msc看 MySQL 服务状态Linux 下systemctl status mysql。服务没起后面所有报错都是白搭。3.3 导入 IDE 与依赖配置项目用 Maven 管理依赖的话pom.xml里至少要有 MySQL 驱动和 JavaFx 相关依赖!-- pom.xml 关键依赖 -- dependencies !-- MySQL 驱动8.x 版本 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- JavaFx 控件库JDK 11 之后需单独引入 -- dependency groupIdorg.openjfx/groupId artifactIdjavafx-controls/artifactId version17.0.2/version /dependency dependency groupIdorg.openjfx/groupId artifactIdjavafx-fxml/artifactId version17.0.2/version /dependency /dependenciesJDK 8 自带 JavaFxJDK 11 之后 JavaFx 被移出 JDK必须单独引依赖否则import javafx.*全部报红。这是从 JDK 8 升上来的同学最容易懵的地方。如果你的项目是 JDK 8 环境上面 JavaFx 依赖可以不加但 MySQL 驱动版本要和 JDK 匹配。启动类通常继承Application重写start方法加载登录界面// Main.java程序入口 public class Main extends Application { Override public void start(Stage stage) throws Exception { Parent root FXMLLoader.load(getClass().getResource(/fxml/login.fxml)); stage.setTitle(学生宿舍管理系统); stage.setScene(new Scene(root, 600, 400)); stage.show(); } public static void main(String[] args) { launch(args); } }launch(args)会回调start方法。如果启动后窗口一闪而过或直接报错先看控制台第一行异常八成是 FXML 路径或数据库连接的问题。4. 避坑排查FXML 加载失败、中文乱码、驱动不匹配这一章是我自己踩过、也帮别人调过的真实问题按现象 → 原因 → 解决整理遇到报错直接对号入座。4.1 现象启动报Location is not set或NullPointerException原因FXMLLoader.load()的路径写错或者 FXML 文件没被复制到target/classes。Maven 默认只把src/main/resources下的文件复制到 classpath如果你的 FXML 放在src/main/java里构建后不会被打包。解决把 FXML、CSS 统一挪到src/main/resources/fxml/和src/main/resources/css/下加载路径写成/fxml/login.fxml。改完执行mvn clean再重新编译确保资源被复制。4.2 现象界面中文显示成方块或问号原因编码链路上某一环不是 UTF-8。可能是 Java 源文件编码、MySQL 库表字符集、JDBC 连接参数三者不一致。解决三处统一。IDE 里把项目编码设为 UTF-8建库用utf8mb4JDBC URL 加characterEncodingutf8。如果已经建了库用ALTER DATABASE dorm_db CHARACTER SET utf8mb4;补救表也要ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4;。4.3 现象No suitable driver found for jdbc:mysql://...原因MySQL 驱动 jar 没进 classpath或者驱动类名写错。MySQL 5.x 是com.mysql.jdbc.Driver8.x 是com.mysql.cj.jdbc.Driver。解决确认pom.xml里有mysql-connector-java依赖且版本与数据库匹配Class.forName里的类名按版本改。如果用的是非 Maven 项目手动把 jar 加到WEB-INF/lib或 IDE 的 Libraries 里。4.4 现象插入时间字段报The server time zone value ... is unrecognized原因MySQL 8.x 默认时区是 UTCJDBC 没指定时区时无法解析。解决URL 里加serverTimezoneAsia/Shanghai。如果还不行在 MySQL 里执行SET GLOBAL time_zone 8:00;临时改服务端时区。4.5 现象按钮点击没反应控制台无报错原因FXML 里onAction绑定的方法名和 Controller 里的不一致或者方法忘了加FXML。JavaFx 反射找不到方法时有时不抛异常只是静默失败。解决逐字核对onAction#handleLogin和FXML private void handleLogin(...)方法名、大小写、参数类型都要对上。参数一般是ActionEvent也可以无参。5. 二次开发与验证把宿舍分配逻辑改成你自己的跑通只是第一步课程设计要拿高分得有自己的东西。这份源码的扩展点很清晰我一般从宿舍分配这个核心业务下手因为它最能体现业务逻辑也最容易加校验。5.1 给宿舍分配加容量校验原始逻辑可能是选学生、选宿舍、点分配就完事但真实场景里宿舍有容量上限。加一段校验// DormService.java分配前检查宿舍是否已满 public boolean assignStudent(int studentId, int dormId) { // 1. 查宿舍容量和当前人数 Dorm dorm dormDao.findById(dormId); int current studentDao.countByDorm(dormId); if (current dorm.getCapacity()) { throw new IllegalStateException(宿舍已满容量 dorm.getCapacity()); } // 2. 查学生是否已分配 Student s studentDao.findById(studentId); if (s.getDormId() ! null s.getDormId() 0) { throw new IllegalStateException(该学生已分配宿舍); } // 3. 执行分配 return studentDao.updateDorm(studentId, dormId) 0; }这段逻辑的关键是先查后写但严格来说有并发问题两个管理员同时分配最后一个床位可能都通过校验。课程设计层面够用如果想更严谨把校验和更新放进一个事务或者用UPDATE ... WHERE current capacity的原子写法。5.2 用事务保证分配的一致性JDBC 默认自动提交每条 SQL 独立事务。分配涉及更新学生表 更新宿舍人数两步必须手动控制事务// 手动事务两步操作要么都成功要么都回滚 Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交 studentDao.updateDorm(conn, studentId, dormId); dormDao.incrementCount(conn, dormId); conn.commit(); // 两步都成功才提交 } catch (SQLException e) { if (conn ! null) conn.rollback(); // 任一步失败就回滚 throw new RuntimeException(分配失败, e); } finally { if (conn ! null) { conn.setAutoCommit(true); conn.close(); } }注意 DAO 方法要接收外部传入的Connection而不是自己DBUtil.getConnection()否则事务管不到。这是 JDBC 事务处理最常见的坑连接不共享事务形同虚设。5.3 验证清单改完怎么确认没改坏改完代码别只看能启动按这个清单过一遍验证项操作预期结果登录用 admin 表里的账号登录进入管理员主界面楼栋增删新增一个楼栋再删除列表实时刷新宿舍分配给未分配学生分配宿舍学生表 dorm_id 更新容量校验给已满宿舍分配弹出宿舍已满提示事务回滚手动让第二步抛异常第一步的更新被回滚中文显示输入中文姓名保存数据库和界面都不乱码这份资源本身经过本地编译验证评审分 98 分说明基础功能是扎实的。你要做的是在它之上加自己的业务点而不是推倒重来。从那以后我每次拿到一份课程设计源码都强制先跑通原始版本、再动一行代码确认基线可用再改这个习惯帮我省了无数次改了半天发现是环境问题的后悔药。希望这份拆解能帮你把这份 JavaFxJDBCMySQL 宿舍管理系统真正用起来。本文还有配套的精品资源点击获取