我记得当年选题的时候，看到“基于SpringBoot的计算机基础网络教学系统”这个题目，第一反应是有点普通。计算机基础嘛，感觉就是课程列表加考试页面，能做出什么花？真到动手做的时候才发现，一个真正可交付的毕设源码，远比想象中复杂，也不是网上那些残缺的CRUD demo能比的。
这篇文章就把我基于SpringBoot开发这套系统的整个过程拆开来讲，从需求分析、技术选型、数据库设计，到JWT登录、在线考试、自动判卷、MinIO文件存储、Vue前端打包整合，再到部署和答辩准备。重点我会放在那些文档里不会写、但实际开发时一定会反复撞上的细节。如果你正在用SpringBoot准备毕设，或者手里有一套教学管理系统源码但总觉得演示起来不够稳，这篇应该能帮你省下不少时间。
1. 选题的底层逻辑：这个系统到底在解决什么问题
1.1 计算机基础课程的三个真实痛点
计算机基础是很多高校的公共必修课，学生基数动辄几百上千人，课程内容涵盖Office操作、计算机组成、网络基础、数据库基础等。这类课程线上化的核心痛点非常明确。
第一个痛点是作业和平时分统计。大班授课环境下，教师收纸质作业、在Excel里登分，非常耗时，还容易出错。第二个痛点是上机练习资源不够。很多学生下课以后没有实验环境，但又需要反复练习Office和程序题，这时候课件、视频、题库类资源按课程组织起来，价值就很直接。第三个痛点是考试与判卷成本。期末集中上机考试，涉及组卷、监考、判卷、成绩导出，纯人工操作极其消耗精力。
所以这个网络教学系统的定位，不是做一个花哨的网页，而是把“课程资源分发、在线学习、作业提交、考试自动判卷、成绩统计”这条链条完整闭环，让老师和学生都在一个平台上完成全部教学动作。这个定位，也是答辩时评阅老师最容易认可的切入点。
1.2 为什么选SpringBoot而不是SSM或其他方案
技术上完全可以用原生Servlet写，也可以用SSM框架搭。但毕设周期就那几个月，SpringBoot几乎是性价比最高的选择。原因很直接：它解决了SSM时代最影响开发效率的两件事，繁琐的XML配置和依赖版本冲突。
SSM要手动配置web.xml、spring-mvc.xml、mybatis-config.xml，每加一个组件就要同步改配置文件。SpringBoot通过自动装配和starter机制，把“引入依赖、配置、使用”压缩成“引入依赖后直接用”。内置Tomcat还省掉了外部容器的部署，本地开发一条java -jar就能跑起来。这些省下来的时间，应该花在业务功能和系统设计上，而不是放在跟配置文件搏斗上。
提示：毕设选题阶段，SpringBoot版本我强烈建议选2.7.x稳定分支，具体原因在第5部分会展开。
1.3 系统功能边界：核心闭环与外围功能
做毕设最怕两件事：功能太少，答辩时被说工作量不够；功能太多，时间完全不够。我的做法是把系统分成核心闭环和外围加分项两个层级。
核心闭环是必须完整跑通的：管理员创建课程并分配教师，教师上传课件和布置作业，学生在线学习和提交，系统自动判卷或教师人工批阅，最终成绩汇总导出。这一圈走完，工作量已经很扎实。外围功能比如公告栏、站内信、在线答疑、学习论坛，选一两个做个简化版就行。目的是让评阅老师看到你考虑过完整产品设计，而不是只会画个登录框加增删改查。
2. 数据库与权限模型：系统设计中最花时间的部分
2.1 RBAC权限模型：不要用一个角色字段走天下
我早期的用户表设计很朴素，一个role字段区分学生、教师、管理员，代码里到处if判断。后期想加一个“助教”角色时，发现改起来极其痛苦，所有Controller里的权限判断都要动，前端路由也要动，测试也要补。
后来我重置为RBAC模型，也就是用户、角色、权限三层。用户表只管认证，角色关联权限，系统按权限控制接口访问。一个用户可以有多个角色，一个权限也能被多个角色共用。虽然毕设规模做三张表有点“重”，但它在答辩时能自然引出“我考虑了系统可扩展性”，而且Spring Security对这套模型的默认支持度非常高，不需要从零写拦截逻辑。
2.2 核心表结构：每个关键字段背后的原因
不贴全部SQL，只把最重要的几张表和容易踩坑的字段设计讲清楚。
| 数据表 | 关键字段 | 设计说明 |
|---|---|---|
| sys_user | id, username, password, enabled | username做唯一索引；password存BCrypt密文；enabled用于账号封禁 |
| sys_role | id, role_code, role_name | role_code是唯一标识，代码判断用编码而不是中文名 |
| sys_user_role | user_id, role_id | 中间表，表达用户与角色的多对多关系 |
| course | id, course_name, teacher_id, semester, status | semester区分不同学期，status控制课程上架下架 |
| resource | id, course_id, title, type, file_url | type区分课件/视频/作业附件，file_url存MinIO中的对象地址 |
| exam | id, course_id, title, start_time, end_time, duration | 考试时间窗口必须落库，判卷逻辑依赖时间边界 |
| exam_answer | id, exam_id, student_id, question_id, answer, score | 自动判卷更新score，主观题留空待教师批阅 |
| exam_score | id, exam_id, student_id, final_score | 统计汇总表，存最终成绩，方便查询和导出 |
学习进度模块还需要一张student_progress表，记录student_id、resource_id、progress_num，用来追踪每个学生看课件的进度。
2.3 外键到底建不建，逻辑删除怎么做
工程上很多人不推荐物理外键，因为高并发和大数据量场景下外键会拖慢性能。但毕设场景我建议保留核心关联外键，比如course_id、user_id，评阅老师看ER图的时候，主外键关系清晰会加分。
这里要注意，外键会影响删除顺序。比如删除用户前必须先处理关联的答题记录和成绩数据，否则会直接报约束错误。我在系统里优先采用逻辑删除方案，也就是每个核心表加deleted标志位，删数据时更新标志而不是物理删除。这样既能保住外键关系，又避免了删除连锁的问题。
3. 核心业务实现：登录鉴权、在线考试与自动判卷
3.1 JWT登录态与Spring Security过滤链的配置
JWT已经是毕设项目里的标配，原因很简单：前后端分离场景下，用Token管理登录态不需要同步Session，扩展和演示都方便。标准的做法是写一个JwtUtil工具类负责生成和解析Token，再写一个OncePerRequestFilter子类，在每次请求时从Header里取Authorization，解析出用户ID和角色信息放入SecurityContext。
SecurityConfig的配置骨架大概是：
- 禁用CSRF
- 放行登录接口、静态资源、前端打包后的页面路由
- 其余接口统一走认证
- 配置密码编码器为BCrypt
这里的坑通常不在业务代码，而在框架版本。Spring Security更新后，老的WebSecurityConfigurerAdapter写法被废弃，现在推荐用SecurityFilterChain的Bean配置方式。如果你第一次配Security直接抄旧博客，很可能被编译错误卡住。我的建议是按官方文档样例写，不要混用两种配置风格。
3.2 在线考试：题目抽取与前端防作弊
在线考试模块我采用“开始考试时抽题”的策略。考试开始后，从题库表中按题型和难度权重随机选取题目，组合成一份试卷，并把学生与试卷的关联关系保存下来。这样做的好处是同一考场内不同学生的题目顺序不同，演示时很有说服力。
关键注意点：题目列表不能一次性返回给前端。后端只返回题号和选项，正确答案绝对不能出现在未交卷的响应数据里。如果前端通过接口拿到了题目和答案的关联，那这个系统在答辩时会被一眼看穿，考试模块就变成纯摆设了。
3.3 自动判卷的边界条件
自动判卷要按题型拆策略。单选题、判断题直接比对答案；多选题要注意选项顺序不一致的问题，保存答案时先做原子化排序再比较；填空题用关键词匹配，解析时要容忍首尾空格和全半角差异。主观题没法完全自动判，我的方案是先保存作答内容，标记为待批阅状态，教师在管理端人工打分后再汇总成绩。
判卷逻辑里最容易漏的是边界条件：学生交卷超时怎么办？考试中途断网怎么办？我的做法是交卷时间以数据库时间为准，不信任前端时间。考试记录里加submit_status字段，标记进行中、超时自动交卷、正常交卷三种状态。超时情况由Spring的定时任务检测，系统自动置为超时交卷，并保存已经作答的内容。这个设计答辩时非常加分，因为很多毕设把时间判断全扔给前端，一旦改本地时间就能作弊。
3.4 学习进度追踪的数据采集方案
学生看课件的进度不能只存前端localStorage，刷新就丢。我在系统里加了student_progress表，用心跳上报的方式实现：视频播放器每30秒向后端上报一次播放位置，后端比较当前值是否大于历史值，是则更新，否则忽略。这个逻辑很简单，但体现的是在线学习系统核心难点的理解，也就是“数据采集与持久化”，而不仅仅是播放一个视频。
4. MinIO对象存储：文件模块最稳妥的落地方案
4.1 为什么毕设要引入MinIO而不是存本地磁盘
课件、视频、图片这类大文件，如果直接存服务器磁盘，问题非常明显：本地路径写死以后，换一台服务器数据就丢；若用相对路径，在容器化部署场景下又容易出问题。MinIO是一个开源的轻量对象存储服务，接口兼容S3协议，可以和SpringBoot应用同机跑，部署成本几乎为零。
还有一层现实原因：把“MinIO加入到SpringBoot”已经是前后端分离项目里很常规的操作，很多公司的内部文件服务就是这么搭的。你把这个点写进简历、聊项目亮点，明显比“文件存在D盘upload文件夹”体面得多。
4.2 SpringBoot集成MinIO的核心代码骨架
第一步，引入Maven依赖，坐标大概是io.minio:minio:8.x。第二步，在application.yml里配置endpoint、accessKey、secretKey、bucketName。第三步，写一个MinioService封装上传、下载、删除、生成临时访问链接四个方法。
上传接口接收MultipartFile，转成InputStream后调用putObject。这里有一个很重要的细节：文件名最好用UUID重命名，同时保留原始文件后缀，否则下载时浏览器可能不知道如何打开。文件按课程ID分目录存储，这样MinIO桶里结构清晰，后台排查问题也方便。
4.3 文件访问的权限控制
MinIO桶默认是私有权限，直接拿对象地址访问会被拒绝。毕设阶段有两种策略：把桶设为公开，或者继续使用私有桶加预签名临时链接。我推荐后者，因为它更安全，而且实现上只多两行代码。任何要求“登录后才能看课件”的场景，临时有效链接都是最合理的方案。
具体操作是用presignedGetObject生成带时效的URL，一般课程资源设置24小时有效即可。这里我踩过一次坑：刚开始没有显式设置超时时间，用了默认值，导致上传的视频链接有效期太长。代码里显式传时间参数，不要依赖默认值，这个习惯在对接云存储时也能用上。
5. 前后端联调与打包部署：Vue放进SpringBoot的那些坑
5.1 为什么把Vue打包产物放进SpringBoot
毕设评审老师希望看到一个能一次性跑起来的项目。如果前后端完全分离，你需要先启动SpringBoot服务，再启动Vue前端，还得保证端口和跨域配置都没问题，多一步就多一个出错机会。所以我把Vue项目build出来的dist目录，放进SpringBoot的resources/static目录，通过同一个端口提供服务。前端路由用hash模式，避免刷新页面时出现404。
5.2 打包配置的完整过程
步骤不复杂，但顺序不能错：
- 后端
resources目录下建static文件夹，把Vue的打包产物复制进去。 - 前端Vue Router切换成hash模式，因为history模式刷新会直接请求后端路径。
- Spring Security配置里放行前端静态资源路径，例如
/static/**、/assets/**。 - 接口路径统一以
/api开头，前端开发时走devServer代理，打包后直接使用相对路径请求。
这里有一个很常见的坑：SpringBoot拦截了所有请求，前端路由对应的路径很可能被后端的异常处理接住，返回一堆JSON错误而不是页面。解决办法是写一个转发Controller，把未匹配到的前端路由直接转发到index.html，交给Vue Router内部处理。
5.3 SpringBoot版本太高会带来哪些连锁问题
为什么我反复强调版本要稳，因为实测SpringBoot 3.x刚推出时拿来跑这套系统，会遇到三件闹心事：JDK版本要求变成17，很多人本机还停留在JDK 8；某些第三方starter的老版本和SpringBoot 3.x不兼容，坐标和配置方式都要换；javax命名空间改为jakarta，很多代码的import要整体调整。只要换一个不常用的依赖，成本立刻翻倍。
所以选题阶段我的建议很明确：能跑通演示比追新版本重要得多。2.7.x是SpringBoot 2.x的稳定分支，网上资料和毕设案例最多，踩坑成本最低。这不代表永远不用新版，只是毕设阶段应该以“不确定性最小”为原则。
6. 踩坑复盘与答辩加分建议
6.1 三个最典型的坑，按影响面排序
第一个是时间格式与时区问题。前端传给后端的时间经常是带T的ISO格式，Java的LocalDateTime用默认序列化会解析失败。解法是全局配置统一JSON序列化格式，或者在时间字段上加@JsonFormat注解。这个坑几乎所有前后端系统都会遇到，建议一开始就配好。
第二个是文件上传大小限制。SpringBoot默认单文件最大1MB，上传课件视频根本传不过去。需要同时配置spring.servlet.multipart.max-file-size和max-request-size，我设置了100MB。如果你还挂了Nginx，记得同步调client_max_body_size，否则后端放开限制Nginx也会拦下来。
第三个是跨域问题。开发阶段前端跑8080端口，后端跑8081端口，axios直接调接口会被浏览器的跨域策略拦截。解法是后端正则CorsFilter放行指定来源，部署阶段前后端同端口后，再确认一遍没有把跨域代码影响到来之不易的同源访问。
6.2 让项目在答辩中显得有深度的几个优化点
成本最低、回报最高的是数据统计可视化。给成绩查询加一个ECharts柱状图或饼图，展示分数分布和课程热度。老师问“项目有没有亮点”时，这一张图比十页文档都管用。
其次是定时任务。用Spring的@Scheduled做考试超时自动交卷、课程下架检查、临时文件清理。功能不大，但体现的是工程化思维，说明你不只会写接口。
再就是统一异常处理和日志。用@RestControllerAdvice收口所有业务异常，避免Controller里到处try-catch。这个操作在平时的编码里非常加分，评阅老师看源码时很容易发现。
权限粒度可以做细一点。比如教师只能看到自己授课班级的数据，管理员才能看全校数据，用Security的权限表达式控制。实现难度不大，但相比“一个登录接口走天下”的普通毕设，档次立刻不一样。
6.3 源码结构与README文档的交付心态
源码结构尽量分层清晰，我习惯分成controller、service、mapper、entity、config、common六层。每个Controller至少跑通一遍核心流程，不要出现一个接口从来没调用过的情况。
还有一点要提醒：源码包里一定要放一份完整的README，写清楚启动步骤、数据库初始化脚本、默认账号密码。很多评阅老师拿到项目后第一件事是按README启动系统，这一步顺利，印象分就已经上来了。我给这类教学系统项目做交付时，甚至会把初始化SQL单独放一个目录，避免漏执行导致整站打不开。
最后说一点个人体会。做毕设这段时间，我对SpringBoot的理解有了很大变化，框架本身并不难，难的是把业务用一套技术方案闭环地表达出来。这套网络教学系统，从最初的CRUD想法，到后来加入RBAC权限、在线考试、自动判卷、MinIO对象存储、Vue前端整合，每一步都在踩坑，也正是这些坑让我对整个SpringBoot生态有了体系化的认识。如果你也在做类似项目，建议先把核心业务闭环跑通，再考虑锦上添花。代码多少不是关键，关键是能演示出“这个系统真正解决了什么问题”，这一点做到位，答辩基本不会差。
