简介这是一套面向高校计算机专业学生与Java初学者、可用于毕业设计或课程实训的学生宿舍管理系统完整项目源码。系统前端基于Bootstrap搭建管理界面后端采用SpringBoot框架与MySQL数据库按角色划分为管理员、宿管、学生三类入口覆盖学生、楼宇、宿舍、入住、宿管及管理员信息管理并支持各模块数据的增删改查与Excel导入导出功能链路较为完整。资源包共661个文件以js、css、less、scss等前端资源为主另有35个java源文件、40个class编译文件、8个html页面、2个sql脚本及yml配置、xml映射等压缩包约72.37MB并附MySQL5与MySQL8两套可运行项目版本便于按环境选择。目前已有469人学习下载适合需要参考分层结构、权限划分与导入导出实现思路的读者对照研读与二次开发。1. 宿舍管理这件事为什么值得单独写一套 Java 系统每年毕业季后台总有人问想找一个能跑起来、能改、能写进简历的 Java 管理系统项目最好别太玩具。我第一反应就是学生宿舍管理系统——它看着朴素实际把「用户角色、数据增删改查、分页查询、权限隔离、统计报表」这些企业开发里最常打交道的活儿全串了一遍。你拿它练手不会像做个计算器那样学不到东西你拿它交毕业设计功能闭环也够完整。这套基于 Java 的学生宿舍管理系统核心就是围绕宿舍楼、房间、床位、学生入住、报修和退宿这条主线把一套典型的管理端后台跑通。适合两类人一是刚学完 Java Web、想找个完整项目把 SSM 或 Spring Boot 那套流程走一遍的新手二是手里有源码、想二次开发加功能的老手。下面我按「它是什么、怎么跑、怎么改」的顺序把这份源码拆开讲。2. 技术栈与目录结构先看清这套系统由哪些模块拼起来2.1 技术选型为什么是 Java Spring Boot MyBatis 这套组合这类管理系统在 Java 生态里最稳的落地方式就是 Spring Boot 做 Web 层和依赖注入MyBatis 或 MyBatis-Plus 做持久层MySQL 存数据前端用 Thymeleaf 服务端渲染或者一套现成的后台模板Layui、Bootstrap 都常见。选 Spring Boot 而不是老式 SSM 的原因很实际内嵌 Tomcat一个main方法就能起服务不用配一堆web.xml依赖用 starter 聚合pom.xml干净配置文件集中在application.yml改数据库连接就改几行。MyBatis 的好处是 SQL 可控宿舍管理里「按楼栋、楼层、入住状态组合筛选」这种查询手写 SQL 比 ORM 自动生成更直观也方便你二次开发时加索引优化。常见做法是把项目分成四层controller接请求、service写业务、mapper管数据库、entity对应表结构。这套分层不是摆设后面你加「换宿申请」功能时就知道该往哪层塞代码不会把逻辑全堆在 Controller 里。2.2 目录结构一份能对照着找文件的清单拿到源码先别急着跑把目录扫一遍心里有个地图。典型结构如下不同版本目录名可能略有差异按实际为准dormitory-management/ ├── pom.xml # Maven 依赖与构建配置 ├── src/main/java/com/example/dorm/ │ ├── DormApplication.java # 启动类main 方法入口 │ ├── controller/ # 接口层StudentController、RoomController 等 │ ├── service/ # 业务层接口 │ │ └── impl/ # 业务实现 │ ├── mapper/ # MyBatis Mapper 接口 │ ├── entity/ # 实体类与数据库表一一对应 │ ├── config/ # 拦截器、跨域、MyBatis 配置 │ └── common/ # 统一返回结果、常量、工具类 ├── src/main/resources/ │ ├── application.yml # 数据库、端口、日志配置 │ ├── mapper/ # XML 映射文件写 SQL │ └── static/ templates/ # 前端静态资源与页面 └── sql/ └── dorm.sql # 建库建表 初始数据脚本这张清单的价值在于你排查问题时能快速定位。接口 404 去controller看映射路径SQL 报错去resources/mapper看 XML页面白屏去templates看模板名对不对。我见过不少人跑不起来最后发现是sql目录里的脚本没执行表都没建服务当然连不上。2.3 数据模型宿舍管理的核心表关系这套系统的数据模型不复杂但关系要想清楚。核心表大致是student学生、dorm_building宿舍楼、dorm_room房间、bed床位、check_in_record入住记录、repair_order报修单。一个楼有多间房一间房有多张床一个学生占一张床入住和退宿都记在记录表里。这种设计的好处是「床位」独立成表能精确表达「这间房 4 张床住了 3 个还剩 1 个空位」而不是在房间表里塞个current_count字段——后者一旦并发入住就容易对不上。-- 房间表记录房间容量与所属楼栋 CREATE TABLE dorm_room ( id BIGINT PRIMARY KEY AUTO_INCREMENT, building_id BIGINT NOT NULL COMMENT 所属楼栋, room_no VARCHAR(20) NOT NULL COMMENT 房间号如 301, capacity INT NOT NULL DEFAULT 4 COMMENT 床位容量, status TINYINT DEFAULT 1 COMMENT 1可用 0停用 ); -- 床位表每张床一条记录入住状态挂在床上 CREATE TABLE bed ( id BIGINT PRIMARY KEY AUTO_INCREMENT, room_id BIGINT NOT NULL, bed_no VARCHAR(10) NOT NULL COMMENT 床位编号 A/B/C/D, student_id BIGINT DEFAULT NULL COMMENT 当前入住学生NULL 表示空床 );上面这段建表语句的关键点在bed.student_id空床就是NULL入住就是写入学生 ID退宿再置回NULL。这样「查空床」只需WHERE student_id IS NULL比维护计数字段可靠得多。二次开发时如果你想加「床位预约」在这张表上加个reserved_by字段就能扩展不用动主流程。3. 把项目跑起来从建库到登录的完整步骤3.1 环境准备与依赖检查跑之前先把环境对齐这是最容易翻车的一步。需要 JDK 8 或 11看pom.xml里的java.version、Maven 3.6、MySQL 5.7 或 8.0。先确认版本java -version # 确认 JDK 版本与 pom 一致 mvn -v # 确认 Maven 可用 mysql --version # 确认 MySQL 已安装版本不一致的坑很常见pom.xml写 Java 8你本地是 JDK 17编译可能过但运行时报Unsupported class file major version。我一般会先打开pom.xml看java.version和 Spring Boot 父版本再决定用哪个 JDK。MySQL 8 还要注意驱动类名是com.mysql.cj.jdbc.Driver连接串要带时区参数否则启动时报时区错误。3.2 导入数据库脚本找到sql/dorm.sql用命令行或客户端执行。命令行方式# 登录 MySQL 后执行或直接用 source 导入 mysql -u root -p -e CREATE DATABASE dorm_db DEFAULT CHARSET utf8mb4; mysql -u root -p dorm_db sql/dorm.sql执行完用SHOW TABLES;确认表都建出来了再SELECT * FROM student LIMIT 5;看看初始数据在不在。初始数据里通常有一个管理员账号密码可能是明文或 MD5登录时用得上。如果脚本里没有初始账号去student或admin表手动插一条密码字段按代码里的加密方式填——这一步别偷懒否则登录页一直提示密码错误你会以为是代码问题。3.3 改配置、启动、验证打开src/main/resources/application.yml把数据库连接改成你本地的spring: datasource: url: jdbc:mysql://localhost:3306/dorm_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080serverTimezone这个参数别省MySQL 8 下不写经常报The server time zone value is unrecognized。改完在项目根目录执行mvn spring-boot:run或者mvn clean package后java -jar target/xxx.jar。看到控制台打出Started DormApplication就说明起来了浏览器访问http://localhost:8080用初始账号登录。登录后先点一遍「宿舍楼管理」「学生管理」「报修管理」确认列表能查出数据、新增能提交这条主链路通了项目就算跑活了。提示如果页面能打开但列表空白先按 F12 看接口返回再回头看 SQL 日志。MyBatis 可以在application.yml里开logging.level.你的mapper包debug把执行的 SQL 打出来比盲猜快得多。4. 核心模块拆解一个入住请求从进入到落库的链路4.1 Controller 层参数接收与统一返回以「学生入住」为例前端提交学生 ID 和床位 IDController 负责接参、校验、调 Service。代码大致长这样RestController RequestMapping(/api/checkin) public class CheckInController { Autowired private CheckInService checkInService; // 入住接口studentId 学生bedId 床位 PostMapping(/add) public Result add(RequestBody CheckInDTO dto) { // 基础校验两个 ID 都不能为空 if (dto.getStudentId() null || dto.getBedId() null) { return Result.fail(学生和床位不能为空); } return checkInService.checkIn(dto.getStudentId(), dto.getBedId()); } }这里RequestBody表示接收 JSONResult是项目里统一的返回包装含code、msg、data。参数说明studentId是学生主键bedId是床位主键。Controller 只做「接参 浅校验」真正的业务判断放 Service这样你以后加「换宿」接口时能复用同一套校验逻辑不会出现两处规则不一致。4.2 Service 层业务规则才是这套系统的价值所在入住不是简单插一条记录得判断床位是否已被占、学生是否已在住、房间是否停用。这些规则集中在 ServiceService public class CheckInServiceImpl implements CheckInService { Autowired private BedMapper bedMapper; Autowired private CheckInRecordMapper recordMapper; Override Transactional(rollbackFor Exception.class) public Result checkIn(Long studentId, Long bedId) { Bed bed bedMapper.selectById(bedId); if (bed null) { return Result.fail(床位不存在); } // 核心判断床位已被占用则拒绝 if (bed.getStudentId() ! null) { return Result.fail(该床位已被占用); } // 更新床位归属 bed.setStudentId(studentId); bedMapper.updateById(bed); // 写入入住记录便于后续统计和退宿追溯 CheckInRecord record new CheckInRecord(); record.setStudentId(studentId); record.setBedId(bedId); record.setCheckInTime(new Date()); recordMapper.insert(record); return Result.ok(入住成功); } }Transactional是关键更新床位和写记录必须同成功或同失败否则会出现「床位占了但没记录」的脏数据。rollbackFor Exception.class保证受检异常也回滚。这段逻辑里最值得学的是「先查后改」的顺序——先确认床位空闲再更新配合数据库唯一约束或乐观锁能防并发重复入住。二次开发时如果要加「批量入住」把这段抽成单条方法循环调用事务边界放在外层即可。4.3 Mapper 与 SQL分页查询怎么写才不拖性能列表页是管理系统用得最多的功能。学生列表要支持按姓名、楼栋、入住状态筛选还要分页。MyBatis 里常见写法是 XML 配where动态条件select idselectStudentPage resultTypeStudentVO SELECT s.id, s.name, s.student_no, r.room_no, b.bed_no FROM student s LEFT JOIN bed b ON b.student_id s.id LEFT JOIN dorm_room r ON r.id b.room_id where if testname ! null and name ! AND s.name LIKE CONCAT(%, #{name}, %) /if if testbuildingId ! null AND r.building_id #{buildingId} /if /where ORDER BY s.id DESC LIMIT #{offset}, #{pageSize} /selectwhere会自动处理第一个AND避免拼接出语法错误。LIMIT #{offset}, #{pageSize}里offset (pageNum - 1) * pageSize这个换算在 Service 里算好再传。参数说明name模糊匹配、buildingId精确筛选、offset和pageSize控制分页。性能上要注意LIKE %xx%走不了索引数据量大时考虑全文索引或前置匹配另外关联三张表查询确保bed.student_id和dorm_room.building_id上有索引否则几千条数据就开始卡。5. 避坑与排查跑不起来时先看这几条5.1 启动报数据库连接失败现象控制台抛Communications link failure或Access denied for user。原因通常是三选一MySQL 没启动、application.yml里的账号密码不对、数据库名和脚本建的不一致。解决顺序是先mysql -u root -p手动登一次确认服务活着再核对 yml 里的url库名和username/password最后确认dorm.sql确实导进了同一个库。别一上来就怀疑代码九成是配置问题。5.2 页面 404 或静态资源加载不出来现象登录页能开但点菜单跳转 404或者样式全丢。原因多半是前端页面路径和 Controller 映射对不上或者templates下模板名拼错。解决看浏览器地址栏的实际路径对照RequestMapping逐段比静态资源 404 则检查static目录结构和页面里引用的路径前缀是否一致。这类问题用 F12 的 Network 面板看请求 URL 最快比读代码猜准。5.3 中文乱码现象新增学生后列表里姓名显示问号。原因通常是数据库字符集不是utf8mb4或连接串没带characterEncodingutf8。解决建库时显式DEFAULT CHARSET utf8mb4连接串补上编码参数已有表可以用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4修。这个坑血泪经验是建库那一步偷懒后面每条数据都得返工。5.4 登录一直失败但账号密码没错现象输入正确账号密码仍提示错误。原因常见于密码存储方式不匹配——脚本里存的是 MD5代码里却用明文比对或者反过来。解决打开登录的 Service看它怎么处理密码是equals还是DigestUtils.md5DigestAsHex再对照数据库里那条记录的实际值。对不上就按代码逻辑重新生成一条别硬试。5.5 修改后不生效现象改了 Java 代码或页面重启后还是旧效果。原因可能是target目录里的旧 class 没清、浏览器缓存了旧页面或者改错了同名文件。解决mvn clean再启动浏览器强制刷新CtrlF5并确认你改的文件在src下而不是target下。我一般改完先看控制台有没有重新编译的日志没有就说明根本没加载到。6. 二次开发怎么下手从加一个「换宿申请」功能说起拿到这套源码最值的改造方向是补业务闭环。宿舍管理里「换宿」是高频需求原系统可能只有入住和退宿加一个换宿申请正好练手。思路是新建change_apply表存申请学生、原床位、目标床位、状态、申请时间Controller 加提交和审批两个接口Service 里审批通过时在一个事务里做「释放原床位 占用新床位 写换宿记录」。核心代码骨架Transactional(rollbackFor Exception.class) public Result approve(Long applyId, boolean pass) { ChangeApply apply applyMapper.selectById(applyId); if (apply null || apply.getStatus() ! 0) { return Result.fail(申请不存在或已处理); } if (!pass) { apply.setStatus(2); // 2 表示驳回 applyMapper.updateById(apply); return Result.ok(已驳回); } // 通过校验目标床位仍空闲再交换归属 Bed target bedMapper.selectById(apply.getTargetBedId()); if (target.getStudentId() ! null) { return Result.fail(目标床位已被占用); } bedMapper.releaseByStudentId(apply.getStudentId()); // 释放原床 target.setStudentId(apply.getStudentId()); bedMapper.updateById(target); apply.setStatus(1); // 1 表示通过 applyMapper.updateById(apply); return Result.ok(换宿成功); }这段的关键是事务边界和状态机申请状态用 0/1/2 表示待审/通过/驳回审批前先判状态防重复处理通过时先校验目标床位再动数据。验证方法很直接造两条申请一条目标床空闲、一条目标床已占分别走审批看数据库里床位归属和申请状态是否一致再故意在中间抛异常确认事务回滚后原床位没被误释放。改造时还有两个习惯值得养成一是新功能先写 SQL 建表和初始数据再写 Mapper最后写 Service 和 Controller自底向上不容易乱二是每加一个接口就用 Postman 或页面点一遍别攒一堆再测出问题时定位成本翻倍。我早年图快一口气改五六个文件再启动结果报错连是哪次改动引入的都说不清从那以后每次改完一个模块就强制跑一遍主流程确认没回归再往下走。这份源码的价值不在代码多复杂而在于它给了你一个能安全折腾的完整底座照着上面的路子加功能、改查询、补校验跑通一次你对 Java 管理系统的理解就落地了。希望帮到你。本文还有配套的精品资源点击获取