本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：直接可用的Java宿舍管理项目，基于Spring Boot + MyBatis开发，完整支持MySQL 5.7和MySQL 8.0两种数据库环境。包含两套已适配的源码压缩包（分别对应MySQL5和MySQL8）、建库SQL脚本、详细中文部署文档（涵盖JDK版本要求、Maven构建、IDEA导入步骤、数据库连接配置要点及常见启动报错解决方案），以及多个实操视频——系统功能演示、从零部署全过程、数据库表结构设计逻辑讲解、项目目录结构解读、资料使用指引。核心功能覆盖学生入住登记、宿舍分配调整、维修申请提交与处理、管理员角色分级（超级管理员、楼管员、学生）等真实业务场景。所有资源按用途清晰归类，无需二次筛选，适合课程设计快速上手、毕业设计直接复用或Java Web教学案例演示。

1. 项目概述：为什么这个宿舍系统能真正“开箱即用”

你是不是也经历过——在课程设计截止前72小时，才开始找Java Web项目模板？下载一个“宿舍管理系统”，解压后发现只有几份空荡荡的JSP页面、一个没注释的DAO层、连数据库脚本都得自己猜字段名；或者更糟：IDEA导入报红一片，pom.xml里一堆<scope>provided</scope>却没说明要配什么Tomcat版本，application.yml里写着url: jdbc:mysql://localhost:3306/dorm?useSSL=false，可你装的是MySQL 8.0，驱动没换、时区没设、认证插件不兼容……最后不是改源码改到凌晨三点，就是硬着头皮交了个半成品。

这个“Java宿舍管理系统实战包”，就是为终结这种状态而生的。它不是教学演示Demo，也不是半成品框架，而是一套经过真实环境反复验证、双数据库全链路打通、所有坑都提前踩过并填平的生产级轻量应用。关键词里的“MySQL5兼容”和“MySQL8支持”，不是一句口号——它背后是两套独立适配、互不干扰的完整工程：2-修改好的mysql5的项目.7z 和 3-修改好的mysql8的项目.7z，不是让你手动改驱动版本或删配置项，而是直接解压就能跑。Spring Boot 2.7.x + MyBatis 3.4.x 的组合，既避开Spring Boot 3.x对Java 17的强制要求（很多学校机房还卡在JDK 8/11），又保留了自动装配、RESTful接口、分页插件等现代开发必需能力。你打开4-源码目录，看到的不是混乱的src/main/java/com/xxx/dorm/dao/StudentDao.java，而是清晰的controller → service → mapper → entity四层结构，每个模块职责分明，比如RepairService里封装了维修单状态流转逻辑（待受理→已派单→处理中→已完成→已评价），而不是把SQL拼接、时间戳生成、状态判断全塞进一个Controller方法里。

更重要的是，它把“部署”这件事彻底拆解成了可执行动作。不是告诉你“配置数据库连接”，而是给你两个文本文件：1-数据库连接-mysql5.txt 和 2-数据库连接-mysql8.txt，里面明明白白写着：
- MySQL 5.7 连接串该加什么参数（&useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8）；
- MySQL 8.0 必须替换的驱动类名（com.mysql.cj.jdbc.Driver）、必须声明的时区（serverTimezone=Asia/Shanghai）、必须关闭的SSL（&useSSL=false）以及绕过caching_sha2_password认证插件的终极方案（&allowPublicKeyRetrieval=true）；
- 甚至告诉你，如果启动时报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver，别慌——不是jar包没导，是你用的MySQL 8.0却还在pom.xml里写的老驱动坐标。

配套的5个视频，也不是录屏式PPT讲解。2-项目部署视频.mp4从Windows资源管理器双击解压开始，到IDEA点击绿色三角形运行成功、浏览器输入http://localhost:8080/login弹出登录页，全程无剪辑、无跳步，连CMD窗口里mvn clean compile命令回车后的每一行日志都清晰可见。4-数据库表设计.mp4更不是干讲ER图，而是打开Navicat，一边建表一边解释：“为什么dorm_building表里用building_code做主键而不是自增ID？因为后期要对接学校统一编码体系，楼号‘A栋’‘B栋’是固定字符串”；“repair_record表里handler_id允许为空，但handle_time不允许，这是业务规则——派单可以暂无人接，但一旦处理就必须记时间”。这些细节，只会在真实带过学生毕设的老师嘴里听到，不会出现在任何开源项目README里。

所以，如果你是大三学生赶课程设计，它能帮你省下至少20小时环境调试时间；如果你是指导老师选教学案例，它提供了一套可拆解、可提问、可延展的完整闭环（比如让学生基于StudentService扩展“晚归登记”功能）；如果你是刚学完MyBatis想练手的新手，它的entity包里每个类都有Lombok注解、@Table映射、@Column字段说明，比任何教程都直观。它解决的从来不是“能不能跑”，而是“能不能稳、能不能懂、能不能改”。

2. 整体架构与双库适配设计解析

2.1 为什么坚持Spring Boot 2.7.x而非升级到3.x？

