简介这是一套面向计算机专业本科生毕业设计与Java初学者实战训练的SSM框架宿舍管理项目聚焦校园公寓数字化管理场景覆盖学生报修、签到、奖惩、访客登记及宿舍评分等核心业务流程。资源包共3个文件1个SQL数据库脚本用于初始化MySQL数据1个ZIP含完整SSM源码与项目说明1个TXT提供部署指引总大小26.15MB结构精炼、开箱即用。已有5186人学习下载验证了其在毕设选题与课程实训中的高复用性。读者可直接导入EclipseTomcat环境运行获得包含前后台双角色权限体系、模块化功能代码、规范数据库设计及调试通过的可执行工程特别适合理解SpringSpringMVCMyBatis整合开发流程与校园管理系统业务建模逻辑。1. 为什么用 SSM 搭建学生宿舍管理系统仍是计算机毕设里稳扎稳打的首选方案很多同学拿到“学生宿舍管理系统”这个毕设题目时第一反应是这不就是个增删改查用 Spring Boot 不是更快但现实是——在高校教学环境、答辩评审标准和导师技术栈适配度三重约束下SSMSpring Spring MVC MyBatis依然是近五年高校计算机类毕设中落地率最高、通过率最稳的技术组合。它不追求前沿炫技而是把“可讲清楚、可现场演示、可快速调试、可独立部署”四件事做到闭环。系统要管理楼栋、房间、学生入住、调宿、报修、卫生检查、晚归登记等核心业务这些模块天然契合 SSM 的分层解耦结构Controller 层承接 Web 请求如/room/list?buildingId3Service 层封装业务逻辑如“同一房间不能重复分配”校验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.dormitoryArtifactId设为ssm-dormitory。在pom.xml中声明以下关键依赖版本号严格对应主流教学环境properties spring.version5.3.31/spring.version mybatis.version3.4.6/mybatis.version mybatis-spring.version1.3.2/mybatis-spring.version mysql-connector-java.version5.1.47/mysql-connector-java.version junit.version4.13.2/junit.version /properties dependencies !-- Spring 核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- MyBatis 集成 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version${mybatis-spring.version}/version /dependency !-- 数据库驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql-connector-java.version}/version /dependency !-- Servlet API -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version3.1.0/version scopeprovided/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并添加serverTimezoneUTC参数但毕设推荐统一用 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.xmlSpring 核心容器声明数据源、事务管理器、Service Bean 扫描spring-mvc.xmlSpring MVC配置视图解析器、静态资源处理、Controller 扫描mybatis-config.xmlMyBatis设置别名、类型处理器、Mapper XML 路径其中applicationContext.xml关键片段如下!-- 数据源配置使用 Druid 替代 BasicDataSource提升连接池稳定性 -- bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property nameurl valuejdbc:mysql://localhost:3306/dormitory_db?useUnicodetrueamp;characterEncodingutf8/ property nameusername valueroot/ property namepassword value123456/ property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameinitialSize value5/ property namemaxActive value20/ /bean !-- SqlSessionFactoryBean -- bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean !-- Mapper 扫描器 -- bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.dormitory.dao/ property namesqlSessionFactoryBeanName valuesqlSessionFactory/ /bean !-- 事务管理器 -- bean idtransactionManager classorg.springframework.jdbc.datasource.DataSourceTransactionManager property namedataSource refdataSource/ /bean !-- 启用注解式事务 -- tx:annotation-driven transaction-managertransactionManager/提示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_roomcheck_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 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 房间表 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) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 学生表 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) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 插入测试数据确保首次启动有数据可查 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 namespacecom.example.dormitory.dao.StudentMapper resultMap idStudentResultMap typecom.example.dormitory.entity.Student id propertyid columnid/ result propertystudentId columnstudent_id/ result propertyname columnname/ result propertygender columngender/ result propertymajor columnmajor/ result propertygrade columngrade/ result propertydormitoryId columndormitory_id/ result propertycheckInDate columncheck_in_date/ result propertyisCheckedOut columnis_checked_out/ result propertylastUpdateTime columnlast_update_time/ /resultMap select idselectAll resultMapStudentResultMap SELECT * FROM t_student ORDER BY id DESC /select /mapper关键验证点启动项目后访问http://localhost:8080/student/list若返回 JSON 中studentId字段值为2022001而非null或2022001 带空格说明columnstudent_id与propertystudentId映射成功。若字段为空优先检查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 methodpost input typetext nameusername placeholder用户名 required/ input typepassword namepassword placeholder密码 required/ button typesubmit登录/button c:if test${not empty errorMsg} div stylecolor: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若满员则 status1 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)); // 若 occupancy0则 room_status 回置为 0空闲 if (room.getCurrentOccupancy() 0) { room.setRoomStatus((byte) 0); } roomMapper.updateByPrimaryKeySelective(room); } } }验证方法在数据库中执行UPDATE t_student SET dormitory_id1 WHERE id1;模拟手动分配然后调用assignStudentToRoom(1L, 1)观察t_room表中current_occupancy是否从 3 变为 4room_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); ListRoom roomList roomService.selectAll(); PageInfoRoom 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} varroom 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:forEach5. 毕设交付与答辩准备源码打包、数据库脚本导出与关键演示点设计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 // 包含项目简介、环境要求JDK8Tomcat8MySQL5.7、启动步骤、默认账号 └── screenshots/ // 系统首页、房间列表、学生分配页截图用于答辩 PPT关键动作在 IDEA 中右键项目 →Maven→clean compile package确认target/ssm-dormitory.war生成成功。将 WAR 包解压检查WEB-INF/classes/下是否存在applicationContext.xmlWEB-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-setutf8mb4 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 个可量化、可截图、可解释的点证明能力演示环节操作步骤技术亮点答辩话术数据一致性保障在房间列表页点击“分配学生”选择学生张三 → 查看数据库t_room.current_occupancy和t_student.dormitory_id同步更新Transactional事务控制 手动状态计算“这里用 Spring 事务确保分配操作原子性避免出现学生已分配但房间 occupancy 未增加的脏数据”动态状态渲染刷新房间列表页观察room_status1的行显示“入住”room_status0显示“空闲”JSTLc:choose标签 数据库枚举值映射“状态值存储为数字提升查询效率前端用标签转换为中文兼顾性能与可读性”可追溯的修改记录查看t_student.last_update_time字段确认每次入住/退宿后时间自动更新MySQLON UPDATE CURRENT_TIMESTAMP“利用数据库原生特性自动记录最后操作时间避免在 Java 层手动 set 时间减少出错可能”最后一步将database/dormitory_db.sql文件拖入答辩 PPT 的“系统部署”页旁边标注“一键导入5 分钟完成环境搭建”这是导师最认可的交付诚意。本文还有配套的精品资源点击获取
