SSM学生宿舍管理系统毕设实战：从环境搭建到数据一致性保障

简介：这是一套面向计算机专业本科生毕业设计与Java初学者实战训练的SSM框架宿舍管理项目，聚焦校园公寓数字化管理场景，覆盖学生报修、签到、奖惩、访客登记及宿舍评分等核心业务流程。资源包共3个文件（1个SQL数据库脚本用于初始化MySQL数据，1个ZIP含完整SSM源码与项目说明，1个TXT提供部署指引），总大小26.15MB，结构精炼、开箱即用。已有5186人学习下载，验证了其在毕设选题与课程实训中的高复用性。读者可直接导入Eclipse+Tomcat环境运行，获得包含前后台双角色权限体系、模块化功能代码、规范数据库设计及调试通过的可执行工程，特别适合理解Spring+SpringMVC+MyBatis整合开发流程与校园管理系统业务建模逻辑。

1. 为什么用 SSM 搭建学生宿舍管理系统，仍是计算机毕设里稳扎稳打的首选方案？

很多同学拿到“学生宿舍管理系统”这个毕设题目时，第一反应是：这不就是个增删改查？用 Spring Boot 不是更快？但现实是——在高校教学环境、答辩评审标准和导师技术栈适配度三重约束下，SSM（Spring + Spring MVC + MyBatis）依然是近五年高校计算机类毕设中落地率最高、通过率最稳的技术组合。它不追求前沿炫技，而是把“可讲清楚、可现场演示、可快速调试、可独立部署”四件事做到闭环。系统要管理楼栋、房间、学生入住、调宿、报修、卫生检查、晚归登记等核心业务，这些模块天然契合 SSM 的分层解耦结构：Controller 层承接 Web 请求（如/room/list?buildingId=3），Service 层封装业务逻辑（如“同一房间不能重复分配”校验），Mapper 层精准映射数据库字段（如room_status TINYINT COMMENT '0-空闲,1-入住,2-维修中'）。更重要的是，SSM 项目源码结构清晰、依赖明确、调试路径直观，答辩时能一句讲清“请求从 DispatcherServlet 进入，经 HandlerMapping 找到 RoomController，调用 RoomService，最终由 RoomMapper 生成SELECT * FROM t_room WHERE building_id = ?”，这种可控性，远比跑通一个黑盒 Spring Boot Starter 更让导师放心。如果你正面临毕设开题、中期检查或代码整合卡点，这篇就按真实开发节奏，带你从零跑通一个可编译、可登录、可查房、可导出数据的完整 SSM 宿舍系统。

2. 搭建 SSM 环境与初始化项目结构：用 Maven 构建可运行骨架

2.1 选型依据：为什么坚持用传统 SSM 而非 Spring Boot？

虽然 Spring Boot 自动配置大幅简化了启动流程，但在毕设场景中，SSM 的显式配置反而成为优势。例如，MyBatis 的<resultMap>映射规则、Spring MVC 的@InitBinder数据绑定、Spring 的事务传播行为（@Transactional(propagation = Propagation.REQUIRED)）等关键机制，在 SSM 中必须手动声明，这恰好构成答辩时“你是否真正理解框架协作原理”的硬核考点。而 Spring Boot 的@EnableTransactionManagement默认开启、@MapperScan自动扫描等特性，容易让答辩陷入“我加了注解，但没深究底层怎么生效”的被动局面。此外，高校实验室服务器普遍为 CentOS 6/7 + JDK 8 环境，SSM 对 Java 版本兼容性更宽松（JDK 7+ 即可），避免因spring-boot-starter-parent版本冲突导致 Maven 编译失败——这是毕设季高频报错点。

2.2 创建 Maven 工程并配置核心依赖

使用 IntelliJ IDEA 新建 Maven 项目，GroupId设为com.example.dormitory，ArtifactId设为ssm-dormitory。在pom.xml中声明以下关键依赖（版本号严格对应主流教学环境）：