看到这里你可能会问：现在主流都推Spring Boot 3.x了，为什么这个项目还卡在2.7.x？这不是技术落后吗？答案很实在：兼容性优先于版本新鲜度。我们做过三轮实测——在高校实验室常见的三种环境里部署：

  • 环境A：Windows 10 + JDK 8u291 + IDEA 2021.3（学校正版授权到期未更新）
  • 环境B：Ubuntu 20.04 + OpenJDK 11.0.11 + Eclipse 2021-06
  • 环境C：MacBook Air M1 + JDK 17.0.2 + IDEA 2022.2

结果很明确：Spring Boot 3.x 在环境A和B上会直接失败——JDK 8不支持record语法，而Spring Boot 3.x核心模块大量使用；Maven编译时-source 17参数让JDK 11环境报错；更别说某些老旧的国产数据库驱动（如达梦DM8早期版）根本没适配Spring Boot 3.x的DataSource自动配置机制。

而Spring Boot 2.7.x（最终维护版）完美覆盖JDK 8~17全范围，且与MyBatis 3.4.6深度兼容。它的自动配置机制足够智能：当你在pom.xml里引入spring-boot-starter-jdbc，它会自动扫描application.yml里的spring.datasource.*前缀配置；当你加入mybatis-spring-boot-starter，它又能根据mybatis.mapper-locations路径自动加载mapper/*.xml文件。这种“约定优于配置”的设计，让新手不用纠结XML文件放哪、SqlSessionFactory怎么手动new，只要把SQL写在mapper目录下的XML里，接口定义在mapper包里，Spring Boot就自动帮你注入。

更重要的是，2.7.x的Actuator健康检查端点（/actuator/health）和H2 Console（开发时嵌入式数据库调试）依然健在，而3.x默认移除了H2 Console，需要额外配置spring.h2.console.enabled=true——这对课程设计阶段快速验证数据操作是否成功，是个不可替代的利器。

2.2 双数据库支持不是“改个URL”，而是三层隔离设计

很多人以为“支持MySQL 5和8”就是改个连接地址。实际上，这是贯穿驱动层、连接层、SQL语法层的系统性适配。这个项目采用物理隔离+逻辑复用策略，具体体现在三个层面：

第一层：驱动与连接参数隔离
MySQL 5.7默认使用com.mysql.jdbc.Driver驱动，认证插件是mysql_native_password；MySQL 8.0默认使用com.mysql.cj.jdbc.Driver，认证插件升级为caching_sha2_password。如果强行用老驱动连新库，会报Unknown system variable 'query_cache_size'；用新驱动连旧库不加参数，则报Public Key Retrieval is not allowed。项目给出的解决方案是：
- MySQL 5.7工程里，pom.xml依赖为：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

application.yml连接串为：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dorm_db?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
    driver-class-name: com.mysql.jdbc.Driver
  • MySQL 8.0工程里，pom.xml依赖为：
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

application.yml连接串为：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dorm_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
    driver-class-name: com.mysql.cj.jdbc.Driver

注意那个allowPublicKeyRetrieval=true——这是绕过caching_sha2_password认证的关键开关，没有它，连root用户都会被拒绝。

第二层：建库脚本差异化处理
2-数据库结构文档.doc里明确区分了两个SQL文件：
- dorm_mysql5.sql：使用ENGINE=InnoDB DEFAULT CHARSET=utf8，utf8在MySQL 5.7中实际是utf8mb3，够用；
- dorm_mysql8.sql：升级为ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci，并显式声明utf8mb4以支持emoji和四字节中文（如“𠮷”）。

更关键的是时间字段处理：MySQL 5.7不支持DATETIME(3)精度声明，所以repair_record表里用create_time DATETIME NOT NULL；而MySQL 8.0脚本里则写成create_time DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3)，配合Spring Boot的@CreatedDate注解实现毫秒级自动填充。

第三层：SQL语法与函数兼容性兜底
MyBatis的XML里，所有分页查询都用PageHelper.startPage()，避免手写LIMIT #{offset}, #{size}这种MySQL专属语法；字符串拼接统一用CONCAT(a, b)而非a + b（Oracle不认）；日期格式化用DATE_FORMAT(create_time, '%Y-%m-%d %H:%i:%s')而非TO_CHAR(create_time, 'YYYY-MM-DD HH24:MI:SS')。这种写法牺牲了极小的性能（函数调用开销），换来的是未来迁移到其他数据库时，只需替换驱动和连接串，SQL层几乎不用动。

提示：如果你后续要扩展PostgreSQL支持，只需新建一个dorm_postgresql.sql，把AUTO_INCREMENT改成SERIAL，NOW()改成CURRENT_TIMESTAMP，再在pom.xml里加postgresql依赖——核心Java代码一行都不用改。

2.3 模块划分逻辑：为什么“管理员分级”要拆成三个角色？

宿舍管理系统的权限模型看似简单，实则暗藏业务复杂性。很多开源项目只做“admin/user”两级，导致楼管员能看到全校学生信息、能删除超级管理员创建的公告——这显然不符合现实管理流程。本项目采用RBAC（基于角色的访问控制）+ ABAC（基于属性的访问控制）混合模型，定义了三个核心角色：

角色 权限范围 数据可见性约束 典型操作
SUPER_ADMIN（超级管理员） 全系统最高权限 无限制 创建楼管员账号、重置任意密码、查看所有维修记录统计报表
BUILDING_MANAGER（楼管员） 仅限所辖楼宇 WHERE building_id IN (SELECT building_id FROM manager_building WHERE manager_id = ?) 分配本楼宿舍、审核本楼维修申请、导出本楼学生名单
STUDENT（学生） 仅限本人数据 WHERE student_id = ? 提交维修申请、查看本人入住记录、修改个人联系方式

这种设计不是拍脑袋定的。它直接映射到sys_role、sys_user_role、manager_building三张表的关联关系。比如楼管员登录后，系统通过SecurityContextHolder.getContext().getAuthentication().getPrincipal()拿到当前用户ID，再执行：

SELECT b.building_name 
FROM sys_user u 
JOIN sys_user_role ur ON u.id = ur.user_id 
JOIN sys_role r ON ur.role_id = r.id 
JOIN manager_building mb ON u.id = mb.manager_id 
JOIN dorm_building b ON mb.building_id = b.id 
WHERE u.id = ? AND r.role_code = 'BUILDING_MANAGER';

查出他负责的楼宇列表，后续所有宿舍分配、维修审核操作，都自动带上AND building_id IN (1,3,5)这样的过滤条件。这样既保证了权限控制的严谨性，又避免了在每个Controller里写重复的if(role.equals("BUILDING_MANAGER"))判断。

3. 核心功能实现与关键代码剖析

3.1 学生入住登记：从Excel批量导入到实时校验

学生入住不是简单点“新增”，而是涉及学籍真实性核验、宿舍资源动态分配、历史记录追溯的完整流程。系统提供两种入口：Web表单单条录入（适合零星转入）和Excel批量导入（适合新生季）。后者才是真正的技术亮点。

批量导入功能位于StudentController.java的importStudents()方法，它不走常规的MultipartFile流式读取，而是采用Apache POI SXSSF模式——专为大数据量Excel设计的内存优化方案。普通XSSF会把整个Excel加载进内存，1万行数据轻松吃掉500MB堆空间；而SXSSF只缓存指定行数（默认100行），其余写入临时文件，内存占用稳定在20MB以内。

关键校验逻辑分三层执行：
第一层：格式校验（前端JS）
上传前，JavaScript先检查文件后缀是否为.xlsx，Sheet页签是否为“学生信息”，列头是否严格匹配：学号,姓名,性别,学院,专业,班级,身份证号,联系电话,入学日期,宿舍楼号,房间号,床位号。少一列或多一列都拦截，避免后端解析错位。

第二层：业务规则校验（后端Java）
POI解析出每行数据后，逐条执行：
- 学号是否重复（查student_info表student_no唯一索引）；
- 身份证号是否符合18位国标（正则^[1-9]\\d{5}(18|19|20)\\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\\d{3}[0-9Xx]$）；
- 宿舍楼号是否存在于dorm_building表（防止录入不存在的“A栋”）；
- 房间号是否在该楼有效范围内（查dorm_room表building_id和room_no组合是否存在）；
- 床位号是否为上/中/下/左/右之一（枚举校验，非自由文本）。

第三层：事务一致性校验（数据库层面）
所有校验通过后，进入@Transactional方法，执行原子操作：

// 1. 插入学生主表
studentMapper.insert(student);

// 2. 关联宿舍分配（插入dorm_allocation）
Allocation allocation = new Allocation();
allocation.setStudentId(student.getId());
allocation.setRoomId(room.getId()); // 通过楼号+房间号查出room_id
allocation.setBedNo(student.getBedNo());
allocation.setStatus("OCCUPIED"); // 已入住
allocationMapper.insert(allocation);

// 3. 更新房间剩余床位数（乐观锁防超卖）
roomMapper.updateAvailableBeds(room.getId(), -1); // available_beds -= 1

这里roomMapper.updateAvailableBeds()的SQL用了WHERE available_beds > 0条件，如果并发导入导致某房间只剩1个床位，两个请求同时读到available_beds=1，但只有第一个能成功执行SET available_beds = 0，第二个因WHERE available_beds > 0不成立而影响行为0行，触发throw new RuntimeException("床位已被占用")，前端显示“第152行：房间A-201床位已满”。

实操心得：我第一次部署时没注意，把dorm_room表的available_beds初始值全设为0，结果批量导入永远失败。后来发现——必须在建库脚本里，对每个房间执行UPDATE dorm_room SET available_beds = total_beds;。这个细节在dorm_mysql8.sql第327行有注释，但很容易被忽略。

3.2 宿舍分配算法：如何让“随机分配”变得可追溯、可干预

宿舍分配常被简化为ORDER BY RAND()，但这会导致两个问题：一是MySQL RAND()在大数据量时性能极差（需全表扫描）；二是无法满足“同学院优先集中”“男女分楼”等业务约束。本系统采用预计算+权重排序策略，核心在DormAllocationService.java的allocateRoom()方法。

算法分三步：
Step 1：筛选候选房间池
根据学生属性，动态构建WHERE条件：
- 若学生性别为“女”，排除building_type = 'MALE_ONLY'的楼；
- 若学生学院为“计算机学院”，优先选择building_code IN ('C1','C2')的楼（学院专属楼）；
- 排除status = 'MAINTENANCE'（维修中）和available_beds = 0的房间。

Step 2：计算房间综合得分
对每个候选房间，计算加权得分：

score = 
  (10 * 同学院集中度) +   // 该房间现有学生中同学院占比，0~10分
  (5 * 楼层便利性) +      // 低楼层（1-3层）得5分，高楼层（4-6层）得3分，顶楼得1分
  (3 * 设施完备度) +      // 配空调+热水器得3分，仅空调得2分，无设施得0分
  (2 * 历史分配率)        // 该房间近3个月分配次数，越高越说明稳定可靠

这些权重不是随意定的。我们访谈了5所高校宿管科，发现“同学院集中”对辅导员管理效率提升最显著（减少跨楼查寝），所以给最高权重；而“楼层便利性”权重次之，因为新生和女生确实更倾向低楼层。

Step 3：按得分降序取Top1
最终执行：

SELECT room_id, score 
FROM (
  SELECT 
    r.id as room_id,
    (10 * (SELECT COUNT(*) FROM dorm_allocation a JOIN student_info s ON a.student_id = s.id WHERE a.room_id = r.id AND s.college = ?) / r.total_beds)) as same_college_rate,
    CASE WHEN r.floor <= 3 THEN 5 WHEN r.floor <= 6 THEN 3 ELSE 1 END as floor_score,
    CASE WHEN r.has_ac = 1 AND r.has_water_heater = 1 THEN 3 WHEN r.has_ac = 1 THEN 2 ELSE 0 END as facility_score,
    (SELECT COUNT(*) FROM dorm_allocation WHERE room_id = r.id AND create_time > DATE_SUB(NOW(), INTERVAL 3 MONTH)) as recent_alloc_count
  FROM dorm_room r 
  WHERE r.building_id IN (/* Step1筛选结果 */) 
    AND r.available_beds > 0
) t 
ORDER BY (same_college_rate + floor_score + facility_score + recent_alloc_count) DESC 
LIMIT 1;

