企业官网建设流程全解析

毕设选题从来是个玄学。选太简单的，答辩时被老师问两句就露馅；选太复杂的，从开学写到盲审都未必能跑通。我见过太多人倒在“智慧校园”“人脸识别考勤”这种大坑里，也见过有人抱着“图书管理系统”交上去被批工作量不足。如果你正在Java方向纠结，我真心建议认真考虑一下学生宿舍管理系统——这个业务场景足够完整，技术点覆盖得恰到好处，工作量可控、演示效果好，而且源码逻辑清晰，改造成本低。我的这套基于Spring Boot的实现，已经帮几个学弟学妹顺利过了答辩，现在把完整的设计思路、核心实现和踩坑记录都放出来，供你直接参考。

坦白说，宿舍管理系统这个课题被做烂了，网上随便一搜都有大把源码。但“有源码”和“能答辩”完全是两回事。很多下载下来的项目要么跑不起来，要么代码结构乱成一团，要么技术栈老得像是2015年的古董。我这套项目虽然是免费分享的，但代码结构、注释规范、权限设计都是按工程标准来的，不只是能跑，而是能讲清楚、能改、能扩展。不管你是准备直接拿来交差，还是想二次开发加点功能，这篇博文都会对你很有帮助。

1. 整体设计与技术选型拆解

1.1 为什么宿舍管理系统适合做Spring Boot毕设

先说业务侧。宿舍管理系统的功能边界非常清晰，核心就是“人”和“房间”的关系维护，外加报修、水电、访客这些辅助模块。这种复杂度对毕设来说刚刚好：既不会简单到只有一张表CRUD撑不起工作量，又不会复杂到需要分布式、消息队列这种重型组件才能落地。

再说技术侧。这个系统天然适合展示Java Web开发的核心技能栈：Spring Boot负责业务层，MyBatis或者MyBatis-Plus负责持久层，MySQL存数据，前端可以用Vue做前后端分离，也可以用Thymeleaf做服务端渲染。你还顺势能讲清楚RESTful API设计、统一异常处理、权限控制、分页查询这些高频面试考点。

最关键的一点是，宿舍管理系统有一个其他选题没有的优势——数据模型直观。学生、宿舍楼、房间、入住记录、报修单、水电费单，这些实体之间的关联关系，哪怕是没写过几行代码的人也能看懂。答辩时老师问起表结构设计，你能三句话讲明白为什么要这样建表，这在“讲项目”环节特别加分。

1.2 技术栈选型的几条硬经验

选型这事，我踩过一次很深的坑，必须提醒你。我一开始用的是Spring Boot 3.0，JDK 17，结果MyBatis-Plus的某些旧版本不兼容，报错报得头大。后来老老实实换成了Spring Boot 2.7.12 + JDK 1.8的组合，所有依赖全部锁定版本，项目一次跑通。

如果你的机器装的是IDEA，建议直接用Spring Initializr生成基础工程，依赖有这些就够了：

<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.33</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>

关于ORM框架，我推荐你直接用MyBatis-Plus。原因很简单：单表CRUD完全不需要手写SQL，BaseMapper接口自带selectById、insert、updateById这些方法，分页插件一配自动拼LIMIT。这样你能把精力放在业务逻辑上，而不是一遍一遍重复写SELECT * FROM student WHERE id = ?这种毫无营养的SQL。当然，答辩时老师可能会问“你SQL写得好不好”，所以联表查询这类复杂SQL建议手写，放在XML文件里，展示的时候能讲出更多内容。

前端这块，如果不想折腾Node环境和Vite构建，用Thymeleaf加Bootstrap就能做出一套能看的界面。想显得更专业一点，就上Vue 2 + Element UI + Axios，前后端完全分离，部署时把前端打包成静态资源丢到Spring Boot的static目录下，效果挺好，演示也不会有跨域问题。

2. 功能模块与数据库设计思路

2.1 业务模块怎么拆，怎么讲才不虚