<properties> <spring.version>5.3.31</spring.version> <mybatis.version>3.4.6</mybatis.version> <mybatis-spring.version>1.3.2</mybatis-spring.version> <mysql-connector-java.version>5.1.47</mysql-connector-java.version> <junit.version>4.13.2</junit.version> </properties> <dependencies> <!-- Spring 核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <!-- MyBatis 集成 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>${mybatis.version}</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>${mybatis-spring.version}</version> </dependency> <!-- 数据库驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql-connector-java.version}</version> </dependency> <!-- Servlet API --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> </dependencies>

注意：mysql-connector-java必须用 5.x 版本（非 8.x），否则在 Tomcat 7/8 下易出现java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver错误。若使用 MySQL 8.0+，需将驱动类名改为com.mysql.cj.jdbc.Driver并添加serverTimezone=UTC参数，但毕设推荐统一用 MySQL 5.7 +com.mysql.jdbc.Driver降低环境复杂度。

2.3 配置三层结构的 XML 文件与包路径

项目结构按标准 SSM 分层创建：

src/main/java/ ├── com.example.dormitory.controller/ // Controller 层 ├── com.example.dormitory.service/ // Service 接口与实现 ├── com.example.dormitory.dao/ // Mapper 接口 ├── com.example.dormitory.entity/ // POJO 实体类 └── com.example.dormitory.config/ // Spring 配置类（可选）

src/main/resources/下创建三个核心配置文件：

• applicationContext.xml（Spring 核心容器）：声明数据源、事务管理器、Service Bean 扫描
• spring-mvc.xml（Spring MVC）：配置视图解析器、静态资源处理、Controller 扫描
• mybatis-config.xml（MyBatis）：设置别名、类型处理器、Mapper XML 路径

其中applicationContext.xml关键片段如下：

<!-- 数据源配置（使用 Druid 替代 BasicDataSource，提升连接池稳定性） --> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> <property name="url" value="jdbc:mysql://localhost:3306/dormitory_db?useUnicode=true&amp;characterEncoding=utf8"/> <property name="username" value="root"/> <property name="password" value="123456"/> <property name="driverClassName" value="com.mysql.jdbc.Driver"/> <property name="initialSize" value="5"/> <property name="maxActive" value="20"/> </bean> <!-- SqlSessionFactoryBean --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <property name="configLocation" value="classpath:mybatis-config.xml"/> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <!-- Mapper 扫描器 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.dormitory.dao"/> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/> </bean> <!-- 事务管理器 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource"/> </bean> <!-- 启用注解式事务 --> <tx:annotation-driven transaction-manager="transactionManager"/>

提示：MapperScannerConfigurer的basePackage必须精确指向dao包，且sqlSessionFactoryBeanName值必须与sqlSessionFactoryBean ID 一致，否则启动时报No qualifying bean of type 'org.apache.ibatis.session.SqlSessionFactory'。

3. 设计数据库脚本与实体映射：从 dormitory_db 到 Java POJO 的精准对齐

3.1 核心表结构设计原则：兼顾业务完整性与答辩可解释性

学生宿舍管理系统的数据库设计，不能简单照搬教务系统或 ERP 模块。毕设要求体现“你对业务的理解”，因此表结构需包含明确的业务语义字段。以t_student表为例，除基础字段外，必须包含：

• dormitory_id INT COMMENT '当前入住宿舍ID'（关联t_room）
• check_in_date DATE COMMENT '入住日期'
• is_checked_out TINYINT DEFAULT 0 COMMENT '0-未退宿,1-已退宿'
• last_update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP

这种设计使“查询某学生当前宿舍状态”可直接用单表查询完成，避免答辩时被追问“为什么还要 join 多张表”。同理，t_room表中room_status TINYINT字段值域定义为0-空闲,1-入住,2-维修中,3-待清洁，而非模糊的status VARCHAR(10)，体现数据规范意识。

3.2 完整数据库脚本（含建库、建表、初始数据）