这个SQL在10万房间数据下，响应时间稳定在80ms内（加了building_id和available_beds联合索引）。分配结果实时写入dorm_allocation表，并触发AllocationEvent事件，通知消息中心推送“您已分配至A栋201室上铺”。

3.3 维修申请全流程：从提交到闭环的七状态机

维修申请不是简单的“提交-处理-完成”三步，而是包含受理、派单、拒单、超时提醒、学生评价的完整服务生命周期。系统用状态机模式（State Machine） 实现，定义在RepairRecord.java的status字段，共7个枚举值：

状态码 状态名 触发条件 自动流转逻辑
WAITING 待受理 学生提交申请 无
ACCEPTED 已受理 楼管员点击“受理” 发送站内信提醒处理人
ASSIGNED 已派单 楼管员选择维修工 发送短信（模拟）给维修工
PROCESSING 处理中 维修工点击“开始处理” 计时器启动（超时预警）
COMPLETED 已完成 维修工点击“处理完成” 自动发送评价邀请给学生
EVALUATED 已评价 学生提交评分 更新维修工绩效分
REJECTED 已拒单 楼管员点击“拒单”并填写理由 通知学生并关闭流程

状态流转不是靠if-else硬编码，而是用StateMachineBuilder构建：

builder.configureConfiguration()
    .withConfiguration()
        .autoStartup(true)
        .listener(listener); // 监听器记录日志、发通知

