Spring Boot宿舍报修系统实战：从工单状态机到权限控制与调试部署全攻略

最近几年接手过不少Java毕设的调试和辅导，宿舍报修维护系统算是出镜率相当高的题目了。乍一听好像没什么技术含量，无非就是学生提交、管理员处理，但真正动手做起来，里面的门道其实不少。这次就拿一个基于Spring Boot的宿舍报修维护系统来做一次完整的拆解，从项目定位、业务设计、数据库建模，到代码结构、本地调试、常见报错排查，再到答辩时容易被追问的点，一次性说透。不管是打算直接用它交毕设，还是想在其中加点自己的东西，这篇内容都值得你花几分钟看完。

1. 项目整体设计与技术选型思路

1.1 宿舍报修系统的本质：一张工单的完整生命周期

很多同学拿到这个题目后，第一反应就是“做个增删改查”。这种理解不算错，但只停留在表层。宿舍报修维护系统的核心，不是“报修”这个动作，而是报修工单从提交到完结的全流程管理。换句话讲，它本质上是一个轻量级的工单系统（Ticketing System），只是场景换成了高校宿舍。

你站在宿管阿姨和维修师傅的角度想一下，一天可能会收到几十条报修请求，哪些是急事？哪些是重复报修？谁负责处理？处理到哪一步了？如果只是拿本子记，根本忙不过来。所以系统要解决的痛点很明确：让学生的报修请求能被记录、跟踪、派单、处理、反馈，并且全程有据可查。这也就决定了系统的核心模块不只是CRUD，而是要覆盖以下几条链路：

• 学生端：提交报修、查看进度、确认完成、评价反馈
• 维修端：查看待接单工单、更新处理状态、填写维修结果
• 管理端：管理学生和维修工信息、分配工单、查看统计

把这三条链路理清楚之后，再去设计表结构和接口，思路就会清晰很多。

1.2 为什么是Spring Boot而不是SSH或者Servlet

选Spring Boot做毕设，可以说是目前Java领域最合理的选择。原因很简单：它把繁琐的配置全部“约定优于配置”掉了，让你能把精力放在业务逻辑上。

早些年做JavaWeb毕设，常见的是SSH（Struts2 + Spring + Hibernate）或者SSM（Spring + SpringMVC + MyBatis）组合。SSH那套现在已经非常过时了，配置文件动辄几十行，光整合三大框架就能让你折腾一个星期。SSM也略微繁琐，虽然结构清晰，但需要自己处理大量的XML配置。Spring Boot把这些统统封装好，内嵌了Tomcat容器，一个main方法就能启动整个Web服务，开发效率完全是另一个量级。

从毕设评分角度来说，Spring Boot也是一个“安全牌”。大部分答辩老师对这套技术栈都比较熟悉，而且结合Spring Boot的自动装配、 starter机制、统一异常处理这些点，也很容易在答辩时展示出项目的深度。相比之下，用普通Servlet写个JSP项目，技术含量一眼望到头，答辩时反而没什么可聊的。

另外，Spring Boot的生态非常成熟，网上能搜到的资料、博客、踩坑记录都非常多。这对毕设周期短、没太多实战经验的同学来说是巨大的优势——遇到问题基本都能搜到现成答案。

1.3 技术栈的完整选型清单

拿我经手过的这套系统来说，技术栈选型如下：

这套组合的特点是比较均衡：既能保证开发效率，又能在答辩时讲出不少技术点。尤其MyBatis-Plus，很多同学在简历里写“熟练使用MyBatis”，实际上只是写写单表CRUD，MyBatis-Plus的存在感反而更强。

需要特别提醒的一点是：Spring Boot版本不要一上来就选最新版。原因后文会专门讲，这里先提个醒——2.7.x目前对毕设来说是最稳的选择，JDK 8或JDK 11都能很好兼容，网上的解决方案也最丰富。

2. 核心业务模块与数据库设计实录

2.1 用户角色与权限边界

宿舍报修系统里有三类角色，角色不同，权限边界也不同。设计的时候不能只靠前端隐藏按钮来做权限控制，后端接口也一定要有限制，否则任何人都能直接调接口改别人的报修单，这在答辩时是会被追问的。