我见过太多人做毕设时把功能堆得满满当当，实际上都是多余的。宿舍管理系统真正的核心功能，掰着手指头数就这么几个：

• 学生管理：学生的增删改查，支持按学号、姓名、院系模糊查询，导入Excel批量录入。
• 宿舍分配与调换：新生入住分配房间、学生申请调换宿舍、退宿登记。这是系统的灵魂功能，分配逻辑要能讲清楚。
• 宿舍楼与房间管理：维护楼栋信息、房间床位总数、已住人数、空床位数。
• 水电费管理：每个月录入每间宿舍的水电用量，自动计算费用，状态标记已缴未缴。
• 报修管理：学生提交报修单，宿管接单处理，状态流转：待处理→处理中→已完成。
• 访客登记：访客来访信息登记和查询。
• 公告管理：管理员发公告，学生端查看。

权限设计我建议做成三个角色：系统管理员拥有全部权限；宿管员能处理报修、录入水电费、管理学生信息但不能动系统配置；学生只能看自己的信息、提交报修、查自己的水电账单。用一张角色表再加一张用户角色关联表就够了，不要图新鲜引入Spring Security那套复杂的东西，毕设阶段用一个简单的拦截器加注解鉴权完全够用。

2.2 数据库表的数量和关联，体现设计功底

建表的第一步，先想清楚你要讲什么故事。我的建议是建这几张核心表：sys_user（用户）、sys_role（角色）、student（学生）、building（宿舍楼）、dormitory（房间）、bed_assignment（床位分配记录）、repair_order（报修单）、utility_bill（水电账单）、visit_record（访客记录）、notice（公告）。

其中最容易讲出亮点的是bed_assignment这张表。很多人的设计是直接在student表里加一个dorm_id字段，这样确实简单，但学生换宿舍时历史记录就丢了。我的做法是单独建一张分配记录表，字段包含student_id、dorm_id、bed_no、status（0已迁出、1在住）、assign_time和leave_time。这样你既能查出当前谁在住，也能查出一个学生住过哪些宿舍，答辩时这个设计的理由足够你讲上三分钟。

再说dormitory表的字段设计。除了building_id和room_no，一定要冗余两个字段：total_beds和occupied_beds。为什么不每次都COUNT床位分配记录？因为宿舍列表页要显示空床位数，如果每次都去联表统计数据量大时性能会明显变差。冗余字段配合UPDATE时同步维护，以空间换时间，这个思路放在任何系统里都站得住脚。

下面是建表的精简示例，你可以直接参考：

CREATE TABLE `dormitory` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `building_id` bigint(20) NOT NULL COMMENT '所属楼栋ID', `room_no` varchar(20) NOT NULL COMMENT '房间号', `total_beds` int(11) NOT NULL DEFAULT 4 COMMENT '总床位数', `occupied_beds` int(11) NOT NULL DEFAULT 0 COMMENT '已住人数', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_building_room` (`building_id`, `room_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='宿舍房间表';

注意UNIQUE KEY这里非常关键。同一栋楼里房间号不能重复，如果不建唯一索引，高并发情况下可能会出现两条重复的房间数据。虽然毕设一般不谈高并发，但这种细节体现了设计素养，写在文档里就是亮点。

2.3 分配宿舍的逻辑，别一句话带过

宿舍分配是系统的核心业务，也是答辩时最容易追问的地方。我的实现逻辑是这样：管理员选择楼栋和性别后，系统查询该楼栋下所有满足条件的房间（先查性别匹配——男生只能分男寝，女生只能分女寝，这是硬约束），然后按占用比例从低到高排序，自动分配一个空床位；也可以手动指定某个房间的某张床。