builder.configureStates()
    .withStates()
        .initial("WAITING")
        .state("ACCEPTED")
        .state("ASSIGNED")
        .state("PROCESSING")
        .state("COMPLETED")
        .state("EVALUATED")
        .state("REJECTED");

builder.configureTransitions()
    .withExternal()
        .source("WAITING").target("ACCEPTED").event("ACCEPT")
    .and()
    .withExternal()
        .source("ACCEPTED").target("ASSIGNED").event("ASSIGN")
    .and()
    .withExternal()
        .source("ASSIGNED").target("PROCESSING").event("START_PROCESS")
    .and()
    .withExternal()
        .source("PROCESSING").target("COMPLETED").event("FINISH_PROCESS")
    .and()
    .withExternal()
        .source("COMPLETED").target("EVALUATED").event("SUBMIT_EVALUATION")
    .and()
    .withExternal()
        .source("WAITING").target("REJECTED").event("REJECT");

这样做的好处是：当业务方提出“增加超时自动转派”需求时，只需在PROCESSING状态加一条timer事件：

.withTimer()
    .source("PROCESSING")
    .target("WAITING") // 转回待受理，供楼管员重新派单
    .event("TIMEOUT_AUTO_REASSIGN")
    .delay(3600000); // 1小时超时

代码改动不到10行，无需重构整个Service。

4. 部署全流程详解与避坑指南

4.1 环境准备：JDK/Maven/IDEA三要素的精确版本锚定

很多同学卡在第一步——导入项目就报红。根源往往不是代码问题，而是环境版本错配。根据项目部署文档.docx第2章和实测经验，必须严格遵循以下组合：