第一类是学生。学生登录后能提交报修、查看自己名下的报修单列表和详情、在维修完成后进行确认与评价。这里要特别注意“数据隔离”问题，千万不要让一个学生通过修改URL中的id就看到别人的报修单。第二类是维修工。维修工能看到被分配给自己或者待认领的报修单，更新维修状态、填写维修说明和耗材使用情况。第三类是宿管管理员。管理员负责最核心的管理操作：处理学生的报修请求、指派给相应的维修工、查看所有报修进度、对维修工进行考核管理。

权限控制在实现层面，如果用了Spring Security，可以通过配置不同URL的antMatchers或requestMatchers来限制访问角色；如果没用，也必须写一个简单的拦截器，在HandlerInterceptor里校验登录状态和角色。别觉得这是小事，数据越权问题是毕业设计答辩中高频问点，提前设计好会省很多麻烦。

2.2 报修工单的状态流转设计

状态机是整个系统里最有讲头的部分。报修单不是只有“未处理”和“已处理”两个状态，太粗糙了。以我的经验，至少需要拆成五个状态才够用：

1. 待受理：学生提交报修后，工单自动进入这个状态，等待宿管管理员审核派单。
2. 待维修：管理员已经把工单指派给指定维修工，维修工尚未处理。
3. 维修中：维修工接单并开始处理，此时学生能在前端看到处理进度。
4. 待验收：维修工填写维修结果后，工单回到学生侧，等待学生确认。
5. 已完成：学生确认维修结果并评价后，整个流程闭环。

另外还要预留一个“已驳回”或“已取消”的状态，用于管理员驳回无效报修或者学生自己取消误报的工单。

这个状态流转的价值在于，它是整个系统的业务主线，也是你答辩时的讲述主线。老师问“你的系统核心流程是什么”时候，你完全可以顺着状态机讲得清清楚楚。而且状态流转天然引发一个问题：工单状态变化时是否要记录操作历史？答案是肯定要的。所以还需要一张操作记录表来保存每一步的变更信息。

2.3 数据库表结构设计要点

表设计决定了项目的数据模型是否清晰。我建议至少包含以下这些表：

• user：用户表。包含用户名、密码、真实姓名、角色、联系电话、宿舍楼栋及房间号等。角色字段可以用role区分学生/维修工/管理员，也可以用多表关联角色，看项目复杂度。
• repair_order：报修工单主表。核心字段包括工单编号、报修人ID、报修类型、报修描述、报修图片、紧急程度、状态、指派的维修工ID、创建时间、更新时间、完成时间等。
• repair_record：工单操作记录表。记录每一步状态变更的操作人、操作时间、操作内容，算是工单的“流水账”。
• dormitory：宿舍楼栋或房间信息表。如果项目规模不大，也可直接在user表里冗余楼栋房间信息，简化关联。
• evaluation：评价表。关联工单ID、评分、评价内容、评价时间。

有一个细节很关键：报修类型最好用字典字段管理,比如水电、门窗、电梯、网络、设备设施等。不要做成硬编码写在程序里，而是用type字段存字典值，方便后续扩展。紧急程度同理，用1/2/3分别代表低/中/高。

在设计表的时候，我见过不少同学把所有信息都塞在一张表里，方便是方便，但后续写SQL会越来越别扭。工单表、记录表、评价表分开设计，代码逻辑上也更清晰，属于“稍微多想一步，后面省十步”的典型。

2.4 前后端接口设计的约定

接口设计上，建议采用RESTful风格，以资源为核心。比如：

• POST /api/repair：学生提交报修
• GET /api/repair/my：查看我的报修单
• PUT /api/repair/{id}/assign：管理员派单
• PUT /api/repair/{id}/start：维修工开始维修
• PUT /api/repair/{id}/finish：维修工填写维修结果
• PUT /api/repair/{id}/confirm：学生确认完成

统一返回格式也非常重要。不要每个接口返回结构都不一样，建议封装一个Result类，含code、message、data三个字段。前端拿到响应后统一判断code，这样即使出现业务异常，也能用统一的错误格式返回，而不是直接抛出一堆堆栈信息。

3. 从源码到本地运行：调试运行完整实操

3.1 环境准备：JDK、Maven、MySQL、IDEA

