1. 为什么宿舍管理系统成了毕业设计里绕不开的经典题每年到毕设选题季总有一批人被“高校学生公寓管理系统”“校园宿舍智慧服务平台”这类题目包围。说实话这个题目在SpringBoot生态里属于典型的业务管理系统难度适中、功能边界清晰、技术栈经典非常适合用来做JavaWeb架构下的完整项目演示。它不像电商系统那样涉及复杂的支付并发也不像推荐系统那样需要算法支撑但它覆盖了管理系统该有的全部基本功增删改查、关联查询、状态流转、权限控制、统计分析一套做完JavaWeb那点东西基本都练到了。那这道题到底要解决什么问题我拆一下需求高校宿舍管理过去靠Excel台账加纸质登记学生信息、床位分配、报修记录、晚归登记、电费水费统计全散落在不同表格里宿舍管理员和辅导员之间来回对表低效又容易出错。这个系统的核心价值就是把“选宿舍、办入住、报修、查水电、退宿”这一整条链路由线下搬到线上让管理员能管、学生能用、辅导员能看。对毕设而言你只要把这三类人的核心诉求用代码实现了项目就已经立住了。但这个题也埋着不少坑。最典型的就是“产品边界收不住”——很多同学一开始就想着做大而全把投票系统、失物招领、二手交易全塞进来结果四个月过去主流程都没跑通。我见过太多类似的案例所以这篇博文会围绕“怎么把核心流程做扎实”来展开从环境搭建、项目结构、数据库设计到模块实现、常见报错按我实际做过的一个版本完整复盘。适合SpringBoot学完基础但还没完整做过系统的人参考也适合已经选了这个题但不知道从哪下手的人照着搭。这个题的另一个价值在于展示性。SpringBoot配上JavaWeb分层架构答辩时可以从“前后端怎么交互”“数据库如何设计”“模块如何解耦”几个方向讲条理非常清晰评委一般也能听懂。下面我直接按一个可复现的版本来讲。2. 技术选型与版本选择先避开“版本太高”这个最大暗坑先说版本因为这个坑最隐蔽也最影响进度。2024到2025年间不少同学一进Spring Initializr就默认选SpringBoot 3.x结果后面一连串问题JDK要17以上、javax包全变成jakarta、MyBatis-Plus最新版适配还有兼容问题、部分老教程里的配置直接失效。如果你不是专门想研究新特性我建议老老实实选SpringBoot 2.7.x配JDK 1.8或11生态最成熟网上的资料和教程也最匹配踩坑成本最低。2.1 核心技术栈清单下面是我在这个项目里用的技术组合都是经过验证的开发语言Java 8框架SpringBoot 2.7.18持久层MyBatis-Plus 3.5.3比纯MyBatis少写大量XML适合快速出活模板引擎Thymeleaf服务端渲染不用单独写前端项目毕设最省事数据库MySQL 5.7 / 8.0权限认证Sa-Token 或 Spring Security新手推荐前者封装简单构建工具Maven 3.6别再手动导jar包了Maven是底线IDEIntelliJ IDEA连接池Druid自带监控页面答辩展示很加分你可能会问为什么不用前后端分离。我的建议是如果毕设时间紧、重点在业务功能直接用Thymeleaf做服务端渲染就够了。前端Vue 后端SpringBoot的分离架构虽然看着高大上但你要额外处理跨域、Token认证、前端打包、部署联调一堆问题工期至少多出三到四周。先把服务端渲染版本跑通拿出完整功能再考虑是否需要升级为前后端分离这是性价比最高的路线。2.2 Maven项目构建的正确姿势Maven这块经常有人翻车尤其是“idea运行javaweb项目配置”这类问题反复出现。我用mvn archetype或直接在IDEA里创建Spring Initializr项目时有几点一定要提前确认第一确认本机Maven仓库的镜像源。国内直接用默认中央仓库下载依赖慢到怀疑人生。改成阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror第二IDEA里Maven配置要统一。Settings - Build Tools - Maven把Maven home path指到你本地解压的Maven目录User settings file指向conf/settings.xmlLocal repository指向你自己的仓库目录。这三个必须一致否则会出现“明明在命令行能构建IDEA里却报找不到依赖”的诡异问题。第三Maven依赖版本锁定。把SpringBoot父工程版本设为2.7.18后MyBatis-Plus的starter要用3.5.xDruid用1.2.x。别随手写个最新版本有些新版本已经适配了SpringBoot 3的包名规则在2.x下反而会出问题。2.3 数据库选型与字符集MySQL就用5.7或8.0都行但建库时一定用utf8mb4别用utf8。宿舍管理系统的用户填表里经常有生僻字或表情符号utf8mb4能存utf8会报“Incorrect string value”。建库语句CREATE DATABASE dormitory_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;Connector/J驱动版本如果是MySQL 8.0就用8.0.x的驱动连接串里加上serverTimezoneAsia/Shanghai否则Java 8时区问题会让你在插入时间字段时看到一堆诡异偏移。3. 项目结构设计与数据库建模一张表关系图先画明白很多同学拿到需求文档第一件事就是打开IDEA写代码这是个大错误。管理系统最要紧的其实是数据库设计表关系搞不清楚后面写业务代码就是反复推倒重来。我习惯先用Excel或draw.io把表关系和字段列出来等所有核心表都确定了再动手写实体类。3.1 功能模块边界别让系统膨胀成四不像这个题的核心模块我圈定了六个没有再往外扩学生管理学籍信息维护、入住登记、调宿、退宿申请宿舍管理楼栋、楼层、房间、床位四级结构维护床位状态查询报修管理学生提交报修管理员派单、跟进、归档水电管理按月记录每个宿舍用水用电量生成账单访客/出入登记外来人员登记晚归记录系统管理用户登录、角色权限、公告发布你对比一下就会发现这六个模块覆盖了宿舍从“住进来”到“住的过程”到“搬走”的完整生命周期。其他像是留言板、评价打分、失物招领这类额外的模块你可以放到“扩展功能”里在答辩时口述用户体验和功能亮点都可以用但不要让它们进入MVP版本。3.2 核心表的字段设计与关系说明我总共设计了9张业务表加1张用户表核心关系如下用户表是统一的登录入口按角色区分学生、宿管、辅导员、系统管理员。为什么不用三张表存三种人因为你登录时只需要查一次账号密码如果分表就要每个角色查一遍权限判断也麻烦。角色字段用int或string都行我个人倾向用字符串枚举值可读性好。学生表与宿舍表之间是“多对一”关系一个宿舍最多住四人不同学校可配但学生表里直接存dorm_id和bed_no这两个字段目的就是让查询“这个学生住哪”走一次简单索引而不是多表关联。床位状态用0/1表示“空闲/占用”但还要留一个“维修中”状态就不够用了所以用枚举int表示0空闲、1占用、2维修。这些细节做系统设计时要提前想好别只盯着增删改查。报修表里的状态流转是整张表的设计重点。学生提交时为“待处理”管理员接单后变“处理中”处理完变成“已完成”最后学生还可以评论满意度。我把status字段设计成int型0待处理、1处理中、2已完成、3已取消另外加了handle_time和finish_time两个时间字段方便统计每个工单的处理时长答辩时有这个字段就能做出一个“平均响应速度”的统计图表。水电表按月记录用宿舍id 月份做唯一索引防止同一宿舍同一个月录两条。账单金额由管理员录入或由用量自动计算看你们学校是按固定单价还是阶梯计价。如果按阶梯计价需要单独一个price_config表存配置这算加分项。3.3 主外键到底要不要建有一点必须说清楚MyBatis-Plus逻辑删除和物理外键有时候会打架。如果你开了逻辑删除TableLogic那么有物理外键的表在删数据时会很别扭——因为逻辑删除不走delete语句只走update所以物理外键的限制完全不生效。我的做法是不建物理外键只建逻辑外键也就是普通字段关联所有关联一致性靠程序保证。这不是偷懒而是管理系统的通用做法理由很简单物理外键在高并发或分库分表场景下是性能瓶颈而且会给迁移数据带来麻烦。答辩时如果你能说清楚这一点评委反而会认可。我还建议所有表都带上create_time、update_time、deleted三个公共字段用MyBatis-Plus的自动填充功能统一维护省去到处写时间赋值的代码。这是规范性问题能让代码显得专业。3.4 页面结构规划Thymeleaf版本不用单独写前端工程但页面模板的规划要提前做。我的布局是一个主框架topbar sidebar content所有功能页都复用同一套布局侧边栏菜单根据角色动态渲染学生看到的是报修、水电查询、调宿申请宿管看到的是入住办理、床位管理、报修派单。这个动态菜单是系统的亮点之一后端用一个menu表存菜单与角色的关系前端Thymeleaf片段渲染代码量不大但观感提升非常明显。4. 核心业务模块实现从登录到入住办理的完整链路这部分我挑几个最核心、最能体现系统功能深度的模块讲代码会给出关键片段但不会把所有类都贴一遍——那太长了而且比这更重要的是一步步的思考过程。4.1 登录认证与权限控制的落地方式我用Sa-Token做登录认证比Spring Security写起来省太多。引入依赖后登录接口就三件事StpUtil.login(userId); StpUtil.getSession().set(user, userInfo); return StpUtil.getTokenValue();然后加一个拦截器注册到WebMvcConfig里Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new SaInterceptor(handle - { StpUtil.checkLogin(); })).addPathPatterns(/**).excludePathPatterns(/login, /css/**, /js/**, /images/**); }角色控制用注解更简洁在Controller方法上加SaCheckRole(admin)注意Sa-Token的注解默认没有开启需要在启动类上加SaCheckLogin或配置SaInterceptor时启用注解鉴权否则SaCheckRole不生效。这个点我见过很多人踩坑。4.2 宿舍分配与入住办理状态防抢是关键宿舍分配是业务上最容易出并发问题的地方。比如两个学生同时申请最后一间空宿舍一个成功一个失败最终数据库里不能出现双人占用同一张床。我的设计是在room表里增加available_beds字段每次分配床位时用乐观锁Update(UPDATE room SET available_beds available_beds - 1 WHERE id #{roomId} AND available_beds 0) int reduceAvailableBeds(Long roomId);这个SQL自带条件available_beds大于0才会扣减否则影响行数为0。根据返回的int值判断是否成功等于0就说明没抢到床直接提示“该宿舍已满”。这个简单方案比复杂的Redis分布式锁更适合毕设场景而且答辩时能说清楚“为什么SQL自带条件可以防超卖”这就已经很加分了。入住办理是一个事务性操作我写成Transactional(rollbackFor Exception.class) public void checkIn(CheckInDTO dto) { // 1. 校验学生状态是否已分配宿舍 // 2. 校验宿舍床位是否空闲 // 3. 扣减可用床位 // 4. 更新学生宿舍和床位信息 // 5. 生成入住记录写check_in_log表 }事务必须加上rollbackFor Exception.class不然某些运行时异常导致数据不一致排查极其痛苦。4.3 报修工单的状态机设计报修工单属于典型的单方向状态流待处理 - 处理中 - 已完成。用状态机管理的好处是流程清晰权限也容易控制——学生能提交、能取消但只有管理员能派单更新。我定义了一个枚举类public enum RepairStatus { PENDING(0, 待处理), PROCESSING(1, 处理中), FINISHED(2, 已完成), CANCELED(3, 已取消); private final int code; private final String desc; // getter... }前端页面的状态展示直接根据 code 翻译成文案。当学生提交报修时还可以附带照片我采用本地文件存储路径存到数据库前端用Thymeleaf的th:src直接访问。文件路径用UUID重命名避免中文文件名和重名问题String fileName UUID.randomUUID().toString().replace(-, ) originalFilename.substring(originalFilename.lastIndexOf(.)); File dest new File(UPLOAD_DIR, fileName);4.4 水电费自动计算与按月出账水电这块核心是按月汇总。月初管理员录用量月末系统自动出账。如果学校用固定单价计算逻辑就很简单了BigDecimal amount elecUsage.multiply(elecPrice).add(waterUsage.multiply(waterPrice));但很多学校是阶梯电价那就需要配置阶梯表。阶梯表设计成三段用量区间单价0-100度0.55101-300度0.75301度以上1.00计算时会遍历一个宿舍当月总用量分段累加。这个逻辑不复杂但一定要单独抽出一个类来写别塞在Controller里。原因很简单这属于业务规则将来改计价方式时只需要改一个地方而且可以单独写单元测试。4.5 动态仪表盘与数据统计系统首页我做了个数据仪表盘展示在住人数、空余床位、待处理工单、本月水电应收四个卡片下面放了一个近6个月的报修趋势折线图。用ECharts的CDN方式引入模板渲染时把统计数据序列化成JSON数组传到页面里。这里有个人经验地图报表、饼图都好看但对宿舍系统来说最实用的是折线图和柱状图——报修趋势、各楼栋入住率、水电用量对比这三类图足够支撑答辩时的功能展示。别花大量时间去做华而不实的3D图表。5. 部署运行与高频报错的完整排查链路这个项目开发阶段最耗时间的地方往往不是业务代码本身而是一堆环境配置、依赖冲突、端口占用问题。我在做这个项目的过程中整理了一套高频问题排查链路照着做能省很多时间。5.1 IDEA配置SpringBoot运行的几个关键位置总有人问“IDEA怎么配置SpringBoot服务”。其实SpringBoot项目在IDEA里的运行配置很简单在Application启动类上右键选择RunIDEA会自动生成一个Spring Boot类型的运行配置。你要检查的是三个参数Program arguments一般不需要填除非你有启动参数Environment variables如果配置中心用到了Nacos或环境变量在这里填Active profiles如果你有application-dev.yml这种多环境文件这里填dev启动端口在application.yml里配置server: port: 8080 servlet: context-path: /dormitory加上context-path的好处是后面部署到服务器时可以放在同一个Nginx下跟其他项目共存不会冲突。5.2 “springboot版本太高”引发的问题及处理前面提过选2.7.18能避免一大半问题但如果你已经用了高版本最常见的报错是这个Error starting ApplicationContext. To display the conditions report re-run your application with debug enabled.这个报错信息很泛真正的细节在日志上面几行。常见原因JDK版本不兼容3.x必须17你如果还是JDK8直接报错sa-token、mybatis-plus等依赖用了老版本包名冲突编译级别与JDK不匹配记得把Project Structure里的Project SDK和Maven compiler level设备一致能降到2.7.x就直接降省时省力。降版本时注意把SpringBoot的parent版本改掉再把依赖里所有spring-boot-starter相关改成2.7.18同时把MyBatis-Plus版本调到3.5.x。如果你已经写了jakarta包名的代码还要批量改回javax。5.3 数据库连接失败的排查顺序日志中出现“Cannot create PoolableConnectionFactory”或“Access denied”时按这个顺序查第一个连接串里的数据库名是否存在。很多人改了项目但没建库或者是库名不一致。第二个用户名密码对不对。MySQL 8.0注意密码认证插件是否为caching_sha2_password如果客户端驱动太旧会连不上。第三个端口有没有写错。默认是3306如果你本地装过多个MySQL实例占用了3307就把url改成对应端口。第四个时区问题。连接串没加serverTimezone参数时JDBC会报“The server time zone value”这种错误直接加上url: jdbc:mysql://localhost:3306/dormitory_system?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb45.4 页面能打开但CSS样式空白这个问题特别隐蔽。用Thymeleaf时如果Controller返回的视图名写错页面会变成500但如果是静态资源引用路径写错页面能打开却光秃秃的没有样式。最简单的方法是用模板路径link th:href{/css/style.css} relstylesheetThymeleaf会自动加上context-path前缀。如果你直接写href/css/style.css部署时context-path不为空就会404。还有一个坑是加装了Shiro或Sa-Token拦截器后静态资源没有放行也会导致CSS加载不出来。拦截器配置里的excludePathPatterns必须把/css/、/js/、/images/、/fonts/都放进去。5.5 前端传时间为空时MySQL报错宿舍管理里经常有时候比如入住在校时间不固定前端表单某次没传时间字段后端一插入就报SQLException。解决办法是在实体类的时间字段上增加注解TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime;之后写一个MetaObjectHandler实现类统一填充。里面对应创建和更新时自动赋值当前时间。这样就彻底杜绝了“空时间戳”的问题代码也统一好看了。6. 经验沉淀与后续扩展方向项目做完之后回头看这个系统最值得推荐的其实不是某个具体功能而是一套完整的管理系统开发思路先想清边界再设计表结构然后实现核心流程最后才考虑图表和展示。初学者最大的问题往往是倒着来一上来先弄漂亮的页面结果业务流程一塌糊涂。6.1 答辩时如何展示这个项目的价值我给你一个答辩展示的逻辑顺序先讲这个系统的用户痛点Excel管理低效、信息孤岛、报修追踪难再讲你的核心模块如何对应解决这些痛点最后讲数据层面你能沉淀出什么宿舍入住率、报修响应时长、水电费用趋势。技术点挑三个讲透SpringBoot的自动配置原理、MyBatis-Plus如何简化持久层开发、Sa-Token的认证流程。这三个点都是面试官和评委愿意听到的。6.2 可以继续扩展的几个方向如果你做完基础版还有时间按优先顺序推荐微信小程序端学生报修、查询水电不必再上浏览器小程序体验更好而且SpringBoot后端可以复用一大半。人脸识别门禁把宿舍楼门禁和系统联动这个偏硬件需要对接第三方API展示效果很强。消息通知报修状态变更时通过邮件或短信通知学生用SpringBoot的异步事件机制实现顺便展示了你对ApplicationEvent的理解。Vue3前端分离改造等答辩主要内容都稳了再动手属于加分项但没必要为此打乱计划。6.3 给你几个保命的项目规范建议最后说几个我做项目时切身体会出来的规范都是拿头发换的项目目录一定要分组写清楚。controller、service、mapper、entity、dto、config、common、utils这些包都分好当时看起来麻烦但等你在do里找字段、在controller里找逻辑时就会感谢这个分组。接口路径统一风格。避免test1、test2这种尽量用RESTful风格比如/student/list、/student/dormitory/{id}、/repair/assign。清晰路径对后面的维护和答辩都更有利。Controller里不写业务逻辑。Controller只做参数接收和返回结果业务逻辑全放Service层。这是最基础的分层设计但很多初学者写起来就会把SQL循环写在Controller里等想复用的时候哭都来不及。如果项目里有测试数据用data.sql或import.sql脚本统一导入别在代码里偷偷new一堆数据。保持数据库随时可以重建这样答辩时演示环境出问题你也能一分钟内恢复。