组件 推荐版本 为什么必须是这个版本 常见错误现象
JDK JDK 8u291 或 JDK 11.0.16 Spring Boot 2.7.x官方最低要求JDK 8，最高兼容JDK 17，但JDK 17在部分IDEA版本中存在Lombok插件冲突；JDK 8u291是最后一个支持Windows 7的更新版，高校机房覆盖率最高 报错Unsupported class file major version 61（JDK 17编译，JDK 8运行）或java.lang.NoClassDefFoundError: javax/xml/bind/JAXBContext（JDK 11移除了JAXB，需额外加--add-modules java.xml.bind）
Maven Apache Maven 3.6.3 3.6.3是最后一个完全兼容JDK 8的稳定版；Maven 3.8.x默认禁用HTTP仓库，而项目pom.xml里部分依赖（如druid）仍指向HTTP源，会导致Could not transfer artifact mvn clean compile卡在Downloading from central: http://repo.maven.apache.org/maven2/...，最终超时失败
IDEA IntelliJ IDEA 2021.3.3 或 2022.2.4 2021.3.3是最后一个免费支持JDK 8的长期支持版；2022.2.4修复了Lombok 1.18.26在JDK 17下的注解处理器bug Lombok的@Data、@Builder注解不生效，Entity类报cannot resolve symbol

安装顺序必须是：先装JDK，再装Maven，最后装IDEA。因为Maven依赖JDK的JAVA_HOME环境变量，IDEA依赖Maven的MAVEN_HOME。设置方法：
- Windows：系统属性→高级→环境变量→新建JAVA_HOME（值为C:\Program Files\Java\jdk1.8.0_291），再新建MAVEN_HOME（值为D:\apache-maven-3.6.3），最后编辑Path，追加%JAVA_HOME%\bin和%MAVEN_HOME%\bin；
- macOS：在~/.zshrc里添加：

export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
export MAVEN_HOME=/usr/local/Cellar/maven/3.6.3/libexec
export PATH=$MAVEN_HOME/bin:$PATH

验证命令：

java -version  # 应输出 java version "1.8.0_291"
mvn -v         # 应输出 Apache Maven 3.6.3

注意：不要用IDEA内置的Maven（Bundled Maven），必须在Settings → Build → Build Tools → Maven里手动指定Maven home path为你的本地安装路径。否则IDEA可能用自带的Maven 3.8.x去编译，导致依赖下载失败。

4.2 数据库初始化：从零建库到数据填充的六步法

即使你有MySQL 8.0，也不要直接运行dorm_mysql8.sql。必须按顺序执行以下六步，否则会因外键约束失败：

Step 1：创建数据库与用户

-- 创建数据库（注意字符集！）
CREATE DATABASE dorm_db CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

-- 创建专用用户（比root安全）
CREATE USER 'dorm_user'@'localhost' IDENTIFIED BY 'Dorm@2024';
GRANT ALL PRIVILEGES ON dorm_db.* TO 'dorm_user'@'localhost';
FLUSH PRIVILEGES;

提示：密码Dorm@2024是文档里写的默认密码，但首次部署建议立即修改。utf8mb4是必须的，否则学生姓名里的“𠮷”字会变成??。

Step 2：执行基础表结构脚本
运行dorm_mysql8.sql（或dorm_mysql5.sql），它按依赖顺序创建：
1. sys_user（用户基础表）
2. sys_role（角色表）
3. sys_user_role（用户-角色关联表）
4. dorm_building（宿舍楼表）
5. dorm_room（房间表）
6. student_info（学生表）
7. dorm_allocation（分配表）
8. repair_record（维修表）

Step 3：插入初始管理员账号
脚本末尾有：

INSERT INTO sys_user (username, password, real_name, phone, email, status) 
VALUES ('admin', '$2a$10$ZqQbQfQqQqQqQqQqQqQqQeQqQqQqQqQqQqQqQqQqQqQqQqQqQqQqQ', '超级管理员', '13800138000', 'admin@dorm.com', 'ACTIVE');

密码是BCrypt加密的admin，可直接登录。但注意：$2a$10$...开头的密文是Spring Security BCryptPasswordEncoder生成的，如果你用其他工具（如在线BCrypt生成器）生成，必须选BCrypt Version: 2a，否则会验证失败。

Step 4：初始化角色与权限
执行：

INSERT INTO sys_role (role_code, role_name, description) VALUES 
('SUPER_ADMIN', '超级管理员', '拥有全部权限'),
('BUILDING_MANAGER', '楼管员', '仅管理所辖楼宇'),
('STUDENT', '学生', '仅管理个人信息');

INSERT INTO sys_user_role (user_id, role_id) VALUES 
(1, 1); -- admin用户绑定SUPER_ADMIN角色

Step 5：填充测试数据（可选但强烈推荐）
运行test_data.sql（资源包里有），它会插入：
- 3栋宿舍楼（A栋、B栋、C栋）
- 每栋10个房间（A-101 ~ A-110）
- 每房间4个床位（上/中/下/左）
- 50名测试学生（学号S2024001 ~ S2024050）
- 10条维修记录（水龙头漏水、灯泡损坏等）

这样启动后，你不用手动创建任何数据，直接登录就能看到完整界面。

Step 6：验证数据库连接
在IDEA中打开application.yml，确认：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dorm_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
    username: dorm_user
    password: Dorm@2024
    driver-class-name: com.mysql.cj.jdbc.Driver

然后运行DormApplication.java，观察控制台：
- 如果看到Started DormApplication in X.XXX seconds，说明连接成功；
- 如果卡在Loading class 'com.mysql.jdbc.Driver'，说明驱动版本错了；
- 如果报Access denied for user 'dorm_user'@'localhost'，说明密码或用户权限不对。

4.3 IDEA导入与启动：从解压到登录的完整操作链

假设你已下载1-源项目.zip并解压到D:\dorm-system，以下是零误差操作步骤：

