每年三四月份教务处的微信消息基本就被各种Excel表格刷屏交题目汇总表、收学生选题表、统计开题报告提交情况、排答辩分组。我用Spring Boot做了一套毕业设计管理系统内部立项编号11374最初就是为了解决这个混乱。系统覆盖学生、教师、教学秘书三类核心角色把选题、开题、中期、论文提交、答辩评分整条流程全部串了起来。所有环节的状态实时可查材料统一归档成绩自动折算再也用不着到处收集表格。这篇文章不打算只讲CRUD怎么写而是把从需求分析、技术选型、数据库设计、核心模块实现到实际开发踩坑、答辩演示准备的完整过程都拉出来复盘一遍。准备用Spring Boot做毕设或者做教务管理类项目的同学可以拿这篇当一个端到端参考少走不少弯路。1. 毕设系统11374的定位教学管理的真实痛点1.1 毕业设计流程中的角色与业务节点先看毕业设计这件事到底涉及到多少人、多少环节。很多人一开始就把系统想简单了觉得无非是学生传论文老师打分数但实际跑一遍流程会发现参与方至少是四类学生浏览课题、提交选题意愿、上传开题报告、中期检查表、论文定稿查看成绩。指导教师发布课题、审核学生选题、审阅各阶段材料、给出修改意见和评语。专业负责人审核教师发布的课题是否合规监控专业内选题完成率。教学秘书/管理员维护学年学期参数、导入学生名单、编排答辩组、录入最终成绩、导出各类统计报表。如果只做一个论文上传的功能那系统根本没有解决任何核心矛盾。11374项目的重点不在材料本身而在流程。出题、审核、选题、确认、开题、中期、论文评阅、答辩、归档每个环节之间都是强依赖关系学生没选题成功就不能交开题报告教师没审核通过就不能进入下一阶段。用Excel管这套流程的痛处我列在下面这张表里。角色常见痛点系统对应能力学生不知道选题结果是否被确定、材料交到谁手里选题状态实时查看材料提交有截止时间提醒教师邮箱微信收材料版本混乱漏看消息统一待办中心按阶段审阅材料并留痕专业负责人题目质量没法把关重复选题多题目审核环节按专业维度统计教学秘书汇总表格耗时答辩分组费劲成绩核算易错自动分组成绩自动按权重折算并支持导出1.2 功能边界毕设系统不能什么都做需求阶段往往是最容易失控的。11374的第一版需求清单有57条我最后砍到了不到30条。砍掉的标准就两条第一这件事用Excel勉强能应付又不强制留痕的不做第二跟毕业设计主流程无关的锦上添花功能不做。比如有人提过要做站内即时聊天、要做在线文档多人协同编辑这些虽然听起来唬人但既偏离流程管理这个核心又会把开发周期拖到答辩前夜。系统真正的核心是三个词流程、状态、归档。流程指节点必须按顺序推进状态指任何一条数据在任何时刻都能说清楚走到哪一步了归档指每个环节的材料都有统一存储位置不用再翻聊天记录。把边界划清楚之后开发才可能聚焦。1.3 核心功能模块总览11374最终落地的功能模块可以分成六块用户与权限模块学生、教师、专业负责人、管理员四种角色登录后显示各自的待办看板。课题管理模块教师发布课题、填写题目描述/要求/人数上限专业负责人审核。选题与流程模块学生提交选题志愿教师确认或驳回系统维护整个状态机。材料提交模块开题报告、中期检查、论文定稿按阶段上传超过截止时间自动锁定。答辩与评分模块教学秘书编排答辩组和场次答辩组长录入答辩分系统自动折算总分。统计与导出模块按专业、班级、导师统计进度一键导出Excel成绩表和选题名单。这套模块设计本身不复杂但每一步业务状态怎么流转、数据怎么落库才是真正决定项目质量的地方。2. 技术选型复盘为什么是Spring Boot加Vue前后端分离2.1 Spring Boot为什么是毕业设计系统首选11374后端选Spring Boot核心考虑不是流行而是三个实际原因。第一自动装配把配置成本压到了极低。传统SSH时代写一个数据源要配一堆XMLSpring Boot用起步依赖加约定优于配置的方式一个spring-boot-starter-web就把MVC、内嵌Tomcat、JSON序列化全部带进来了。EnableAutoConfiguration会读取META-INF/spring.factories或AutoConfiguration.imports里的自动配置类再通过ConditionalOnClass、ConditionalOnMissingBean这类条件注解按需生效。开发时你只管加依赖、写配置剩下的交给框架。第二生态成熟踩坑成本低。MyBatis-Plus、Redis、EasyExcel、MinIO这些常用的组件都有Spring Boot官方或社区starter版本兼容问题提前被过滤了一遍。对学生来说遇到问题随手搜一下基本都能找到方案这一点对毕业设计尤其重要——你不可能花大量时间在冷门框架的底层排查上。第三答辩场景的现实考量。Spring Boot是当前教学和市面上用得最广的Java框架答辩老师即便自己不写也大概率能看懂项目结构。选择技术栈有时候不光是技术问题也是沟通问题。对比项SSHSSMSpring Boot配置方式大量XMLXML注解混用注解为主自动配置部署需要外置Tomcat外置Tomcat内嵌容器jar直接跑学习曲线陡峭中等平缓社区资料量少一般极多2.2 ORM选型MyBatis-Plus而不是JPAORM层我用了MyBatis-Plus没有用Spring Data JPA。不是说JPA不好是在毕业设计这个场景下MyBatis-Plus更合适。MyBatis-Plus的优点很直接BaseMapper自带增删改查单表CRUD一行都不写SQL分页有内置插件动态SQL用Select注解或者XML都能写复杂的多表关联查询完全可控。JPA的Entity映射和派生查询确实省事但一旦遇到动态条件多的统计报表要么写Query大段JPQL要么就要小心N1查询问题。对经验不那么多的人来说SQL可控意味着出问题的时候你能肉眼排查。实践下来11374项目里80%的查询都是单表条件查询MyBatis-Plus的QueryWrapper足够对付剩下的多表统计用XML手写SQL也没花多少时间。唯一要注意的是QueryWrapper这种链式条件多了之后代码会变得很散建议复杂条件统一封装到Mapper的XML里service层只做业务编排。2.3 辅助组件Redis、MinIO、EasyExcel各管什么Redis负责登录验证码、数据字典、以及热门课题的访问计数。这些数据特点是读取频繁、允许偶尔延迟放数据库也能跑但放Redis里响应快得多也顺便演示了缓存的用法。MinIO负责论文PDF、开题报告、中期检查表这些文件对象。之所以不用服务器本地目录是因为本地文件在打包部署、容器重启时很容易丢失而且不便统一管理权限。MinIO走S3协议内网部署一套非常轻量。EasyExcel负责导出选题名单、成绩汇总表。ExcelProperty注解配一个实体类就能导出避免用POI手动写单元格样式代码量能省一个量级。2.4 前后端分离模式下的跨域问题前端选了Vue 3加Element Plus打包后由Nginx托管后端独立部署访问通过/api前缀转发。开发环境下前端跑在8080端口后端跑在8081端口必然要处理跨域。最简单的方式是在后端写一个全局CorsFilter注意前端如果用了withCredentials: true这和后端允许的origin不能写成*。下面这段配置是11374项目里实际使用的Configuration public class CorsConfig { Bean public CorsFilter corsFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOrigin(http://localhost:8080); config.addAllowedMethod(*); config.addAllowedHeader(*); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); } }等部署到线上之后前端页面和后端接口都走同一个域名Nginx把/api反向代理到后端生产环境其实就不再依赖这个Filter了。所以建议开发环境和生产环境分开配置生产用Nginx代理顺带把跨域问题一并消掉。3. 从空项目到可运行骨架的搭建细节3.1 版本选择Spring Boot 2.7还是3.x开发环境用IDEAJDK版本1.8Spring Boot选了2.7.x没有上3.x。选择理由很实际Spring Boot 3必须JDK 17起步虽然新特性多但MyBatis-Plus、Knife4j这类组件在老版本上兼容性更稳网上能查到的资料也绝大多数基于2.x。对毕业设计来说稳远比新重要。如果非要折腾3.x光javax.*到jakarta.*的命名空间迁移就够喝一壶的没必要在答辩前给自己找事。IDEA新建项目时依赖只需要勾四个起步Spring WebMySQL DriverLombokSpring Boot DevToolsMyBatis-Plus、Redis、MinIO的依赖后面在pom.xml里手工加版本号统一用dependencyManagement管理避免传递依赖打架。3.2 分包结构与命名规范包结构直接决定了后台上手速度。11374的分包如下com.campus.grad ├── common // Result统一返回、全局异常、工具类 ├── config // CorsConfig、RedisConfig、MybatisPlusConfig ├── controller // 接口层 ├── service // 业务层接口Impl ├── mapper // MyBatis-Plus Mapper接口 ├── entity // 数据库实体 ├── dto // 接收前端参数的对象 └── vo // 返回前端视图的对象有一个经验值得分享参数校验要放在service层而不是controller层。controller保持轻薄只负责参数绑定和结果返回业务规则比如学生只能选三个志愿这种必须放在service里校验否则将来加一个定时任务或者管理员代操作很容易绕过校验逻辑。3.3 application.yml中容易出错的配置项application.yml是整个项目配置的重灾区我把11374里踩过的关键配置贴出来server: port: 8081 spring: datasource: url: jdbc:mysql://localhost:3306/grad_system?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 servlet: multipart: max-file-size: 50MB max-request-size: 100MB mybatis-plus: mapper-locations: classpath:/mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl knife4j: enable: true几个坑提前说。MySQL连接串里必须带serverTimezoneAsia/Shanghai否则默认时区导致时间字段差8小时。allowPublicKeyRetrievaltrue是MySQL 8.x连接时经常遇到的坑不加上去会报Public Key Retrieval错误。文件上传大小限制要按实际需求调默认只有1MB论文PDF动不动几十MB不配好就直接报MaxUploadSizeExceededException。3.4 数据库核心表设计与选题状态机11374的数据库叫grad_system核心表不多但所有业务都围着它们转sys_user用户表角色字段区分学生/教师/专业负责人/管理员。topic课题表关联教师ID、专业、人数上限、当前已选人数、审核状态。topic_selection选题记录表关联学生ID、课题ID、志愿顺序、审核进度。process_report过程材料表阶段类型开题/中期/论文定稿文件地址、审核意见。defense_group答辩组表关联成员、地点、时间段。score_record评分表记录各环节得分、教师评语。最核心的设计是选题状态机。课题本身有四种状态0草稿、1待审核、2审核通过、3已驳回。选题记录有三种状态0待教师确认、1已通过、2已拒绝。我没有用字符串存状态统一用int再在代码里定义一个枚举类。字符串状态最大的问题是随心所欲你永远想不到后来的人会填一个Passed还是一个已通过用枚举收敛之后就安全得多了。表之间也没有到处用外键只有逻辑关联。原因很简单毕业设计系统数据量不大外键的强一致性在这里意义有限反而会给导入数据、定时清理增加麻烦。学生名单每年要重新导入如果没按顺序插数据外键约束会让人抓狂。4. 核心业务实现选题、流程流转与文件归档的落地4.1 选题并发冲突多个学生同时抢一个课题选题开放那天晚上才是系统真正接受考验的时候。学生不会平均分散在一天里操作基本集中在晚上十点到十二点。热门课题名额八个可能一下子涌进来二十个人同时选。如果直接select判断人数再insert并发情况下必然超卖。我用的是条件更新方案。选题表topic上维护一个selected_count和max_count学生选题时执行下面这条SQLUPDATE topic SET selected_count selected_count 1 WHERE id #{topicId} AND selected_count max_count影响行数为1说明抢到名额为0说明已经满员。这一步操作在数据库层面是原子的不需要锁和事务配合就能解决超卖问题。配合topic_selection表的student_id topic_id唯一索引保证一个学生不能对同一个课题重复提交整个并发问题就收住了。4.2 权限控制与状态流转四种角色的接口权限我用了一个自定义注解加拦截器实现没有引入Spring Security。毕业设计的权限模型简单用Spring Security配置一大堆过滤链反而重自定义拦截器三行就能搞定。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface RequireRole { String[] value(); }在拦截器里取当前登录用户的角色判断是否在注解允许的范围内。状态流转的合法性校验放service层统一处理比如选题确认方法里先判断topic_selection.status是否为0不是就抛业务异常。核心原则是所有修改状态的入口都走同一个service方法绝不允许多个地方都能随意改状态否则状态机很快就会烂成一团。4.3 文件上传与MinIO对象存储论文和过程材料走MinIO。后端封装了一个FileStorageService对外只暴露upload和presignedUrl两个方法上传时生成UUID文件名避免中文名和重名导致的路径混乱文件原始信息单独存到数据库。下载时不直接公开桶的读权限而是生成带有效期的预签名URL过期自动失效答辩完成后权限自然回收。MinIO的endpoint要特别注意。开发环境用http://localhost:9000部署环境如果内网访问就用内网IP不要图省事在浏览器里先测通了https://play.min.io就直接抄进配置那个公共演示环境根本不适合生产使用。4.4 答辩评分与成绩自动折算答辩结束之后教学秘书最怕的是手动算成绩。11374里成绩分三部分指导教师分占40%、评阅人分占30%、答辩组评分占30%。score_record表里记录原始分统计时按权重自动折算再结合学生阶段材料的完成情况得出最终结果导出成Excel。导出这块强烈建议用EasyExcel文档里写一个实体类加ExcelProperty(姓名)注解一行代码就能把数据写到流里面。用传统POI手写单元格样式几百行代码起步真心不划算。5. 开发中实测踩过的五个坑与完整排查链路5.1 启动报Failed to configure a DataSource: url attribute is not specified这是Spring Boot新手出镜率最高的报错。现象很诡异application.yml里明明写了数据源配置启动还是报这个错。排查链路分享给你们第一步先看SpringBootApplication所在的位置。Spring Boot默认扫描启动类所在的包及其子包如果把启动类放在了com.campus而配置文件放在com.campus.grad.config下面没被扫描到配置就不会自动生效。第二步检查resources目录是否被IDEA正确识别成资源目录target/classes里如果没有编译出来的application.yml那跑的就是一个没有配置的项目。第三步再确认yml文件缩进spring.datasource是两层缩进经常有人把url写到跟spring同一层这种错误肉眼非常难发现。真实场景里90%是这个三类问题不要一上来就往ConfigurationProperties绑定上想。5.2 时间字段前后端差了8小时系统上线第一天学生提交的开题报告在列表里显示的时间全部少了8小时。排查链路是这样的先看数据库里的created_at发现存储时间没问题排除MySQL写入问题。再看后端JSON序列化返回的时间发现接口返回的已经是正确的时间字符串排除Java时间对象问题。最后在前端页面打印拿到的数据发现浏览器解析的时候把时间当成了UTC时间默认转成了本地时区。解决方案是三层同步处理MySQL连接串加serverTimezoneAsia/ShanghaiSpring Boot配置文件里设置Jackson的时区spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8前端展示时统一用dayjs的dayjs(value).format(YYYY-MM-DD HH:mm:ss)格式化。三层都到位之后时间再也没错过。5.3 跨域通了又没通的诡异现象开发时遇到一个非常恼火的问题接口能正常返回数据但浏览器控制台仍然报CORS错误。查了半天发现是拦截器在CorsFilter之前抛了异常。异常一旦被全局异常处理器捕获响应头就丢了CORS相关字段浏览器直接拒绝解析响应。这个事的教训是如果你在DispatcherServlet层面加了自定义拦截器一定要保证CorsFilter在过滤器链上排在拦截器前面而且全局异常处理时不丢弃已有的响应头。Spring Boot里把CorsConfig那套写好配合Order(Ordered.HIGHEST_PRECEDENCE)注册基本能规避。5.4 MinIO上传时偶尔报错The difference between the request time and the current time is too large这个坑花了我一个晚上。现象是上传偶尔失败报请求时间和当前时间差太大。排查链路公司/学校内网如果部署了NTP时间同步服务某台服务器的系统时间如果掉了客户端和MinIO服务端时间差超过15分钟就会拒绝请求。解决方式很简单在MinIO服务端所在机器上校准系统时间并加入定时时间同步。这个问题的隐蔽性在于问题不出在代码逻辑也不出在存储本身纯粹是环境的时间漂移。5.5 部署后文件全变成0KB临时目录的幽灵本地开发一切正常jar包丢到服务器上之后学生上传的附件全部是0KB。排查之后发现Spring Boot默认会把上传的临时文件写到/tmp/tomcat.*目录服务器做了定期清理或者磁盘空间不够文件在写入过程中就丢了。解决办法是配置spring.servlet.multipart.location把上传临时目录显式指定到项目的数据目录比如/data/grad-system/upload-tmp并且保证该目录有足够空间。顺带建议上传的文件一定要最终转移进MinIO不要直接留在临时目录。5.6 源码丢了Spring Boot jar包怎么反编译成项目热搜里有一条怎么将springboot jar反编译成项目这个确实也是不少人的亲身教训。如果源码意外丢失只剩部署的jar包可以用IDEA自带的反编译功能快速恢复。把jar包拖进IDEA反编译出来的class就能看到源码内容用于找回大部分逻辑是可行的。如果class文件较多推荐用CFR这个命令行工具批量反编译再手工整理成工程结构。但我的真实体会是反编译只能救急注释注释没了、泛型信息会有一定丢失、构建配置也得重新补。真正靠谱的做法是第一天就把代码推到Git仓库哪怕一开始只有一行README也比事后反编译强百倍。6. 让程序在答辩时加分的小细节6.1 接口文档直接上Knife4j很多毕设项目做完了接口有哪些自己都说不清。我用Knife4j自动生成接口文档配合ApiOperation(学生提交选题志愿)这类注解答辩演示的时候打开/doc.html所有接口一目了然。评委老师想看你系统做了什么不用在页面上一个个点接口文档平铺开反而显得项目更专业。6.2 全局异常处理与统一返回结构11374里所有接口统一返回ResultT结构包含code、message、data三个字段。业务异常通过BusinessException抛出由RestControllerAdvice统一捕获并转成对应的Result。这样做的好处是前端处理错误逻辑非常统一不再需要针对每个接口做判断也对将来扩展拦截器、定时任务很有帮助。代码建议单独加一个AOP切面统计接口耗时把超过1秒的慢请求打日志答辩的时候如果老师问到性能优化你可以直接拿出日志说哪几个接口慢、怎么优化的。这个细节经常能救场。6.3 演示数据与演示路径设计答辩现场最容易翻车的是网络和数据准备。演示前我专门准备了三个账号管理员、教师、学生各自对应一套预置数据。为了不被弱网拖累我提前把常用接口的数据在Redis里预热一遍冷启动之后第一次点击也是秒开。强烈建议不要现场注册账号、不要现场上传大文件这些操作务必提前做好把演示时间压缩到展示核心业务逻辑上。6.4 README与一键部署脚本项目根目录放一份结构清晰的README包含技术栈、模块说明、数据库初始化脚本、环境要求和启动步骤。同时写了一个deploy.sh脚本一条命令完成打包、停止旧服务、启动新服务。这些文档和脚本本身不算功能但能让评委快速看懂整个项目体现出的工程习惯比多写一个模块加分更明显。做完这套系统我最深的体会是技术选型和代码技巧固然重要但毕业设计系统这类管理项目真正值钱的地方在于流程建模。你把Excel里那种群里喊一嗓子问进度的模式抽象成状态机让每条数据都能明确回答现在在哪一步、下一步该干什么这个系统就已经成功了一大半。最后分享一个答辩演示的小技巧演示前把浏览器缓存清理干净提前把系统冷启动跑一次让缓存热起来展示的时候你会明显感觉到比现场手忙脚乱从容得多。项目代码建议当天就推到Git仓库后面的路会顺畅很多。