public Result assignDormitory(Long studentId, Long buildingId, String gender) { // 1. 校验学生是否存在且未分配宿舍 Student student = studentMapper.selectById(studentId); if (student == null || student.getDormitoryId() != null) { return Result.error("学生不存在或已分配宿舍"); } // 2. 查询该楼栋所有未满且性别匹配的房间 LambdaQueryWrapper<Dormitory> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Dormitory::getBuildingId, buildingId) .eq(Dormitory::getGender, gender) .apply("occupied_beds < total_beds") .orderByAsc(Dormitory::getOccupiedBeds); Dormitory target = dormitoryMapper.selectOne(wrapper); if (target == null) { return Result.error("该楼栋暂无空床位"); } // 3. 更新房间占用数 target.setOccupiedBeds(target.getOccupiedBeds() + 1); dormitoryMapper.updateById(target); // 4. 更新学生的宿舍信息 student.setDormitoryId(target.getId()); studentMapper.updateById(student); // 5. 写入床位分配记录 BedAssignment assignment = new BedAssignment(); assignment.setStudentId(studentId); assignment.setDormId(target.getId()); assignment.setStatus(0); bedAssignmentMapper.insert(assignment); return Result.success("分配成功"); }

这段逻辑里要注意一件事：房间分配完成后，必须更新occupied_beds和写入分配记录，这两步最好放在一个事务里。如果有一步成功而另一步失败，数据就会不一致。我一开始就没加@Transactional，测试时手动制造了一次异常，结果房间显示住了两个人，实际记录里只有一个，排查了半天。

3. 搭建部署与核心代码实现

3.1 从零到跑通的完整流程

第一步当然是把数据库建好。在Navicat或者MySQL命令行里执行建库语句，然后把所有建表SQL一次性跑完。在这里提醒一个特别蠢的坑：MySQL 8.x默认的认证插件是caching_sha2_password，而你的JDBC驱动如果版本太低，连接时会报Public Key Retrieval is not allowed。解决办法有两个，要么用8.0以上的驱动，要么在JDBC URL后面加上allowPublicKeyRetrieval=true&useSSL=false。两个都做了最稳。

然后是工程配置，application.yml这样写：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/dormitory_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0

map-underscore-to-camel-case: true这句意味着数据库字段create_time能自动映射到Java里的createTime，不用手动写一堆@TableField注解。物理删除改逻辑删除是个好习惯，数据不丢，追查有据，答辩也可以提一嘴。

配置完之后，分页插件也要注册一下，否则用MyBatis-Plus的Page对象查数据时不会自动LIMIT：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

3.2 项目结构怎么组织才像工程，而不是包一堆散文件

项目结构我建议按Controller → Service → Mapper → Entity四层来分包，这是Spring Boot最经典也最稳妥的组织方式。不要学着网上的教程做那种controller里写SQL、service层空壳的设计，代码评审时会被老师一眼看穿。

我的目录结构大概是这样的：

src/main/java/com/example/dormitory ├── controller // 接收请求，参数校验 │ ├── StudentController.java │ ├── DormitoryController.java │ ├── RepairController.java │ └── AuthController.java ├── service // 业务逻辑层 │ ├── impl │ │ ├── StudentServiceImpl.java │ │ └── ... ├── mapper // MyBatis-Plus Mapper接口 │ ├── StudentMapper.java │ └── ... ├── entity // 数据库实体类 │ ├── Student.java │ └── ... ├── common // 公共类：统一返回结果、全局异常处理 │ ├── Result.java │ └── GlobalExceptionHandler.java └── config // 配置类 ├── MybatisPlusConfig.java └── WebConfig.java

写Controller的时候有几个小习惯很加分。第一个，所有接口返回统一结构的Result对象，不要直接返回实体类裸数据。比如登录成功返回Result.success(token)，失败返回Result.error("用户名密码错误")。这样前端Axios拦截器可以统一处理状态码。第二个，入参尽量用@RequestBody接收POST请求的JSON，GET请求用@RequestParam或者一个Query对象接收，不要懒到用Map。第三个，状态变更类接口用PUT或POST，查询用GET，路径命名为/api/v1/students、/api/v1/dormitories/{id}这种符合REST风格的路由。

3.3 登录鉴权与当前登录用户的获取

登录鉴权是毕设里绕不开的一环。虽然可以用Session，但在前后端分离的项目里Session天然有跨域问题，所以我用了JWT。结构非常简单：用户通过账号密码登录成功后，生成一个包含用户ID和角色的Token返回给前端，前端在请求头加上Authorization: Bearer <token>，后端用一个拦截器解析Token并设置到ThreadLocal里。

@Component public class JwtInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口 if (request.getRequestURI().contains("/api/auth/login")) { return true; } String token = request.getHeader("Authorization"); if (token == null || !token.startsWith("Bearer ")) { response.setStatus(401); return false; } try { Claims claims = Jwts.parser() .setSigningKey("your-secret-key") .parseClaimsJws(token.replace("Bearer ", "")) .getBody(); request.setAttribute("userId", claims.get("userId")); request.setAttribute("role", claims.get("role")); return true; } catch (Exception e) { response.setStatus(401); return false; } } }