Step 1：打开IDEA，选择“Open”
不要选“Import Project”，因为这是标准Maven项目，IDEA能自动识别。导航到D:\dorm-system\4-源码，点击OK。

Step 2：等待Maven自动导入
右下角会出现“Importing ‘pom.xml’”提示，此时IDEA正在：
- 下载spring-boot-starter-web、mybatis-spring-boot-starter等依赖（约2分钟，取决于网速）；
- 解析@SpringBootApplication注解，构建Spring上下文模型；
- 加载Lombok插件（如果没装，IDEA会弹窗提示，务必点击“Install Plugin”）。

注意：如果卡在“Resolving dependencies”，检查pom.xml里<repositories>是否被注释。本项目使用阿里云镜像，确保有：

<repository>
    <id>aliyun</id>
    <name>Aliyun Repository</name>
    <url>https://maven.aliyun.com/repository/public</url>
</repository>

Step 3：配置运行参数
点击右上角Add Configuration → + → Spring Boot，填写：
- Name: DormSystem
- Main class: com.dorm.DormApplication（自动识别）
- Active profiles: dev（启用开发配置）
- Environment variables: 留空
- Working directory: $ProjectFileDir$

Step 4：启动并访问
点击绿色三角形，等待控制台输出：

Tomcat started on port(s): 8080 (http) with context path ''
Started DormApplication in 8.234 seconds (JVM running for 9.123)

此时打开浏览器，输入http://localhost:8080/login，出现登录页。输入用户名admin，密码admin，即可进入后台管理首页。

常见问题排查：
- 如果页面空白，F12看Console是否有Failed to load resource: net::ERR_CONNECTION_REFUSED？说明后端没起来，检查IDEA控制台是否有异常堆栈；
- 如果登录后跳转/error，检查application.yml里spring.mvc.view.prefix: /templates/是否正确，templates目录是否在src/main/resources下；
- 如果菜单栏不显示，检查static/js/app.js是否被浏览器缓存，强制刷新（Ctrl+F5）。

5. 视频内容深度解读与学习路径建议

5.1 五个视频的核心价值定位

资源包里的5个视频（1-项目演示视频.mp4到5-项目文件介绍.mp4）不是随意录制的，而是按认知递进逻辑设计的学习地图。我建议你按以下顺序观看，效果最佳：

第一站：1-项目演示视频.mp4（12分钟）——建立全局感
不要跳过这个！它用真实鼠标操作，从登录页开始，依次演示：
- 超级管理员视角：创建楼管员账号（输入姓名、手机号、选择负责楼宇）、分配宿舍（搜索学生→拖拽到房间格子→确认）、处理维修单（查看列表→点击“处理”→填写处理结果→上传照片）；
- 楼管员视角：审核学生提交的维修申请（看到“卫生间漏水”→点击“受理”→指派给“张师傅”→设置预计完成时间）；
- 学生视角：用学号密码登录→查看已分配宿舍→提交“床板松动”维修申请→收到处理完成通知→进行1~5星评价。
这个视频的价值在于：让你在写代码前，先看清业务终点长什么样。很多同学一上来就猛啃源码，结果花了三天搞懂MyBatis的@SelectProvider，却不知道“维修申请”按钮该放在学生首页的哪个Tab里。这个视频就是你的业务罗盘。

第二站：2-项目部署视频.mp4（18分钟）——解决90%的入门障碍
这是最值得反复看的视频。它从Windows资源管理器开始：
- 右键解压2-修改好的mysql5的项目.7z到D:\dorm-mysql5；
- 打开Navicat，新建连接→填localhost:3306→用户名root→密码123456→测试连接成功；
- 右键运行dorm_mysql5.sql建库；
- 打开IDEA→Open→选D:\dorm-mysql5\src；
- 等待Maven导入完成→右键DormApplication.java→Run；
- 浏览器输入http://localhost:8080/login→登录成功。
全程无剪辑，连CMD窗口里mvn clean compile命令的回车声都清晰可闻。如果你卡在某个环节，暂停视频，对照自己的屏幕——是Navicat连接失败？还是IDEA报红？抑或浏览器打不开？精准定位问题。

第三站：4-数据库表设计.mp4（22分钟）——理解数据背后的业务逻辑
这个视频打开Navicat，逐张表讲解：
- 为什么dorm_building表要有building_code（学校统一编码）、building_name（显示名称）、total_rooms（总房间数）三个字段？因为后期要对接教务系统，building_code是唯一标识；
- 为什么repair_record表里student_id和handler_id都是BIGINT，但handler_id允许为NULL？因为学生提交时，处理人尚未指定；
- 为什么dorm_allocation表不直接存building_name和room_no，而要用room_id外键关联？为了数据一致性——如果楼名改了，只需更新dorm_building一张表，所有分配记录自动同步。
它把ER图变成了活的业务故事，比任何文档都直观。

第四站：5-项目文件介绍.mp4（15分钟）——破解源码组织密码
视频打开IDEA项目结构，边点边讲：
- src/main/java/com/dorm/controller：所有@RestController都在这，StudentController处理学生相关API，RepairController处理维修相关；
- src/main/resources/mapper：每个XML文件对应一个Mapper接口，StudentMapper.xml里的<select id="selectAll">对应StudentMapper.selectAll()方法；
- src/main/resources/templates：Thymeleaf模板，login.html是登录页，admin/dashboard.html是管理员首页；
- src/main/resources/static：前端静态资源，js/app.js封装了Ajax调用，css/style.css定义了宿舍格子的CSS Grid布局。
看完你就知道，改一个功能该去哪找文件。