很多人拿到源码后第一步就卡住了，因为本机环境根本没对齐项目的运行要求。别急着在IDEA里双击运行，先把环境准备好。

JDK建议安装1.8（也就是Java 8），这是当前绝大多数毕设项目的标准配置。如果本机装了更高版本，比如JDK 17或21，不一定会报错，但如果项目用的Spring Boot 2.x，JDK版本太高反而可能出现兼容问题。Maven方面，建议使用3.6.3以上版本，但不要用最新版（某些最新版Maven对仓库要求更严格）。MySQL推荐5.7或8.0，都行，但注意8.0以上版本的驱动和连接串，和5.7略有不同。IDE方面不用多说了，IDEA是首选，社区版也能用，但专业版对Spring Boot的支持更完整。

3.2 导入项目与最关键的配置修改

拿到源码之后，IDEA中选择File -> Open，选择项目根目录的pom.xml，IDEA会以Maven项目方式导入。首次导入时右下角会提示“Maven projects need to be imported”，选择Enable Auto-Import。然后等Maven把依赖下载完，这一步在国内网络环境下可能很慢，建议检查一下Maven的settings.xml里是否配置了阿里云镜像。

接下来是全局最关键的改动——修改application.yml或application.properties里的数据库连接配置。绝大多数项目连不上数据库，都是在这里出错。典型的配置如下：

yaml复制spring:
  datasource:
    url: jdbc:mysql://localhost:3306/repair_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: yourpassword
    driver-class-name: com.mysql.cj.jdbc.Driver

这里有几个点必须注意：serverTimezone=Asia/Shanghai要加上，否则MySQL 8.0会报时区错误；useSSL=false推荐加上，避免SSL握手警告；characterEncoding=utf8用来避免中文乱码。

数据库本身需要先手动创建，表结构一般会提供init.sql或schema.sql脚本。用Navicat或命令行执行：

bash复制mysql -u root -p < init.sql

3.3 启动项目与常见启动失败分析

配置完成后，找到主启动类——一般叫Application.java，类名上带有@SpringBootApplication注解，右键Run启动。

启动成功的标志是控制台打印出Spring Boot的Logo字符图案，以及Tomcat started on port(s): 8080之类的日志。如果看到Started Application in x.xxx seconds，说明项目已经正常启动。

但启动失败的情况也非常常见，这里列几个高频问题：

• APPLICATION FAILED TO START：通常是端口被占用或数据库连不上。先检查8080端口是否被其他程序占用，在命令行执行netstat -ano | findstr 8080查看。
• Access denied for user 'root'@'localhost'：数据库用户名或密码错误，去application.yml里面核对。
• Unknown database 'repair_system'：数据库还没创建，回到MySQL创建同名数据库。
• Failed to configure a DataSource：常见于只导入了项目但没改配置，或者数据库连接参数不完整。

这些错误看起来吓人，实际上80%都是环境或配置问题，定位到具体报错后搜一下，基本都能快速解决。

3.4 前端项目的单独启动

如果系统采用了前后端分离，前端Vue项目需要单独跑起来。命令行进入前端目录：

bash复制npm install
npm run serve

这里注意两个坑：一是npm install在国内可能很慢，建议先设置淘宝镜像源npm config set registry https://registry.npmmirror.com再安装；二是前端项目的接口地址默认是http://localhost:8080，如果后端端口改了，要去前端配置文件里同步修改，不然会请求不到数据。

前后端分离项目启动完成之后，浏览器访问http://localhost:8081（前端端口通常是8081或8082），能看到登录页面，说明整个项目跑通了。

4. 开发与调试中遇到的典型问题排查

这部分是干货中的干货，都是我实际调试项目过程中反复遇到过的坑，整理出来给各位做个速查手账。

4.1 Lombok编译报错：编译器不支持Lombok

很多项目为了减少冗余代码，会用到Lombok注解，比如@Data、@Getter、@Setter。但自己电脑上第一次编译时很容易出现这段报错：

code复制java: You aren't using a compiler supported by lombok, so lombok will not work with your project.

原因是IDEA内置的编译器版本和Lombok版本不兼容。最常见的场景是IDEA版本较新（比如2023.2+），Lombok版本还停留在1.18.20以下。解决方式也很直接：