-- 创建数据库（字符集强制 utf8mb4，避免微信昵称等生僻字乱码） CREATE DATABASE IF NOT EXISTS dormitory_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE dormitory_db; -- 楼栋表 CREATE TABLE t_building ( id INT PRIMARY KEY AUTO_INCREMENT, building_name VARCHAR(50) NOT NULL COMMENT '楼栋名称，如：1号楼', floor_count TINYINT NOT NULL COMMENT '楼层数', total_rooms SMALLINT NOT NULL COMMENT '总房间数', create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 房间表 CREATE TABLE t_room ( id INT PRIMARY KEY AUTO_INCREMENT, building_id INT NOT NULL, room_number VARCHAR(20) NOT NULL COMMENT '房间号，如：301', room_type ENUM('四人间','六人间','八人间') DEFAULT '四人间', room_status TINYINT DEFAULT 0 COMMENT '0-空闲,1-入住,2-维修中,3-待清洁', capacity TINYINT DEFAULT 4 COMMENT '最大容纳人数', current_occupancy TINYINT DEFAULT 0 COMMENT '当前入住人数', FOREIGN KEY (building_id) REFERENCES t_building(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 学生表 CREATE TABLE t_student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) UNIQUE NOT NULL COMMENT '学号', name VARCHAR(20) NOT NULL, gender ENUM('男','女') NOT NULL, major VARCHAR(50), grade VARCHAR(10) COMMENT '年级，如：2022级', dormitory_id INT COMMENT '当前入住房间ID', check_in_date DATE, is_checked_out TINYINT DEFAULT 0, last_update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, FOREIGN KEY (dormitory_id) REFERENCES t_room(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 插入测试数据（确保首次启动有数据可查） INSERT INTO t_building (building_name, floor_count, total_rooms) VALUES ('1号楼', 6, 120), ('2号楼', 6, 120); INSERT INTO t_room (building_id, room_number, room_type, room_status, capacity, current_occupancy) VALUES (1, '101', '四人间', 1, 4, 3), (1, '102', '六人间', 0, 6, 0), (2, '201', '四人间', 1, 4, 4); INSERT INTO t_student (student_id, name, gender, major, grade, dormitory_id, check_in_date) VALUES ('2022001', '张三', '男', '计算机科学与技术', '2022级', 1, '2023-09-01'), ('2022002', '李四', '女', '软件工程', '2022级', 1, '2023-09-01'), ('2022003', '王五', '男', '网络工程', '2022级', 3, '2023-09-01');

3.3 实体类与 MyBatis 映射的双向验证

Student.java实体类必须严格对应t_student表字段，并添加 Lombok 注解减少样板代码：

import lombok.Data; import lombok.ToString; import java.util.Date; @Data @ToString public class Student { private Long id; private String studentId; // 对应数据库 student_id 字段 private String name; private String gender; private String major; private String grade; private Integer dormitoryId; // 注意：此处为 Integer，因数据库允许 NULL private Date checkInDate; private Integer isCheckedOut; private Date lastUpdateTime; }

对应的StudentMapper.xml中，<resultMap>必须显式指定列名与属性映射，避免因字段名大小写或下划线命名习惯导致空值：

<mapper namespace="com.example.dormitory.dao.StudentMapper"> <resultMap id="StudentResultMap" type="com.example.dormitory.entity.Student"> <id property="id" column="id"/> <result property="studentId" column="student_id"/> <result property="name" column="name"/> <result property="gender" column="gender"/> <result property="major" column="major"/> <result property="grade" column="grade"/> <result property="dormitoryId" column="dormitory_id"/> <result property="checkInDate" column="check_in_date"/> <result property="isCheckedOut" column="is_checked_out"/> <result property="lastUpdateTime" column="last_update_time"/> </resultMap> <select id="selectAll" resultMap="StudentResultMap"> SELECT * FROM t_student ORDER BY id DESC </select> </mapper>

关键验证点：启动项目后，访问http://localhost:8080/student/list，若返回 JSON 中studentId字段值为"2022001"（而非null或"2022001 "带空格），说明column="student_id"与property="studentId"映射成功。若字段为空，优先检查resultMap中column名是否与SELECT *实际返回列名完全一致（可通过 MySQL Workbench 执行SELECT * FROM t_student LIMIT 1确认）。

4. 实现核心功能模块：登录、房间管理、学生入住与状态联动

4.1 登录模块：基于 Session 的轻量级认证（避开 Shiro/Spring Security 复杂配置）

毕设无需企业级权限体系，采用HttpSession存储用户信息即可满足答辩要求。LoginController代码如下：

@Controller @RequestMapping("/login") public class LoginController { @Autowired private UserService userService; @RequestMapping(value = "/doLogin", method = RequestMethod.POST) public String doLogin(@RequestParam String username, @RequestParam String password, HttpServletRequest request) { // 仅验证管理员账号（毕设场景简化） if ("admin".equals(username) && "123456".equals(password)) { request.getSession().setAttribute("loginUser", "管理员"); return "redirect:/room/list"; // 登录成功跳转房间列表页 } else { request.setAttribute("errorMsg", "用户名或密码错误"); return "login"; // 返回登录页 } } @RequestMapping("/logout") public String logout(HttpServletRequest request) { request.getSession().invalidate(); return "redirect:/login.jsp"; } }

对应login.jsp页面需包含表单提交逻辑：

<form action="${pageContext.request.contextPath}/login/doLogin" method="post"> <input type="text" name="username" placeholder="用户名" required/> <input type="password" name="password" placeholder="密码" required/> <button type="submit">登录</button> <c:if test="${not empty errorMsg}"> <div style="color:red;">${errorMsg}</div> </c:if> </form>

注意：request.getSession().setAttribute("loginUser", "管理员")是关键安全锚点。后续所有 Controller 方法（如RoomController.list()）需先校验 Session 是否存在该属性，否则重定向至登录页。此逻辑虽简，但完整覆盖“未登录不可访问业务页面”的基本安全需求。

4.2 房间状态自动更新：入住/退宿操作触发的数据库联动

学生入住操作需同时更新t_student.dormitory_id和t_room.current_occupancy、t_room.room_status，这是体现业务逻辑深度的核心环节。RoomService中实现：

@Service @Transactional public class RoomService { @Autowired private RoomMapper roomMapper; @Autowired private StudentMapper studentMapper; /** * 学生入住房间：更新学生 dormitory_id，并同步增加房间 occupancy */ public void assignStudentToRoom(Long studentId, Integer roomId) { // 1. 查询房间当前 occupancy Room room = roomMapper.selectById(roomId); if (room.getCurrentOccupancy() >= room.getCapacity()) { throw new RuntimeException("房间已满，无法分配"); } // 2. 更新学生表 Student student = new Student(); student.setId(studentId); student.setDormitoryId(roomId); student.setCheckInDate(new Date()); student.setIsCheckedOut(0); studentMapper.updateByPrimaryKeySelective(student); // 3. 更新房间表：occupancy +1，若满员则 status=1 room.setCurrentOccupancy(room.getCurrentOccupancy() + 1); if (room.getCurrentOccupancy() == room.getCapacity()) { room.setRoomStatus((byte) 1); // 入住满员 } roomMapper.updateByPrimaryKeySelective(room); } /** * 学生退宿：清空学生 dormitory_id，减少房间 occupancy */ public void checkoutStudent(Long studentId) { Student student = studentMapper.selectByPrimaryKey(studentId); if (student.getDormitoryId() == null) { return; // 未入住，无需操作 } // 更新学生表 student.setDormitoryId(null); student.setIsCheckedOut(1); studentMapper.updateByPrimaryKeySelective(student); // 更新房间表 Room room = roomMapper.selectById(student.getDormitoryId()); if (room != null) { room.setCurrentOccupancy(Math.max(0, room.getCurrentOccupancy() - 1)); // 若 occupancy=0，则 room_status 回置为 0（空闲） if (room.getCurrentOccupancy() == 0) { room.setRoomStatus((byte) 0); } roomMapper.updateByPrimaryKeySelective(room); } } }

验证方法：在数据库中执行UPDATE t_student SET dormitory_id=1 WHERE id=1;模拟手动分配，然后调用assignStudentToRoom(1L, 1)，观察t_room表中current_occupancy是否从 3 变为 4，room_status是否仍为 1（因原容量为 4）。此联动逻辑是答辩时展示“你如何保证数据一致性”的黄金案例。

4.3 房间列表页：分页查询与状态中文转换

RoomController返回ModelAndView，将数据传递给 JSP 渲染：

@Controller @RequestMapping("/room") public class RoomController { @Autowired private RoomService roomService; @RequestMapping("/list") public ModelAndView list(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize) { PageHelper.startPage(pageNum, pageSize); List<Room> roomList = roomService.selectAll(); PageInfo<Room> pageInfo = new PageInfo<>(roomList); ModelAndView mv = new ModelAndView("room/list"); mv.addObject("pageInfo", pageInfo); return mv; } }

room/list.jsp中使用 JSTL 标签渲染状态：

<c:forEach items="${pageInfo.list}" var="room"> <tr> <td>${room.id}</td> <td>${room.roomNumber}</td> <td> <c:choose> <c:when test="${room.roomStatus == 0}">空闲</c:when> <c:when test="${room.roomStatus == 1}">入住</c:when> <c:when test="${room.roomStatus == 2}">维修中</c:when> <c:otherwise>待清洁</c:otherwise> </c:choose> </td> <td>${room.currentOccupancy}/${room.capacity}</td> <td> <a href="${pageContext.request.contextPath}/student/assign?roomId=${room.id}">分配学生</a> </td> </tr> </c:forEach>

5. 毕设交付与答辩准备：源码打包、数据库脚本导出与关键演示点设计

5.1 项目源码标准化打包：确保导师双击可运行

毕设交付的ssm-dormitory.zip必须包含以下结构，杜绝“缺 jar 包”、“少配置文件”等致命问题：

ssm-dormitory/ ├── pom.xml // Maven 依赖声明 ├── src/ │ ├── main/ │ │ ├── java/ // 全部 Java 源码 │ │ ├── resources/ // applicationContext.xml 等配置文件 │ │ └── webapp/ // JSP、CSS、JS、WEB-INF/web.xml │ └── test/ ├── target/ // 编译后 class 文件（可选，但建议保留） ├── database/ // 数据库脚本存放目录 │ ├── dormitory_db.sql // 完整建库建表脚本（含测试数据） │ └── update_v1.1.sql // 后续迭代的增量脚本（如新增字段） ├── README.md // 包含：项目简介、环境要求（JDK8+Tomcat8+MySQL5.7）、启动步骤、默认账号 └── screenshots/ // 系统首页、房间列表、学生分配页截图（用于答辩 PPT）

关键动作：在 IDEA 中右键项目 →Maven→clean compile package，确认target/ssm-dormitory.war生成成功。将 WAR 包解压，检查WEB-INF/classes/下是否存在applicationContext.xml，WEB-INF/lib/下是否有spring-webmvc-5.3.31.jar等核心 jar，缺失则pom.xml依赖未生效。

5.2 数据库脚本导出：用 mysqldump 生成可复现的 .sql 文件

避免直接复制粘贴 Navicat 导出的 SQL（常含CREATE SCHEMA语句导致导入失败）。使用命令行导出纯净脚本：

# 导出结构（不含数据） mysqldump -u root -p --no-data dormitory_db > database/dormitory_db_structure.sql # 导出数据（不含建表语句） mysqldump -u root -p --no-create-info dormitory_db > database/dormitory_db_data.sql # 合并为完整脚本（推荐此方式） mysqldump -u root -p --default-character-set=utf8mb4 dormitory_db > database/dormitory_db.sql

验证脚本可用性：在新 MySQL 实例中执行source /path/to/dormitory_db.sql，确认SELECT COUNT(*) FROM t_student;返回 3 条记录。若报错Unknown character set: 'utf8mb4'，说明目标 MySQL 版本低于 5.5.3，需将脚本中所有utf8mb4替换为utf8。

5.3 答辩演示清单：5 分钟内聚焦 3 个技术亮点

不要试图演示全部功能，而是用 3 个可量化、可截图、可解释的点证明能力：

最后一步：将database/dormitory_db.sql文件拖入答辩 PPT 的“系统部署”页，旁边标注“一键导入，5 分钟完成环境搭建”，这是导师最认可的交付诚意。

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