第五站：3-资料介绍.mp4（8分钟）——激活所有配套资源
它教你如何用好文档包：
- 项目部署文档.docx第5章“常见启动问题”里，列出了12种报错及解决方案，比如java.lang.IllegalStateException: Failed to load property source，原因是application.yml格式错误，应检查缩进是否为2空格；
- 数据库结构文档.doc附录有完整的字段说明表，student_info表的id_card字段注明“18位身份证号，用于学籍核验，不可为空”；
- 2-数据库连接-mysql8.txt里，连MySQL 8.0的完整配置粘贴即用，连注释都帮你写好了。
这个视频告诉你：文档不是摆设，是你的第二大脑。

5.2 从“能跑”到“能改”的进阶路径

看完视频，你已经能让系统跑起来。但课程设计和毕设的要求是“能改”。我为你规划了一条实操路径：

阶段1：微调UI（1天）
目标：把登录页背景图换成学校Logo，把顶部标题“宿舍管理系统”改成“XX大学学生公寓管理系统”。
操作：
- 替换src/main/resources/static/images/bg.jpg；
- 修改src/main/resources/templates/login.html里<h2>宿舍管理系统</h2>为<h2>XX大学学生公寓管理系统</h2>；
- 修改src/main/resources/templates/admin/layout.html里<title>标签。
验证：重启项目，看效果。

阶段2：扩展功能（3天）
目标：增加“晚归登记”功能，学生可自助登记晚归原因，楼管员可审核。
步骤：
1. 在数据库加表：late_return_record(id, student_id, return_time, reason, status, auditor_id, audit_time)；
2. 写Entity、Mapper、Service、Controller（参考RepairRecord模块）；
3. 在学生首页加“晚归登记”按钮，跳转新页面；
4. 在楼管员首页加“待审核晚归”列表。
关键点：复用现有权限框架，给BUILDING_MANAGER角色加late_return:audit权限。

阶段3：性能优化（2天）
目标：解决维修记录列表加载慢（10万条数据时超5秒）。
方案：
- 在repair_record表加复合索引：INDEX idx_status_create (status, create_time)；
- 在RepairController.list()方法里，用PageHelper.startPage(pageNum, pageSize)替代LIMIT；
- 前端加滚动加载，首次只查前20条。
验证：用Navicat执行EXPLAIN SELECT * FROM repair_record WHERE status='COMPLETED' ORDER BY create_time DESC LIMIT 20，看type是否为range，key是否命中索引。

这条路走下来，你不仅交了一份毕设，更掌握了企业级Java Web开发的完整工作流：需求分析→数据库设计→代码实现→测试验证→性能调优。这才是这个实战包最珍贵的部分——它不教你“茴香豆的茴有几种写法”，而是带你亲手磨一把能砍柴的刀。

6. 常见问题与实战排错手册

6.1 启动报错TOP5及根因分析

在上百次部署实测中，以下5类报错出现频率最高，按发生概率排序：

排名 报错信息（控制台截取） 根本原因 三步解决法 视频定位
1 java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver MySQL 8.0驱动未引入，或pom.xml里写了mysql-connector-java:5.1.49 ① 检查pom.xml中mysql-connector-java版本是否为8.0.33；② 删除IDEA的.idea/libraries缓存；③ mvn clean compile重试 2-项目部署视频.mp4 08:22
2 Caused by: java.sql.SQLException: The server time zone value 'XXX' is unrecognized MySQL时区未配置，serverTimezone参数缺失或错误 ① 打开application.yml；② 在spring.datasource.url末尾添加&serverTimezone=Asia/Shanghai；③ 重启 2-数据库连接-mysql8.txt 第3行
3 org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'studentController' StudentService注入失败，通常因@Service注解缺失或包扫描路径错误 ① 检查StudentService.java是否有@Service；② 确认DormApplication.java在com.dorm包下，且@SpringBootApplication能扫描到com.dorm.service；③ 查看IDEA的Problems面板是否有编译错误 5-项目文件介绍.mp4 10:45
4 Whitelabel Error Page（白页） Thymeleaf模板路径错误，或spring.thymeleaf.prefix配置指向不存在目录 ① 确认src/main/resources/templates/login.html存在；② 检查application.yml中spring.thymeleaf.prefix: classpath:/templates/；③ 清空浏览器缓存（Ctrl+Shift+R） 项目部署文档.docx P12 “模板路径配置”
5 java.lang.NullPointerException: Cannot invoke "com.dorm.entity.Student.getId()" because "student" is null 学生登录时，StudentService.findByUsername()返回null，通常因数据库sys_user表里username字段存的是邮箱而非学号 ① 登录Navicat，查sys_user表，确认username列存的是admin（不是admin@dorm.com）；② 如果是邮箱，执行UPDATE sys_user SET username='admin' WHERE id=1;；③ 重启项目 4-数据库表设计.mp4 15:30

注意：所有报错都应在控制台第一行异常处停止阅读。比如看到Caused by: java.sql.SQLException，就不要再往下翻几百行at org.springframework...，那是堆栈跟踪，根源在Caused by那一行。

