简介这是一套基于Java实现的学生宿舍管理系统项目源码主要面向高校Java课程设计、数据库实践或毕业设计人群用来解决宿舍信息录入、查询、统计及日常管理这类常见业务场景。系统使用数据库存储数据代码内附详细注解方便读者按模块理解功能逻辑同时配有项目使用文档、数据库配置文档和建表语句基本做到解压后即可导入运行。资源包共13个文件核心内容包括Java源文件、class编译文件、Eclipse工程配置文件、数据库脚本txt、Word说明文档及依赖jar包整体大小仅2.13MB结构紧凑且便于二次开发。目前已有6811人学习/下载附带的系统运行截图也可直接用于实验报告或课程作业能有效减少环境搭建与调试时间适合需要快速获得完整案例的初学者。1. 为什么“java学生宿舍管理系统”能成为 Java 课设与毕设的常青树如果你的第一个 Java 课程设计题目抽到了“学生宿舍管理系统”不要觉得意外。这个题目几乎覆盖了 Java 入门阶段该会的所有东西JDBC 连数据库、Servlet 接收请求、JSP 渲染页面、增删改查、事务、模糊查询。网上这类源码一搜一大把标题里往往写着“数据库存储、包含使用文档、代码详细注解、运行截图”看起来四件套齐全下载下来就能交差。但真正能把项目跑起来、能改明白、能在答辩时讲清楚的人不到一半。问题几乎不出在业务逻辑上而出在环境、依赖、字符集和数据库初始化这几道坎上。这篇笔记就顺着这类源码的常见构成把“拿到源码后怎么跑通、怎么改、踩了坑怎么排”的完整路径讲透。适合正在赶 Java 课设的学生、准备课程设计答辩的初学者以及想用一个完整 CRUD 项目把 JDBC 和 MySQL 串起来练手的人。2. 拆解项目源码数据库表设计、JDBC 连接与连接池选型2.1 核心表怎么设计宿舍、学生、缴费、报修不只是四张表“数据库存储”这四个字意味着所有数据都落在 MySQL 里而不是写死在 Java 代码或文本文件里。所以拿到源码第一步不是打开 Java 文件而是先建库。常见的宿舍管理系统源码核心表一般不少于五张宿舍楼栋表、房间表、学生表、缴费记录表、报修表。CREATE TABLE dorm_building ( building_id INT PRIMARY KEY AUTO_INCREMENT, building_name VARCHAR(50) NOT NULL COMMENT 楼栋名称如 1号楼, floor_count INT DEFAULT 6 COMMENT 楼层数 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT宿舍楼栋表; CREATE TABLE room ( room_id INT PRIMARY KEY AUTO_INCREMENT, building_id INT NOT NULL, room_no VARCHAR(10) NOT NULL COMMENT 房间号如 101, capacity TINYINT DEFAULT 4 COMMENT 可住人数, gender TINYINT COMMENT 1男 0女用于楼栋/楼层分性别管理, KEY idx_building (building_id), CONSTRAINT fk_room_building FOREIGN KEY (building_id) REFERENCES dorm_building(building_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT房间表; CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY COMMENT 学号, name VARCHAR(50) NOT NULL, gender TINYINT NOT NULL COMMENT 1男 0女, class_name VARCHAR(100), room_id INT, bed_no TINYINT COMMENT 床位号 1-4, checkin_date DATE, status TINYINT DEFAULT 1 COMMENT 1在住 0已退宿, KEY idx_room (room_id), CONSTRAINT fk_stu_room FOREIGN KEY (room_id) REFERENCES room(room_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生表; CREATE TABLE payment ( payment_id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, item_name VARCHAR(50) COMMENT 水费/电费/住宿费, amount DECIMAL(10,2), pay_date DATE, status TINYINT DEFAULT 0 COMMENT 0未缴 1已缴, KEY idx_stu_pay (student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT缴费表; CREATE TABLE repair ( repair_id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, room_id INT NOT NULL, description VARCHAR(255), report_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0待处理 1已完成 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT报修表;这里我刻意把楼栋和房间拆成了两张表而不是在学生表里直接存 building_name 和 room_no 字符串。原因很简单拆开之后“某栋楼还有多少空床位”这类统计可以直接用 JOIN 算不需要靠字符串匹配 room_no 去猜房间。很多浅一点的源码把楼栋和房间合成一张 dorm 表学生表里存“1号楼101”看起来省了一个 DAO但做统计时只能写 LIKE 101%后面想加一个按性别查空房的功能就要重构这是课设源码里最常见的表设计缺陷。外键在这个项目里建议保留但要注意批量导入数据的顺序先楼栋再房间再学生。如果源码里的建表脚本没带外键只有字段名那也不影响功能属于逻辑外键的写法在数据量小的课设里完全够用。2.2 三层架构与连接选型为什么课设项目普遍偏爱 JDBC MySQL学生宿舍管理系统的本质是一组围绕“学生—房间—缴费—报修”的增删改查数据量撑死几千行。这种体量下Servlet JSP JDBC MySQL 是最保守也最保险的组合。不推荐在课设里为了显摆上 Spring Boot MyBatis Plus除非课程大纲明确允许。用 JDBC 直连的好处是每一行代码都在你眼皮底下面试或答辩被问到“数据库连接是怎么建立的”时能从头讲到尾不会被框架的黑匣子卡住。连接数据库有两条路一条是 DriverManager.getConnection每次请求新建连接用完关闭另一条是连接池启动时建好一批连接反复复用。课设源码里写 DriverManager 的偏多因为代码短、好解释。但只要你把项目往多人使用或多窗口并发的方向想连接池几乎是必须的。我一般会建议直接用 Druid配置少监控页还能在答辩时当亮点。# druid.properties driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/dorm_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue usernameroot password123456 initialSize5 maxActive20 maxWait3000import com.alibaba.druid.pool.DruidDataSource; import com.alibaba.druid.pool.DruidDataSourceFactory; import javax.sql.DataSource; import java.io.InputStream; import java.sql.Connection; import java.sql.SQLException; import java.util.Properties; public class DBUtil { private static DataSource dataSource; static { try (InputStream in DBUtil.class.getClassLoader().getResourceAsStream(druid.properties)) { Properties props new Properties(); props.load(in); dataSource DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }代码逻辑不复杂类加载时读取 druid.properties用 Druid 的工厂方法创建数据源之后所有 DAO 都通过 DBUtil.getConnection() 拿连接不再需要 Class.forName 注册驱动。关键参数里initialSize 是启动时预建的连接数maxActive 是连接数的上限maxWait 是拿不到连接时最多等多久单位毫秒。课设这种体量5/20/3000 完全够不要学网上教程调成 100/200连接池开太大反而拖慢启动这是很多人容易犯的错。顺便说一句JDBC URL 里的 useSSLfalse 和 serverTimezoneAsia/Shanghai 是 MySQL 8.0 时代的标配。少了 serverTimezone驱动会报 CST 时区无法识别少了 useSSL 和 allowPublicKeyRetrieval8.0 的默认认证插件 caching_sha2_password 会在连接时报 Public Key Retrieval is not allowed。这段配置如果直接从旧项目拷贝十有八九要翻车。2.3 使用文档和运行截图说明了什么拿到源码先看这两样这类源码标题里的“使用文档”和“运行截图”不是装饰品。我的习惯是解压源码后先不碰代码先把使用文档翻一遍重点看三处数据库初始化步骤、默认登录账号、运行环境要求。文档里写了 MySQL 5.7你本地装的是 8.0就要预想到驱动不兼容的问题文档里默认密码是 admin/123456你连数据库的密码是别的就要先找到配置文件改掉。运行截图的价值在于对照。截图里登录页长什么样、列表页有哪些按钮、新增表单有哪些字段这些都是验收基准。当你把项目跑起来发现页面和截图对不上排除代码被改过的因素后通常就是 JDK 版本或 MySQL 版本差异导致的小毛病。截图还能帮你判断这个源码是不是完整可运行的一个连登录后的主页面截图都没有的源码包风险很高建议直接放弃。3. 从下载到跑通导入源码、执行 SQL、启动服务的最小操作链3.1 环境版本怎么搭不会翻车JDK、Tomcat、MySQL 的常见搭配跑这类项目环境版本是最容易出幺蛾子的地方。给你一张我常用的搭配表照着选不会错组合JDKTomcatMySQL驱动保守组合JDK 8Tomcat 8.5MySQL 5.7mysql-connector-java 5.1.49主流组合JDK 8Tomcat 9MySQL 5.7mysql-connector-java 5.1.49新版组合JDK 11Tomcat 9MySQL 8.0mysql-connector-java 8.0.x如果你的课设代码里出现com.mysql.jdbc.Driver而本地是 MySQL 8.0建议直接换 8.0 驱动并改成com.mysql.cj.jdbc.Driver否则会报 ClassNotFoundException 或连接超时。反过来驱动版本高于数据库版本一般没问题但低于数据库版本时常出事尤其是 MySQL 8.0 换了认证插件之后。IDE 方面Eclipse 和 IntelliJ IDEA 都能跑但注意 Eclipse 的 Dynamic Web Project 和 IDEA 的 Web Application 项目结构不同导入源码时别选错。源码包里自带 .classpath 和 .project 文件的用 Eclipse 开最省事只有 pom.xml 的直接 IDEA 以 Maven 项目导入。3.2 执行 SQL 脚本与修改连接参数跑通项目前必做的两件事拿到源码后最先动的是数据库。找到一个 SQL 脚本文件名一般是 dorm_system.sql 或 database.sql。先建库再导入mysql -u root -p -e CREATE DATABASE dorm_system DEFAULT CHARACTER SET utf8mb4; mysql -u root -p dorm_system dorm_system.sql第一行命令创建数据库第二行把脚本里的表结构和初始数据导入。注意两个细节一是-e参数直接执行 SQL等于在建库命令里把 CHARACTER SET 一并指定避免后续导入时因字符集不一致产生中文乱码二是导入前确认脚本里有没有CREATE DATABASE或USE语句。很多源码的脚本开头就写了USE dorm_system;如果你建的库名和它不一致导入会失败或者表建到了别的库里。接下来修改数据库连接参数。不管是 JDBC 直连还是连接池总有一个配置文件或工具类里藏着反斜杠转义后的连接串。以 Druid 为例要改的是 druid.properties 里的 username、password以及 url 里的库名。很多源码的默认密码是 root 的常见组合比如 123456 或 root自己机器的密码不一样就必须改这里改错了启动时直接报 Access denied。改完参数后建议先在命令行里验证一遍连接不要直接启动 Tomcatmysql -u root -p dorm_system -e SELECT COUNT(*) FROM student;能查出条数说明库和表都正常接下来启动服务才有意义。这一步能帮你把“代码问题”和“环境问题”切分开省去后面连环排错的时间。3.3 启动、访问与运行截图核对怎么确认系统端到端是通的第一次启动别急着点浏览器。先确认三件事项目是否成功部署、Tomcat 端口是否被占用、上下文路径是什么。用 IDEA 跑 Tomcat 时控制台日志里出现“Artifact 已部署”或“Deployment of web application ... has finished”才算部署完成。访问地址是由上下文路径决定的。如果你的项目在 IDEA 的 Deployment 里配置的是/dorm_system那访问地址就是http://localhost:8080/dorm_system/很多新手在这一步翻车是因为热烈期盼首页结果访问 http://localhost:8080/ 直接 404。记住根路径和项目路径完全是两码事Tomcat 的 ROOT 应用不是你部署的这个项目。跑起来的项目对照源码自带的运行截图逐页核对登录页、主页、学生列表页、新增页面。页面结构一致说明端到端链路通了不一致优先查数据库里的初始数据是否导入完整因为截图里列表页的数据量和数据库里的数据量对不上多半是 SQL 脚本没执行完。4. 跟着详细注解改功能入住、退宿、查询里的业务逻辑怎么写4.1 入住与退宿事务边界划在哪里代码才不会出乱子学生入住这件事表面上是“往 student 表插一条记录”实际上牵动三处数据student 表插入新学生room 表的可用床位减一必要时写入一条入住日志。这三步必须在一个事务里否则插入了学生但床位没扣再来一个学生就可能超住。public boolean checkIn(Student stu) throws SQLException { Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 开启事务 int used countBedUsed(conn, stu.getRoomId()); int capacity getRoomCapacity(conn, stu.getRoomId()); if (used capacity) { return false; // 房间已满回滚 } insertStudent(conn, stu); updateRoomUsed(conn, stu.getRoomId(), 1); // 占用床位 insertLog(conn, stu.getStudentId(), CHECK_IN); conn.commit(); return true; } catch (SQLException e) { if (conn ! null) { conn.rollback(); } throw e; } finally { if (conn ! null) { conn.setAutoCommit(true); // 还原连接状态方便连接池回收 conn.close(); } } }这段代码的核心是三条setAutoCommit(false) 把连接切到手动提交模式业务全部成功才 commit任何一步异常就 rollback把前面插入的学生记录一并撤销。finally 里把 autoCommit 改回 true 是很多人会漏掉的细节尤其是用了连接池之后连接归还前要恢复默认状态否则下次从池里拿到这条连接时事务状态还是关闭的后面的操作会莫名失效。另外countBedUsed 和 getRoomCapacity 在并发场景下要加行锁不然两个请求同时查到“还剩一个床位”就可能超住。课设里用SELECT ... FOR UPDATE锁住 room 表对应的那行就够了别一上来就用表锁。退宿是反方向操作student 表状态改为 0room 表占用减一再检查该学生有没有未缴费用。退宿时如果只改学生状态、不减床位时间一长数据就乱了这也是答辩时老师最喜欢问的边界。4.2 模糊查询与多条件筛选宿舍管理里最常见的答辩送分题学生列表页一般都有搜索框支持按学号、姓名、班级、宿舍状态组合筛选。这题答得好不好就看你 DAO 层写的是字符串拼接 SQL还是用 StringBuilder 动态拼参数化 SQL。public ListStudent search(String keyword, String className, Integer status) { StringBuilder sql new StringBuilder(SELECT * FROM student WHERE 11 ); ListObject params new ArrayList(); if (keyword ! null !keyword.trim().isEmpty()) { sql.append(AND (student_id LIKE ? OR name LIKE ?) ); String like % keyword.trim() %; params.add(like); params.add(like); } if (className ! null !className.trim().isEmpty()) { sql.append(AND class_name ? ); params.add(className.trim()); } if (status ! null) { sql.append(AND status ? ); params.add(status); } // 后续交给 PreparedStatement 执行params 用于 setObject 填充占位符 return queryList(sql.toString(), params); }用 StringBuilder 而不是字符串加号拼接不是为了炫技是为了可读性和防止 SQL 注入。这里最关键的一点是LIKE 的模糊部分通过%加?传入而不是直接拼进 SQL。你永远不知道用户会在搜索框里输入什么万一是 OR 11 --字符串拼接直接就把整张表捞出来了而参数化查询会把整段输入当成一个普通字符串去匹配。另一个容易忽略的点是 LIKE 放在 ORDER BY 里不生效。如果要按时间排序排序字段必须用白名单判断不能直接把用户输入拼进 ORDER BY。很多课设源码在这里偷懒用字符串拼接排序字段一旦表结构字段名变了SQL 直接报错。4.3 统计报表房间入住率用一条 GROUP BY 讲清楚答辩时另一道高频题是“你们系统有没有统计功能”。有和没有印象分差一个档。最简单的统计是房间入住率按房间分组统计已入住人数SELECT r.room_id, r.room_no, b.building_name, COUNT(s.student_id) AS occupied, r.capacity, ROUND(COUNT(s.student_id) / r.capacity * 100, 1) AS rate FROM room r JOIN dorm_building b ON r.building_id b.building_id LEFT JOIN student s ON r.room_id s.room_id AND s.status 1 GROUP BY r.room_id, r.room_no, b.building_name, r.capacity;这条 SQL 的关键是 LEFT JOIN 而不是 INNER JOIN。LEFT JOIN 保证没住人的房间也会出现在结果里occupied 为 0rate 为 0否则空房间会直接被 INNER JOIN 过滤掉统计结果会比实际少一截。WHERE 里的 s.status 1 要放在 JOIN 的 ON 条件里而不是 WHERE 里放在 WHERE 里等于把 LEFT JOIN 变回了 INNER JOIN已退宿的房间也会丢失这一行。我把这条 SQL 做成一个视图或者封装到 DAO 里页面端只需要遍历结果集渲染表格。答辩时把这条 SQL 从头讲到尾从 JOIN 类型讲到分组字段基本能挡住“你们的统计是怎么实现的”这类追问。5. 运行与排错避坑指南5 个让新手项目翻车的常见问题5.1 现象启动 Tomcat 正常但页面请求一直转圈最后报 Communications link failure原因最常见的是 MySQL 没启动或者 JDBC URL 里的端口/主机名对不上。MySQL 默认端口 3306如果你本机装过多个版本数据库其中一个占了 3306另一个被挤到 3307URL 没改就会连错实例。MySQL 8.0 还用了一种叫 caching_sha2_password 的认证插件老驱动不支持就会在握手阶段失败。解决先确认 MySQL 进程活着Linux/Mac 用ps -ef | grep mysqldWindows 在服务管理里看 MySQL 服务是否已启动。然后看驱动版本MySQL 8.0 必须用 8.x 驱动URL 里带上useSSLfalse和allowPublicKeyRetrievaltrue。最后在 DBUtil 里打印一条连接成功的日志确认数据库连接是通的再去查别的问题。5.2 现象中文全部变成问号登录页显示“????”原因字符集混乱。SQL 脚本里的表是 utf8mb4但 JDBC URL 没带 characterEncodingutf8或者数据库本身是 latin1。MySQL 5.7 的默认字符集经常不是 utf8建库时没指定 CHARACTER SET库和表的字符集就可能不一致。解决两条路同时走。建库时显式指定DEFAULT CHARACTER SET utf8mb4JDBC URL 里加useUnicodetruecharacterEncodingutf8。注意 8.0 的驱动里 utf8 会自动映射成 utf8mb4但 5.7 不会表结构如果是 utf8mb4连接串最好写 utf8mb4。改完两个地方后重启 Tomcat之前插入的问号数据要清掉重来别指望改配置能把已损坏的数据修复。5.3 现象SQL 脚本导入“成功”但启动后报Table xxx doesnt exist原因脚本开头有USE some_db;导入时把数据建到了别的库或者脚本里创建表和插入数据的语句分散某一条中间失败了后面依赖这张表的语句全部落空。还有一类坑是脚本里带了视图或存储过程导到一半因为定义顺序问题中断但客户端没报明显错误。解决打开脚本文件看前几行确认有没有 USE 语句把库名改成自己的库。用命令行source /path/to/dorm_system.sql重新导入不要复制粘贴到图形客户端里分段执行。导入之后用SHOW TABLES;逐一核对表清单确认学生表、房间表、缴费表都建出来了再启动项目。5.4 现象部署没问题访问页面 404或者报 ClassNotFoundException: com.mysql.jdbc.Driver原因驱动 jar 没打进 WEB-INF/lib或者用 IDEA 部署时 Artifacts 里没把 lib 目录带上。很多新手把 jar 拖进了项目目录但 IDEA 在构建时会忽略项目根目录下散落的 jar只有进了 Artifacts 的 Output Layout 才会被复制到部署目录。解决在 IDEA 里打开 Project Structure找到 Artifacts在 Output Layout 里确认 WEB-INF/lib 下有没有 mysql-connector-java 的 jar。没有就右键添加 Library Files。更稳妥的做法是把项目改成 Maven 结构在 pom.xml 里声明依赖让 Maven 统一管 jar。改完记得 Rebuild Project清理 target 目录再重启 Tomcat。5.5 现象改了 Java 代码重启 Tomcat 后页面还是旧效果原因IDEA 的 Artifacts 没有更新或者 Tomcat 的 webapps 目录下残留旧版本的部署包。浏览器缓存也是帮凶尤其是静态页面和 JS 文件会顽固地保留旧版本。很多人改代码后习惯性点一下浏览器刷新以为万无一失结果盯着旧页面干着急。解决在 IDEA 里执行 Build Rebuild Project再确认 Tomcat 运行配置里的 Deployment 是否勾选了“Update resources”。浏览器按 F12 打开开发者工具勾选 Disable cache或者直接用无痕窗口。最彻底的办法是停掉 Tomcat手动删除部署目录下的旧项目文件重新 Run。6. 让这个项目从“能交差”到“能答辩”三个值得做的改进方向如果你还有时间不要满足于把源码跑通。按下面三个方向各加一点东西答辩时的技术含量会明显不一样。第一个方向是把裸 JDBC 换成连接池。上面第二章给出的 Druid 配置可以直接用改完之后把 initialSize、maxActive、maxWait 各代表什么、为什么不能调得太大讲清楚。就这一个改动就能把“会用 DriverManager 连数据库”和“了解数据库连接生命周期”区分开。第二个方向是给系统加一个登录拦截。很多课设源码的登录页只是摆设直接访问列表页也能看到数据。写一个 Filter 拦截所有需要登录的请求未登录就跳回登录页这个逻辑不难但它是 Java Web 面试和课设答辩都被高频追问的一层。网上那些“比较 Java 框架”的讨论非常多但把 Servlet 层面的会话控制亲手写一遍比看二十篇框架对比都管用。第三个方向是给自己造一批测试数据认真走一遍三个流程入住满房、退宿销账、缴费状态变更。重点验证满房时能不能正确拒绝入住、退宿时房间床位会不会释放、未缴费用会不会在退宿时被拦截。这些边界用例比“系统能跑”更有说服力。我的习惯是拿到任何一份新源码先跑通再改代码从不一上来就重构。跑通的过程中把环境、依赖、字符集这三块老坑摸一遍后面再遇到类似项目就不会再翻车。希望帮到你。本文还有配套的精品资源点击获取
Java宿舍管理系统源码跑通与改造：JDBC+MySQL实战指南
简介这是一套基于Java实现的学生宿舍管理系统项目源码主要面向高校Java课程设计、数据库实践或毕业设计人群用来解决宿舍信息录入、查询、统计及日常管理这类常见业务场景。系统使用数据库存储数据代码内附详细注解方便读者按模块理解功能逻辑同时配有项目使用文档、数据库配置文档和建表语句基本做到解压后即可导入运行。资源包共13个文件核心内容包括Java源文件、class编译文件、Eclipse工程配置文件、数据库脚本txt、Word说明文档及依赖jar包整体大小仅2.13MB结构紧凑且便于二次开发。目前已有6811人学习/下载附带的系统运行截图也可直接用于实验报告或课程作业能有效减少环境搭建与调试时间适合需要快速获得完整案例的初学者。1. 为什么“java学生宿舍管理系统”能成为 Java 课设与毕设的常青树如果你的第一个 Java 课程设计题目抽到了“学生宿舍管理系统”不要觉得意外。这个题目几乎覆盖了 Java 入门阶段该会的所有东西JDBC 连数据库、Servlet 接收请求、JSP 渲染页面、增删改查、事务、模糊查询。网上这类源码一搜一大把标题里往往写着“数据库存储、包含使用文档、代码详细注解、运行截图”看起来四件套齐全下载下来就能交差。但真正能把项目跑起来、能改明白、能在答辩时讲清楚的人不到一半。问题几乎不出在业务逻辑上而出在环境、依赖、字符集和数据库初始化这几道坎上。这篇笔记就顺着这类源码的常见构成把“拿到源码后怎么跑通、怎么改、踩了坑怎么排”的完整路径讲透。适合正在赶 Java 课设的学生、准备课程设计答辩的初学者以及想用一个完整 CRUD 项目把 JDBC 和 MySQL 串起来练手的人。2. 拆解项目源码数据库表设计、JDBC 连接与连接池选型2.1 核心表怎么设计宿舍、学生、缴费、报修不只是四张表“数据库存储”这四个字意味着所有数据都落在 MySQL 里而不是写死在 Java 代码或文本文件里。所以拿到源码第一步不是打开 Java 文件而是先建库。常见的宿舍管理系统源码核心表一般不少于五张宿舍楼栋表、房间表、学生表、缴费记录表、报修表。CREATE TABLE dorm_building ( building_id INT PRIMARY KEY AUTO_INCREMENT, building_name VARCHAR(50) NOT NULL COMMENT 楼栋名称如 1号楼, floor_count INT DEFAULT 6 COMMENT 楼层数 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT宿舍楼栋表; CREATE TABLE room ( room_id INT PRIMARY KEY AUTO_INCREMENT, building_id INT NOT NULL, room_no VARCHAR(10) NOT NULL COMMENT 房间号如 101, capacity TINYINT DEFAULT 4 COMMENT 可住人数, gender TINYINT COMMENT 1男 0女用于楼栋/楼层分性别管理, KEY idx_building (building_id), CONSTRAINT fk_room_building FOREIGN KEY (building_id) REFERENCES dorm_building(building_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT房间表; CREATE TABLE student ( student_id VARCHAR(20) PRIMARY KEY COMMENT 学号, name VARCHAR(50) NOT NULL, gender TINYINT NOT NULL COMMENT 1男 0女, class_name VARCHAR(100), room_id INT, bed_no TINYINT COMMENT 床位号 1-4, checkin_date DATE, status TINYINT DEFAULT 1 COMMENT 1在住 0已退宿, KEY idx_room (room_id), CONSTRAINT fk_stu_room FOREIGN KEY (room_id) REFERENCES room(room_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生表; CREATE TABLE payment ( payment_id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, item_name VARCHAR(50) COMMENT 水费/电费/住宿费, amount DECIMAL(10,2), pay_date DATE, status TINYINT DEFAULT 0 COMMENT 0未缴 1已缴, KEY idx_stu_pay (student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT缴费表; CREATE TABLE repair ( repair_id INT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL, room_id INT NOT NULL, description VARCHAR(255), report_time DATETIME DEFAULT CURRENT_TIMESTAMP, status TINYINT DEFAULT 0 COMMENT 0待处理 1已完成 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT报修表;这里我刻意把楼栋和房间拆成了两张表而不是在学生表里直接存 building_name 和 room_no 字符串。原因很简单拆开之后“某栋楼还有多少空床位”这类统计可以直接用 JOIN 算不需要靠字符串匹配 room_no 去猜房间。很多浅一点的源码把楼栋和房间合成一张 dorm 表学生表里存“1号楼101”看起来省了一个 DAO但做统计时只能写 LIKE 101%后面想加一个按性别查空房的功能就要重构这是课设源码里最常见的表设计缺陷。外键在这个项目里建议保留但要注意批量导入数据的顺序先楼栋再房间再学生。如果源码里的建表脚本没带外键只有字段名那也不影响功能属于逻辑外键的写法在数据量小的课设里完全够用。2.2 三层架构与连接选型为什么课设项目普遍偏爱 JDBC MySQL学生宿舍管理系统的本质是一组围绕“学生—房间—缴费—报修”的增删改查数据量撑死几千行。这种体量下Servlet JSP JDBC MySQL 是最保守也最保险的组合。不推荐在课设里为了显摆上 Spring Boot MyBatis Plus除非课程大纲明确允许。用 JDBC 直连的好处是每一行代码都在你眼皮底下面试或答辩被问到“数据库连接是怎么建立的”时能从头讲到尾不会被框架的黑匣子卡住。连接数据库有两条路一条是 DriverManager.getConnection每次请求新建连接用完关闭另一条是连接池启动时建好一批连接反复复用。课设源码里写 DriverManager 的偏多因为代码短、好解释。但只要你把项目往多人使用或多窗口并发的方向想连接池几乎是必须的。我一般会建议直接用 Druid配置少监控页还能在答辩时当亮点。# druid.properties driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/dorm_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue usernameroot password123456 initialSize5 maxActive20 maxWait3000import com.alibaba.druid.pool.DruidDataSource; import com.alibaba.druid.pool.DruidDataSourceFactory; import javax.sql.DataSource; import java.io.InputStream; import java.sql.Connection; import java.sql.SQLException; import java.util.Properties; public class DBUtil { private static DataSource dataSource; static { try (InputStream in DBUtil.class.getClassLoader().getResourceAsStream(druid.properties)) { Properties props new Properties(); props.load(in); dataSource DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }代码逻辑不复杂类加载时读取 druid.properties用 Druid 的工厂方法创建数据源之后所有 DAO 都通过 DBUtil.getConnection() 拿连接不再需要 Class.forName 注册驱动。关键参数里initialSize 是启动时预建的连接数maxActive 是连接数的上限maxWait 是拿不到连接时最多等多久单位毫秒。课设这种体量5/20/3000 完全够不要学网上教程调成 100/200连接池开太大反而拖慢启动这是很多人容易犯的错。顺便说一句JDBC URL 里的 useSSLfalse 和 serverTimezoneAsia/Shanghai 是 MySQL 8.0 时代的标配。少了 serverTimezone驱动会报 CST 时区无法识别少了 useSSL 和 allowPublicKeyRetrieval8.0 的默认认证插件 caching_sha2_password 会在连接时报 Public Key Retrieval is not allowed。这段配置如果直接从旧项目拷贝十有八九要翻车。2.3 使用文档和运行截图说明了什么拿到源码先看这两样这类源码标题里的“使用文档”和“运行截图”不是装饰品。我的习惯是解压源码后先不碰代码先把使用文档翻一遍重点看三处数据库初始化步骤、默认登录账号、运行环境要求。文档里写了 MySQL 5.7你本地装的是 8.0就要预想到驱动不兼容的问题文档里默认密码是 admin/123456你连数据库的密码是别的就要先找到配置文件改掉。运行截图的价值在于对照。截图里登录页长什么样、列表页有哪些按钮、新增表单有哪些字段这些都是验收基准。当你把项目跑起来发现页面和截图对不上排除代码被改过的因素后通常就是 JDK 版本或 MySQL 版本差异导致的小毛病。截图还能帮你判断这个源码是不是完整可运行的一个连登录后的主页面截图都没有的源码包风险很高建议直接放弃。3. 从下载到跑通导入源码、执行 SQL、启动服务的最小操作链3.1 环境版本怎么搭不会翻车JDK、Tomcat、MySQL 的常见搭配跑这类项目环境版本是最容易出幺蛾子的地方。给你一张我常用的搭配表照着选不会错组合JDKTomcatMySQL驱动保守组合JDK 8Tomcat 8.5MySQL 5.7mysql-connector-java 5.1.49主流组合JDK 8Tomcat 9MySQL 5.7mysql-connector-java 5.1.49新版组合JDK 11Tomcat 9MySQL 8.0mysql-connector-java 8.0.x如果你的课设代码里出现com.mysql.jdbc.Driver而本地是 MySQL 8.0建议直接换 8.0 驱动并改成com.mysql.cj.jdbc.Driver否则会报 ClassNotFoundException 或连接超时。反过来驱动版本高于数据库版本一般没问题但低于数据库版本时常出事尤其是 MySQL 8.0 换了认证插件之后。IDE 方面Eclipse 和 IntelliJ IDEA 都能跑但注意 Eclipse 的 Dynamic Web Project 和 IDEA 的 Web Application 项目结构不同导入源码时别选错。源码包里自带 .classpath 和 .project 文件的用 Eclipse 开最省事只有 pom.xml 的直接 IDEA 以 Maven 项目导入。3.2 执行 SQL 脚本与修改连接参数跑通项目前必做的两件事拿到源码后最先动的是数据库。找到一个 SQL 脚本文件名一般是 dorm_system.sql 或 database.sql。先建库再导入mysql -u root -p -e CREATE DATABASE dorm_system DEFAULT CHARACTER SET utf8mb4; mysql -u root -p dorm_system dorm_system.sql第一行命令创建数据库第二行把脚本里的表结构和初始数据导入。注意两个细节一是-e参数直接执行 SQL等于在建库命令里把 CHARACTER SET 一并指定避免后续导入时因字符集不一致产生中文乱码二是导入前确认脚本里有没有CREATE DATABASE或USE语句。很多源码的脚本开头就写了USE dorm_system;如果你建的库名和它不一致导入会失败或者表建到了别的库里。接下来修改数据库连接参数。不管是 JDBC 直连还是连接池总有一个配置文件或工具类里藏着反斜杠转义后的连接串。以 Druid 为例要改的是 druid.properties 里的 username、password以及 url 里的库名。很多源码的默认密码是 root 的常见组合比如 123456 或 root自己机器的密码不一样就必须改这里改错了启动时直接报 Access denied。改完参数后建议先在命令行里验证一遍连接不要直接启动 Tomcatmysql -u root -p dorm_system -e SELECT COUNT(*) FROM student;能查出条数说明库和表都正常接下来启动服务才有意义。这一步能帮你把“代码问题”和“环境问题”切分开省去后面连环排错的时间。3.3 启动、访问与运行截图核对怎么确认系统端到端是通的第一次启动别急着点浏览器。先确认三件事项目是否成功部署、Tomcat 端口是否被占用、上下文路径是什么。用 IDEA 跑 Tomcat 时控制台日志里出现“Artifact 已部署”或“Deployment of web application ... has finished”才算部署完成。访问地址是由上下文路径决定的。如果你的项目在 IDEA 的 Deployment 里配置的是/dorm_system那访问地址就是http://localhost:8080/dorm_system/很多新手在这一步翻车是因为热烈期盼首页结果访问 http://localhost:8080/ 直接 404。记住根路径和项目路径完全是两码事Tomcat 的 ROOT 应用不是你部署的这个项目。跑起来的项目对照源码自带的运行截图逐页核对登录页、主页、学生列表页、新增页面。页面结构一致说明端到端链路通了不一致优先查数据库里的初始数据是否导入完整因为截图里列表页的数据量和数据库里的数据量对不上多半是 SQL 脚本没执行完。4. 跟着详细注解改功能入住、退宿、查询里的业务逻辑怎么写4.1 入住与退宿事务边界划在哪里代码才不会出乱子学生入住这件事表面上是“往 student 表插一条记录”实际上牵动三处数据student 表插入新学生room 表的可用床位减一必要时写入一条入住日志。这三步必须在一个事务里否则插入了学生但床位没扣再来一个学生就可能超住。public boolean checkIn(Student stu) throws SQLException { Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 开启事务 int used countBedUsed(conn, stu.getRoomId()); int capacity getRoomCapacity(conn, stu.getRoomId()); if (used capacity) { return false; // 房间已满回滚 } insertStudent(conn, stu); updateRoomUsed(conn, stu.getRoomId(), 1); // 占用床位 insertLog(conn, stu.getStudentId(), CHECK_IN); conn.commit(); return true; } catch (SQLException e) { if (conn ! null) { conn.rollback(); } throw e; } finally { if (conn ! null) { conn.setAutoCommit(true); // 还原连接状态方便连接池回收 conn.close(); } } }这段代码的核心是三条setAutoCommit(false) 把连接切到手动提交模式业务全部成功才 commit任何一步异常就 rollback把前面插入的学生记录一并撤销。finally 里把 autoCommit 改回 true 是很多人会漏掉的细节尤其是用了连接池之后连接归还前要恢复默认状态否则下次从池里拿到这条连接时事务状态还是关闭的后面的操作会莫名失效。另外countBedUsed 和 getRoomCapacity 在并发场景下要加行锁不然两个请求同时查到“还剩一个床位”就可能超住。课设里用SELECT ... FOR UPDATE锁住 room 表对应的那行就够了别一上来就用表锁。退宿是反方向操作student 表状态改为 0room 表占用减一再检查该学生有没有未缴费用。退宿时如果只改学生状态、不减床位时间一长数据就乱了这也是答辩时老师最喜欢问的边界。4.2 模糊查询与多条件筛选宿舍管理里最常见的答辩送分题学生列表页一般都有搜索框支持按学号、姓名、班级、宿舍状态组合筛选。这题答得好不好就看你 DAO 层写的是字符串拼接 SQL还是用 StringBuilder 动态拼参数化 SQL。public ListStudent search(String keyword, String className, Integer status) { StringBuilder sql new StringBuilder(SELECT * FROM student WHERE 11 ); ListObject params new ArrayList(); if (keyword ! null !keyword.trim().isEmpty()) { sql.append(AND (student_id LIKE ? OR name LIKE ?) ); String like % keyword.trim() %; params.add(like); params.add(like); } if (className ! null !className.trim().isEmpty()) { sql.append(AND class_name ? ); params.add(className.trim()); } if (status ! null) { sql.append(AND status ? ); params.add(status); } // 后续交给 PreparedStatement 执行params 用于 setObject 填充占位符 return queryList(sql.toString(), params); }用 StringBuilder 而不是字符串加号拼接不是为了炫技是为了可读性和防止 SQL 注入。这里最关键的一点是LIKE 的模糊部分通过%加?传入而不是直接拼进 SQL。你永远不知道用户会在搜索框里输入什么万一是 OR 11 --字符串拼接直接就把整张表捞出来了而参数化查询会把整段输入当成一个普通字符串去匹配。另一个容易忽略的点是 LIKE 放在 ORDER BY 里不生效。如果要按时间排序排序字段必须用白名单判断不能直接把用户输入拼进 ORDER BY。很多课设源码在这里偷懒用字符串拼接排序字段一旦表结构字段名变了SQL 直接报错。4.3 统计报表房间入住率用一条 GROUP BY 讲清楚答辩时另一道高频题是“你们系统有没有统计功能”。有和没有印象分差一个档。最简单的统计是房间入住率按房间分组统计已入住人数SELECT r.room_id, r.room_no, b.building_name, COUNT(s.student_id) AS occupied, r.capacity, ROUND(COUNT(s.student_id) / r.capacity * 100, 1) AS rate FROM room r JOIN dorm_building b ON r.building_id b.building_id LEFT JOIN student s ON r.room_id s.room_id AND s.status 1 GROUP BY r.room_id, r.room_no, b.building_name, r.capacity;这条 SQL 的关键是 LEFT JOIN 而不是 INNER JOIN。LEFT JOIN 保证没住人的房间也会出现在结果里occupied 为 0rate 为 0否则空房间会直接被 INNER JOIN 过滤掉统计结果会比实际少一截。WHERE 里的 s.status 1 要放在 JOIN 的 ON 条件里而不是 WHERE 里放在 WHERE 里等于把 LEFT JOIN 变回了 INNER JOIN已退宿的房间也会丢失这一行。我把这条 SQL 做成一个视图或者封装到 DAO 里页面端只需要遍历结果集渲染表格。答辩时把这条 SQL 从头讲到尾从 JOIN 类型讲到分组字段基本能挡住“你们的统计是怎么实现的”这类追问。5. 运行与排错避坑指南5 个让新手项目翻车的常见问题5.1 现象启动 Tomcat 正常但页面请求一直转圈最后报 Communications link failure原因最常见的是 MySQL 没启动或者 JDBC URL 里的端口/主机名对不上。MySQL 默认端口 3306如果你本机装过多个版本数据库其中一个占了 3306另一个被挤到 3307URL 没改就会连错实例。MySQL 8.0 还用了一种叫 caching_sha2_password 的认证插件老驱动不支持就会在握手阶段失败。解决先确认 MySQL 进程活着Linux/Mac 用ps -ef | grep mysqldWindows 在服务管理里看 MySQL 服务是否已启动。然后看驱动版本MySQL 8.0 必须用 8.x 驱动URL 里带上useSSLfalse和allowPublicKeyRetrievaltrue。最后在 DBUtil 里打印一条连接成功的日志确认数据库连接是通的再去查别的问题。5.2 现象中文全部变成问号登录页显示“????”原因字符集混乱。SQL 脚本里的表是 utf8mb4但 JDBC URL 没带 characterEncodingutf8或者数据库本身是 latin1。MySQL 5.7 的默认字符集经常不是 utf8建库时没指定 CHARACTER SET库和表的字符集就可能不一致。解决两条路同时走。建库时显式指定DEFAULT CHARACTER SET utf8mb4JDBC URL 里加useUnicodetruecharacterEncodingutf8。注意 8.0 的驱动里 utf8 会自动映射成 utf8mb4但 5.7 不会表结构如果是 utf8mb4连接串最好写 utf8mb4。改完两个地方后重启 Tomcat之前插入的问号数据要清掉重来别指望改配置能把已损坏的数据修复。5.3 现象SQL 脚本导入“成功”但启动后报Table xxx doesnt exist原因脚本开头有USE some_db;导入时把数据建到了别的库或者脚本里创建表和插入数据的语句分散某一条中间失败了后面依赖这张表的语句全部落空。还有一类坑是脚本里带了视图或存储过程导到一半因为定义顺序问题中断但客户端没报明显错误。解决打开脚本文件看前几行确认有没有 USE 语句把库名改成自己的库。用命令行source /path/to/dorm_system.sql重新导入不要复制粘贴到图形客户端里分段执行。导入之后用SHOW TABLES;逐一核对表清单确认学生表、房间表、缴费表都建出来了再启动项目。5.4 现象部署没问题访问页面 404或者报 ClassNotFoundException: com.mysql.jdbc.Driver原因驱动 jar 没打进 WEB-INF/lib或者用 IDEA 部署时 Artifacts 里没把 lib 目录带上。很多新手把 jar 拖进了项目目录但 IDEA 在构建时会忽略项目根目录下散落的 jar只有进了 Artifacts 的 Output Layout 才会被复制到部署目录。解决在 IDEA 里打开 Project Structure找到 Artifacts在 Output Layout 里确认 WEB-INF/lib 下有没有 mysql-connector-java 的 jar。没有就右键添加 Library Files。更稳妥的做法是把项目改成 Maven 结构在 pom.xml 里声明依赖让 Maven 统一管 jar。改完记得 Rebuild Project清理 target 目录再重启 Tomcat。5.5 现象改了 Java 代码重启 Tomcat 后页面还是旧效果原因IDEA 的 Artifacts 没有更新或者 Tomcat 的 webapps 目录下残留旧版本的部署包。浏览器缓存也是帮凶尤其是静态页面和 JS 文件会顽固地保留旧版本。很多人改代码后习惯性点一下浏览器刷新以为万无一失结果盯着旧页面干着急。解决在 IDEA 里执行 Build Rebuild Project再确认 Tomcat 运行配置里的 Deployment 是否勾选了“Update resources”。浏览器按 F12 打开开发者工具勾选 Disable cache或者直接用无痕窗口。最彻底的办法是停掉 Tomcat手动删除部署目录下的旧项目文件重新 Run。6. 让这个项目从“能交差”到“能答辩”三个值得做的改进方向如果你还有时间不要满足于把源码跑通。按下面三个方向各加一点东西答辩时的技术含量会明显不一样。第一个方向是把裸 JDBC 换成连接池。上面第二章给出的 Druid 配置可以直接用改完之后把 initialSize、maxActive、maxWait 各代表什么、为什么不能调得太大讲清楚。就这一个改动就能把“会用 DriverManager 连数据库”和“了解数据库连接生命周期”区分开。第二个方向是给系统加一个登录拦截。很多课设源码的登录页只是摆设直接访问列表页也能看到数据。写一个 Filter 拦截所有需要登录的请求未登录就跳回登录页这个逻辑不难但它是 Java Web 面试和课设答辩都被高频追问的一层。网上那些“比较 Java 框架”的讨论非常多但把 Servlet 层面的会话控制亲手写一遍比看二十篇框架对比都管用。第三个方向是给自己造一批测试数据认真走一遍三个流程入住满房、退宿销账、缴费状态变更。重点验证满房时能不能正确拒绝入住、退宿时房间床位会不会释放、未缴费用会不会在退宿时被拦截。这些边界用例比“系统能跑”更有说服力。我的习惯是拿到任何一份新源码先跑通再改代码从不一上来就重构。跑通的过程中把环境、依赖、字符集这三块老坑摸一遍后面再遇到类似项目就不会再翻车。希望帮到你。本文还有配套的精品资源点击获取