• 升级Lombok依赖，把pom.xml里的lombok.version改成最新稳定版，比如1.18.30及以上
• 检查IDEA的Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler，确保使用的编译器是javac而不是ECJ
• 确保IDEA安装了Lombok插件，而且该插件处于启用状态

最好三件事一起做，基本不会再遇到这个报错。

4.2 “源发行版17需要目标发行版17”与Spring Boot版本过高的连锁反应

这个报错非常经典：

code复制java: 警告: 源发行版 17 需要目标发行版 17

出现这个问题的原因是项目通过pom.xml或Maven配置了Java 17的编译级别，但本地JDK实际是8或11，IDEA的Project Structure里设置的JDK版本也不匹配。解决办法是在IDE中统一三处地方：

• File -> Project Structure -> Project：设置SDK为本地JDK
• File -> Project Structure -> Modules：确保模块的语言级别（Language Level）匹配
• Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler：设置目标字节码版本

这个报错之所以和Spring Boot版本关联紧密，是因为最新版的Spring Boot 3.x本身就要求JDK 17。很多同学从网上复制了一份Spring Boot 3.x项目的pom.xml，本地却还是JDK 8，结果一连串报错。我的建议非常明确：如果本地是JDK 8，老老实实用Spring Boot 2.7.x，别去追新；如果一定要用Spring Boot 3.x，那就先装好JDK 17，同时还要注意Spring Boot 3.x的包名从javax变成了jakarta，代码里的import javax.servlet.*都要跟着改。对毕设来说，引进新版本带来的麻烦远大于收益。

4.3 MyBatis-Plus的mapper扫描问题

使用MyBatis-Plus时，如果启动后提示Invalid bound statement (not found)，基本是Mapper接口和XML文件没有正确绑定。排查方向有这几个：

• 启动类上是否加了@MapperScan("com.example.mapper")注解
• Mapper接口是否有@Mapper注解
• XML文件的namespace是否和接口全限定名一致
• XML文件的存放位置是否在resources/mapper下，以及application.yml中的mybatis-plus.mapper-locations是否配置正确

yaml复制mybatis-plus:
  mapper-locations: classpath*:mapper/**/*.xml
  type-aliases-package: com.example.entity

这四步检查一遍，99%的“找不到语句”问题都能解决。

4.4 前端跨域请求失败

前后端分离模式下，前端在localhost:8081，后端在localhost:8080，直接发请求必然触发跨域问题。浏览器控制台会提示CORS policy相关错误，或者请求状态是blocked。

后端解决跨域有好几种方式，最简单的是写一个配置类实现WebMvcConfigurer接口：

java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOriginPatterns("*")
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
                .allowedHeaders("*")
                .allowCredentials(true)
                .maxAge(3600);
    }
}

注意allowCredentials(true)和allowedOriginPatterns("*")要搭配使用，用allowedOrigins("*")会冲突。另外如果项目里加了Spring Security，跨域配置还要和Security的过滤器链配合，否则请求会被拦在Security层。

4.5 打包部署阶段的坑

有些同学本地跑通了，还想打包成Jar部署到服务器上，这里很容易踩到静态资源路径问题。Spring Boot打包后是Jar包结构，静态资源不再以文件系统路径存在。如果代码中出现了new File("src/main/resources/xxx")这类硬编码路径，打包后必然报文件找不到。正确做法是使用ClassPathResource或者ResourceUtils来加载资源。

另外打包时如果执行mvn package后提示测试失败，可以先跳过测试：

bash复制mvn clean package -DskipTests

打包完成后，java -jar target/xxxxx.jar就能启动整个后端服务。注意如果服务器上MySQL的编码不是UTF-8，数据写入中文会变乱码，部署前记得把MySQL的character-set-server设为utf8mb4。

5. 让项目更出彩：答辩加分项与功能扩展方向

5.1 答辩时怎么把项目讲出深度

答辩时间通常只有5到10分钟，老师不可能逐行看代码，但会通过几个关键问题判断项目是不是你自己做的、有没有理解到位。我建议你提前准备好下面这几个问题的答案：