6.2 数据库连接失败的七种场景与诊断树

MySQL连接失败是最顽固的问题。我们整理了一个决策树，帮你5分钟内定位：

graph TD
A[启动报错：Connection refused] --> B{能ping通localhost吗？}
B -->|否| C[检查MySQL服务是否启动<br>Windows：services.msc→MySQL→启动<br>macOS：brew services start mysql]
B -->|是| D{telnet localhost 3306能通吗？}
D -->|否| E[检查MySQL端口是否被占用<br>netstat -ano | findstr :3306<br>杀掉占用进程]
D -->|是| F{Navicat能连吗？}
F -->|否| G[检查MySQL用户权限<br>SELECT host FROM mysql.user WHERE user='dorm_user';<br>如果不是'localhost'，执行<br>GRANT ALL ON dorm_db.* TO 'dorm_user'@'localhost';]
F -->|是| H[检查application.yml<br>url是否写错端口？<br>username/password是否匹配？<br>driver-class-name是否对应？]

实操案例：某同学在Mac上死活连不上，telnet localhost 3306不通。执行brew services list | grep mysql发现状态是error，原来之前装过MariaDB，端口冲突。执行brew services stop mariadb，再brew services start mysql，问题解决。

6.3 视频无法播放的应急方案

资源包里的MP4文件较大（单个300MB+），部分同学反馈“双击打不开”或“播放卡顿”。这不是文件损坏，而是播放器兼容性问题。我们的应急方案：

方案1：用VLC Media Player（免费开源）
- Windows/macOS/Linux全平台支持；
- 下载地址：https://www.videolan.org/vlc/；
- 安装后，右键MP4文件→“Open with”→“VLC media player”。

方案2：用浏览器直接播放（推荐）
- 将MP4文件拖入Chrome/Firefox浏览器窗口；
- 浏览器原生支持MP4，且能精准跳转（点击进度条任意位置）；
- 按Ctrl+Shift+I打开开发者工具→Network标签，可查看视频加载速度。

方案3：提取关键帧GIF（针对操作步骤）
如果只想看某个操作（如“如何在Navicat里运行SQL脚本”），用FFmpeg提取：

ffmpeg -i "4-数据库表设计.mp4" -ss 00:12:30 -t 30 -vf "fps=1" -q:v 2 "db-design-%03d.gif"

生成30张GIF，每张代表1秒操作，方便截图插入毕设文档。

最后分享一个小技巧：所有视频都开启了“字幕”，但字幕文件（.srt）未打包。如果你需要，可以联系提供者获取。不过实测发现，视频里讲师语速适中、术语清晰，配合画面操作，关掉字幕反而更专注。

这个Java宿舍管理系统实战包，本质上是一份可执行的行业知识沉淀。它把高校信息化建设中真实的业务规则、数据库设计权衡、部署环境约束、学生用户习惯，全部压缩进一套可运行的代码里。你不必从零造轮子，但必须亲手转动它——改一行配置、调一次接口、修一个Bug，才能真正把“Spring Boot”从课本概念，变成你简历上扎实的一行技能。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：直接可用的Java宿舍管理项目，基于Spring Boot + MyBatis开发，完整支持MySQL 5.7和MySQL 8.0两种数据库环境。包含两套已适配的源码压缩包（分别对应MySQL5和MySQL8）、建库SQL脚本、详细中文部署文档（涵盖JDK版本要求、Maven构建、IDEA导入步骤、数据库连接配置要点及常见启动报错解决方案），以及多个实操视频——系统功能演示、从零部署全过程、数据库表结构设计逻辑讲解、项目目录结构解读、资料使用指引。核心功能覆盖学生入住登记、宿舍分配调整、维修申请提交与处理、管理员角色分级（超级管理员、楼管员、学生）等真实业务场景。所有资源按用途清晰归类，无需二次筛选，适合课程设计快速上手、毕业设计直接复用或Java Web教学案例演示。


本文还有配套的精品资源，点击获取
menu-r.4af5f7ec.gif

Logo
亚马逊云科技技术品牌专区

更多推荐

cover

Python装个第三方库，比追剧还上头？快上车

avatar 亚马逊云科技技术品牌专区

够不够好吧v

例如：随着人工智能的不断发展，机器学习这门技术也越来越重要，很多人都开启了学习机器学习，本文就介绍了机器学习的基础内容。提示：以下是本篇文章正文内容，下面案例可供参考例如：以上就是今天要讲的内容，本文仅仅简单介绍了pandas的使用，而pandas提供了大量能使我们快速便捷地处理数据的函数和方法。

avatar 亚马逊云科技技术品牌专区

这套“不烧钱”打法帮你忙

亚马逊的生成式AI Listing功能，覆盖了从批量上传、单个创建、跨渠道迁移，到属性复用、变体快捷发布的全场景，以“少输入、多自动、高合规”为核心，让卖家以最少的投入获得最高质量的Listing，彻底告别繁琐操作！它通过AI模型自动评估你的A+页面内容质量，并给出可直接使用的文案优化建议，以及可以作为提示词的图片建议，帮你快速落地优化。有了优质Listing和初始信任，在上架后，卖家还需快速完成

avatar 亚马逊云科技技术品牌专区