这个拦截器在WebConfig里注册，指定拦截路径。这里有几个坑要提醒：不要把JWT密钥硬编码在代码里，虽然毕设无所谓，但写配置里是好习惯；** Token过期时间不要太长也不要太短**，我设置的是24小时，学生第二天再登录时过期重登一次，体验还行。

3.4 报表统计，答辩时的高光时刻

直白说，CRUD功能人人会写，但“统计报表”能让老师眼前一亮。宿舍管理系统里做统计逻辑很简单：统计每栋楼的入住率，统计各院系学生人数分布，统计每月水电费用趋势。用MyBatis-Plus写一条带GROUP BY的自定义SQL就行。

<select id="countByBuilding" resultType="map"> SELECT b.name AS buildingName, COUNT(DISTINCT d.id) AS dormitoryCount, SUM(d.occupied_beds) AS occupiedBeds, SUM(d.total_beds) AS totalBeds FROM building b LEFT JOIN dormitory d ON b.id = d.building_id GROUP BY b.id, b.name </select>

查询结果直接返回List

4. 常见问题与排查技巧实录

4.1 环境依赖的坑，看了能省三小时

先说Maven依赖问题。很多同学从仓库拉项目下来，在IDEA里一刷新，直接一堆标红。最常见的是spring-boot-maven-plugin版本和当前的Spring Boot版本对不上，或者是MyBatis-Plus版本过新，用了JDK 8不支持的新特性。我的建议是：无论来源是哪儿的项目，拿到手先统一改三项——JDK版本设为1.8、Spring Boot版本设为2.7.x、MyBatis-Plus版本设为3.5.3。这组合我跑过十几次，极少出幺蛾子。

再说端口冲突。8080端口被占用这种报错，基本是上一个项目的进程没关干净。Windows上执行netstat -ano | findstr 8080，拿到PID后用taskkill /F /PID <pid>杀掉即可。Mac或Linux上就用lsof -i :8080。

4.2 数据库连接和中文乱码的集中爆发

数据库连不上，八成是三类原因。第一，MySQL服务没启动，去服务管理里启动一下；第二，密码错了或者URL里serverTimezone没设置，导致时间戳报错；第三，驱动没加载，pom.xml里的依赖没有正确引入。

中文字符串乱码，几乎所有做毕设的人都遇到过。最常见的根源有三处：数据库表用了latin1而不是utf8mb4，JDBC URL少写了characterEncoding=utf8，以及前端页面没有设置<meta charset="UTF-8">。排查顺序就是：先看MySQL表编码，再查连接串，最后看前端。按照这个顺序，基本十分钟内解决。

4.3 答辩前后最容易翻车的几个点

作为一个经历过两次毕设指导、看了无数答辩现场的老司机，我总结出以下几个高频翻车点。

第一个问题，项目说不清楚。不少同学代码跑通了，但问起“你这个系统的角色权限是怎么设计的”就支支吾吾。我的建议是，把核心表结构和几条关键业务流程背熟，尤其是宿舍分配、报修状态流转。项目演示时主动按业务流程来走一遍，不要东点一个西点一个。