• “你这个项目的核心业务流程是什么？”——顺着状态机讲，从学生提交到维修完成，教师一听就知道你懂业务。
• “项目的权限是如何控制的？”——说明登录拦截、接口鉴权和数据隔离，重点讲怎么防止学生越权访问别人的工单。
• “遇到过什么难点？如何解决的？”——随便挑一个真实踩过的坑，比如数据库时区报错、跨域配置、Lombok版本不兼容，讲清楚报错信息和排查过程，这是最能证明实操能力的地方。
• “如果用户量大了怎么办？”——可以说引入Redis做缓存、加消息队列做异步通知、用Nginx做负载均衡。不一定真做，但要有思路。

此外，Spring Boot自动装配原理几乎是必问题。建议提前理解一下：@SpringBootApplication是由@SpringBootConfiguration、@EnableAutoConfiguration和@ComponentScan组合而来的，自动装配的核心是spring.factories文件中配置的AutoConfiguration类，通过条件注解（如@ConditionalOnClass、@ConditionalOnMissingBean）按需加载。哪怕只是把这个机制讲清楚，都能让老师高看一眼。

5.2 三个低成本高价值的改进方向

如果时间宽裕，想在功能上再加分，可以从下面三个方向里选一个做，成本不高，效果很明显。

第一是增加通知提醒功能，报修被受理、派单、维修完成时，发短信或邮件提醒学生。实际做的时候可以先用Spring Mail发送邮件，成本最低，效果也不错。

第二是增加统计分析报表，管理员端用ECharts展示报修趋势、维修工处理量排行、报修类型分布等。这类图表功能在答辩中非常显眼，技术上也不难，后端提供一个聚合查询接口，前端用ECharts渲染即可。

第三是增加微信小程序端，学生用手机就能随时提交报修、查看进度。技术栈上小程序端用原生或uni-app，后端复用现有接口，工作量约一周左右。这个扩展看起来不多，但如果毕设要求“系统有移动端入口”，能直接覆盖加分点。

5.3 关于“定制开发”和“文档讲解”的几点提示

如果是在网上购买的源码，通常卖家会附带源码、数据库脚本、说明文档以及推荐讲解教程。这里有一个很重要的判断标准：拿到源码后，你能否不看教程，自己照着文档把项目跑起来？

如果跑不起来，大概率是环境不匹配或者数据库脚本不完整。先检查文档中声明的JDK、Maven、Spring Boot版本和本地是否一致；其次确认数据库初始化脚本的编码格式，很多脚本是UTF-8编码，但用Navicat导入时Windows默认GBK，导致数据乱码；再留意项目是否包含前端代码，如果只有后端，还要单独部署Vue或静态页面。

至于文档这一块，记住一个原则：文档的价值在于“过程记录”而不只是“结果描述”。不要只写“实现了某某功能”，要写上“为什么这样设计”“遇到了什么问题”“怎么解决的”。答辩老师最认这种东西。如果你买的文档这部分写得太薄，一定要自己补，否则答辩会露馅。

关于调试运行中的问题，不管是什么问题，先看控制台完整报错堆栈的第一行，别盯着中间几行看“Caused by”的部分更是重点排查对象。定位问题本身比到处复制粘贴答案更重要。我见过太多同学看到报错就直接搜索，结果把项目越改越乱，最后连个错在哪个模块都说不清楚。能自己通过日志定位并解决一个问题，比写完十个功能更有价值。

写在最后

宿舍报修维护系统这个题目，虽然看起来平平无奇，但它的业务闭环完整、角色划分清晰、扩展空间也足够，用来做Java毕设其实是非常划算的选择。只要抓住两条主线——工单状态流转和用户权限控制，项目的骨架就不会塌。

我个人在实际调试这类项目时最深的一点体会是：源码只是起点，真正让你成长的是从“跑不起来”到“跑通了再到“能给别人讲明白”这个过程。遇到一个报错，就多花十分钟去搜索和思考它为什么出现，远比下一次遇到同样问题再花两小时找答案要高效得多。

最后再分享一个小技巧：项目跑通之后，马上用mysqldump导出一份数据备份，然后去application.yml里改一次数据库密码，再启动一次。这种“故意制造错误再修复”的训练，能让你迅速熟悉这个项目的常见故障点。等真正到了答辩现场，老师问什么你都不慌，因为你已经亲手踩过一遍坑了。