第二个问题，代码不是自己写的，一问就露馅。有些同学拿了别人的源码，连改了哪些地方都不知道。至少要自己重写Service层的几个核心方法，哪怕逻辑一样，也要自己敲一遍，这样在讲的时候才讲得出来细节。

第三个问题，测试数据太假。我见过有人数据库里的学生名字全是“张三1”“张三2”，日期千篇一律。建议用脚本批量生成一些真实感强的名字和日期范围，再构造几条有价值的业务数据，比如某个宿舍连续三个月水电费递增，这将是你报表功能的事故现场素材。

5. 扩展方向与二次开发建议

5.1 加一些低成本高回报的功能

如果你时间充裕，想在这个基础上做得更出彩，有几个功能性价比极高。

消息通知：学生提交报修后，给宿管发一条通知。这个功能不用引入消息队列，数据库建一张notification表，管理员登录后在顶栏显示未读数量即可。

批量导入导出：用EasyExcel或Apache POI做学生的Excel导入导出。这属于办公自动化场景的经典需求，写入功能点后简历上也能写一笔。

图形化统计：引入ECharts，把水电费趋势、楼栋入住率做成图表。这个前面提过，强烈建议做，因为演示效果真的立竿见影。

宿舍卫生评分：宿管每周对宿舍打分，学生可以查分。这个功能几乎没有额外技术成本，但能让业务故事更完整——从“管人”延伸到了“管宿舍环境”。

5.2 代码上线前的清单自查

项目完成后，不要急着提交，按下面这个清单过一遍：

• application.yml里数据库密码是否改好，是否留有本地测试的配置。
• JWT密钥是否从代码中抽离到配置中。
• 所有接口是否做了参数校验，还是能随便传一个负数当宿舍ID。
• 前端页面加载是否有明显的404资源路径。
• 数据库里是否补充了足够多的演示数据。
• README里是否写清楚了启动步骤和默认账号密码。

这里多说一句，README一定要认真写。大学老师看项目时大概率先打开README，里面的启动说明写得清楚，第一时间印象分会高不少。

6. 一些掏心窝的总结

做这个宿舍管理系统，前后用了我大概两周的业余时间。刚开始我也是从网上扒代码开始看，但很快就发现，光看别人写好的代码根本记不住。后来我强制自己不看源码去重写Controller层，写不出来就翻文档，翻完继续写，一来二去整套逻辑就烂熟于心了。毕设这件事，技术难度是一回事，你自己动手的程度是另一回事。我刚带过一个学弟，他就是照着这份源码把每个Service方法自己重新敲了一遍，答辩当天老师问什么他都能接上话，最后拿了优秀。

还有一点要说的就是，这套源码虽然免费，但你不是拿来就能“完全不动”的。至少要改三个地方：项目名、包名、数据库名。这三个标识不改，一旦被查重系统查出和其他人提交的源码相似度超过阈值，就算是你自己写的，也容易被误判。改包名在IDEA里选中根包Refactor重命名就行，改项目名就是改pom.xml里的artifactId和最终的JAR包名。

最后再分享一个答辩演示的小技巧。不要一上台就开始演示代码，口头表述低调点说“基于Spring Boot和MyBatis-Plus实现的宿舍管理系统”，然后先从“角色登录”开始讲业务流程：管理员登录后怎么录学生、分宿舍、录水电费，学生端怎么登录、报修、查账单。整个过程按业务场景来走，而不是按菜单一个个点。这样答辩老师听到的是一个完整的故事，而不是一堆功能点的堆砌。等老师开始追问细节时，你刚才脑子里过了一遍的表结构和业务逻辑，就能稳稳地接住问题了。

个人建议，做毕设别只为了过，既然已经花了几个月，不如顺便把这套代码理解透。毕业以后面试Java岗位，面试官大概率会问“你最近做过什么项目”，你这时能自信地说出宿舍管理系统的设计思路，那份淡定从容，比简历上任何一行字都更值钱。