上个月朋友拿一个在线考试的项目需求来找我，说要做一套能同时支持学生在线答题、教师管理题库、自动批改客观题的Web系统。我当时直接给的组合就是SpringBoot2 + Vue3 + MyBatis-Plus + MySQL8.0。这套技术栈在Java Web项目里几乎算是毕业设计、内部管理系统、中小型业务平台的标准搭配了：SpringBoot2负责后端接口，Vue3做前端页面，MyBatis-Plus把数据库操作简化到不用写SQL，MySQL8.0做数据持久化。整套方案最核心的价值在于——考试系统本身的业务复杂度其实并不低，但它自带的模块划分非常清晰，用户、题库、组卷、答题、判分、统计每一步都有独立的边界，用这套技术栈去落地，能把大部分精力省下来放在业务逻辑上，而不是跟框架配置死磕。
这篇文章我会从项目拆解、后端实现、前端交互、数据库设计、部署踩坑、二次扩展六个方向，把整个考试系统的源码设计思路完整过一遍。无论你是准备拿它做毕业设计，还是想学SpringBoot2和Vue3的前后端分离实战，或者单纯想找一个能抄作业的管理系统脚手架，这篇都能给你实在的参考。
1. 拆解考试系统的核心业务：先理清要做哪些事
很多人在动手写考试系统之前会把需求想简单了，觉得无非就是"把题目拿出来，让学生选答案，最后算个分"。真上线用起来你会发现事情远不止这些，系统至少要管住六条线：角色权限、题库管理、试卷生成、在线考试、自动判分和成绩统计。这六条线彼此关联，但又必须能独立改动，所以模块边界从一开始就要划清楚。
1.1 三个角色眼里的考试系统
我把考试系统的用户分成管理员、教师、学生三端，每端的操作范围和权限完全不同。
- 管理员：管用户、管基础数据、看全局考试统计，一般不做具体的题目录入。
- 教师：负责题库维护、创建考试、组卷、设置考试时间、批改主观题、查看班级成绩。
- 学生：报名/参加考试、答题、交卷、查看自己的成绩与答题解析。
这个三角色模型决定了后端接口的通用做法：所有接口都需要鉴权，但不同角色的权限粒度不一样。学生能调用的接口做不了教师能做的事；教师也越权不到管理员的用户管理模块。这一点在后端实现时通过拦截器加角色判断就能解决，但前端也要同步做路由守卫和按钮级权限控制，不能只靠后端防。
1.2 核心流程与状态切换
考试系统的主线流程是固定的：录题 → 组卷 → 发布考试 → 学生考试 → 自动判分 → 成绩统计。其中"发布考试"这个节点最容易被忽略，它牵扯到考试状态的管理。我设计里考试状态有四种：
| 状态 | 含义 | 可执行操作 |
|---|---|---|
| 待开始 | 已创建未到开始时间 | 学生可查看考试信息，但不可进入答题 |
| 进行中 | 处于开始结束时间之间 | 学生可进入答题，可交卷 |
| 已结束 | 超过结束时间 | 系统自动回收未交卷的答题记录，生成成绩 |
| 已归档 | 教师手动归档或考后N天自动归档 | 所有人只读，不可修改 |
这些状态转换在代码里是通过时间字段自动判定的，不建议让用户手动去改状态，而是统一用一个状态计算接口，保证多个入口看到的状态一致。后端每个请求都会做一次时间校验，防止学生卡着时间边改本地时钟边写答案。
1.3 试卷生成的两个前置条件
组卷之前必须先存在一套题库结构。这里要提前确认两件事：
- 知识点维度：每一道题要能挂到某个课程/知识点下，不然随机抽题没法控制考察范围。
- 难度分布：题目要分易、中、难三档，组卷时按比例抽取，考试分数才符合正态分布。
我见过很多半路改需求的系统，先只有题目表，后面突然要求按知识点出题，结果要回到数据层重新刷一遍题目分类，非常被动。所以表结构设计时一定要预留知识点与难度字段，哪怕刚开始用不上，也不要等上线才补。
2. 后端落地：SpringBoot2与MyBatis-Plus的实战关键点
后端部分表面上是踩着SpringBoot2的老路走，但真正写起来有几个地方容易出问题：逻辑删除、自动填充、分页插件、批量插入、随机抽题。这些点处理好了，代码会非常清爽。
2.1 SpringBoot2工程分层的边界
我习惯把工程按 controller、service、mapper、entity、dto、vo、common 分包。其中 dto 和 vo 要严格分开，虽然一开始会觉得很啰嗦，但后面维护起来省很多事。举个例子，题目接受前端传入的数据用QuestionDTO，返回给前端展示用QuestionVO，字段可以不一样，文档也好生成，别人接手时看类名就知道这个对象是干什么的。
写接口的时候有一点要克制住：不要在一个Controller里堆所有逻辑。考试模块的Controller只负责接收参数、调用Service、返回结果，判分这种事全部丢到ExamRecordService里。这样单个接口方法基本都能控制在十行以内，出了问题定位也快。
2.2 MyBatis-Plus三个必须配置的点
MyBatis-Plus 的价值是简化CRUD，但如果只是替换了Mapper层，那代码依然很乱。我实际项目中必须配的有三样：
第一个是逻辑删除。考试系统的题目、考试记录都有删除操作，但业务上不允许物理删除，否则统计和关联数据会断裂。在实体上加@TableLogic，配置全局logic-delete-value: 1和logic-not-delete-value: 0，删除操作自动变成UPDATE ... SET deleted=1。
第二个是自动填充。创建时间、更新时间、创建人、更新人这种通用字段，如果每张表每个Insert都手动set一遍，代码会非常脏。写一个MetaObjectHandler，在 insert 和 update 时统一填充：
@Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, "createBy", Long.class, SecurityUtil.getCurrentUserId()); } @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); this.strictUpdateFill(metaObject, "updateBy", Long.class, SecurityUtil.getCurrentUserId()); } }第三个是分页插件。MyBatis-Plus的分页要显式配置PaginationInnerInterceptor，否则分页不生效。这个坑很多人踩过，花了一下午查为啥Page返回的总记录数是0，结果就是没注册插件。
2.3 自动判分与主观题人工批改的落盘逻辑
成绩生成逻辑看起来简单，但要把"客观题自动判、主观题教师改"融合进一套流程，需要在交卷时就做好数据切分。
我这边采用的方式是：交卷后立即遍历答题明细，把单选、多选、判断题按标准答案比对，正确的记录得分；简答、论述题分数先置0并标记为待批改。前端教师在批改页能看到一个待批改列表，每批改完一道题就更新这道题的得分明细，最终总分等于客观题得分加上主观题得分。
这里有一个细节很容易错：如果学生交卷后教师就立刻批改，学生还没考完，教师只能看到部分学生的数据。所以主观题批改界面必须按照"考试是否结束"来做过滤，严格按状态走流程。
2.4 JWT鉴权与角色权限的前后端联动
前后端分离项目里，JWT基本是标配。登录接口返回token，前端存到localStorage或pinia里，之后每个请求在Authorization请求头带上。后端写一个拦截器做统一校验，并从token里取出用户id和角色。
角色权限这块要注意：后端判断角色只是拦截器里的一个参数校验，但前端的路由也要配合。Vue3里用路由守卫判断用户角色，决定能不能进入教师端或管理端页面。光有后端校验是不够的，因为前端页面没有正确隐藏的话，学生能看到教师端的部分界面，体验很差。
2.5 随机组卷的防呆设计
随机组卷是最容易出问题的地方。一个合理的组卷算法应该允许教师定义：从哪些知识点出题、每个知识点下出哪些题型、每种题型抽几道、每道题多少分。然后后端在题库里按这些条件随机抽取。
最简单的抽取是用ORDER BY RAND()，但直接这么干有个问题：如果题库里符合条件的题目不够抽，试卷就会少题。比如教师要求抽10道单选题，结果题库里只有6道，那试卷就只有6题。我的做法是组卷前先做一次count校验，每种组合的题目数量达不到要求就直接返回参数错误，提示教师重新调整抽题配置。
多知识点混合抽题时，还要注意同一道题不能重复出现在一张试卷里。为了做到这一点，抽取前先把可能命中的题目id全部查出来，再去重，最后按随机顺序取需要的数量。直接用ORDER BY RAND() LIMIT n在题库只有几百道题时没问题，但数据量大时性能下降，可以考虑先取随机id锚点再取邻近数据。
3. 前端Vue3部分：考试交互与状态管理如何组织
Vue3 和 Vue2 最直观的区别是 Composition API。考试系统这种页面多、组件多、状态交叉的项目，用 Composition API 组织逻辑比 Options API 清晰得多。比如答题页，倒计时、当前题目索引、已选答案、考试剩余时间这几个状态放在一个setup函数里维护，比散落在data、computed、methods之间要顺手。
3.1 考试系统页面拆分
前端按角色拆页面：
- 学生端：考试列表、考试须知、答题页、成绩页。
- 教师端：题库管理、试卷管理、考试创建、主观题批改、成绩分析。
- 管理端：用户管理、课程管理、系统配置。
复用度最高的是题库管理里的题目编辑表单和答题页里的题目卡片组件。题目卡片组件接收题目数据、当前答案、是否可交互三个属性，复用性很强。答题页和批改页都会用到它。
3.2 答题倒计时与防作弊
倒计时是个很容易被想简单的功能。直接在前端setInterval每秒减1是最常见写法，但有一个致命问题：本地时间是可以被用户改的，改时钟就能延长时间。所以更稳的做法是后端下发服务端时间戳，前端只负责渲染剩余毫秒数，每次提交答案时也带心跳，由后端在交卷时重新校验实际时间。这样即使前端时间不对，后端也能在交卷时强制判定超时。
如果想让防作弊再进一步，可以监听页面的visibilitychange事件。学生切出页面超过一定次数就记录一次警告，并把状态同步给后端。这个在真实考试中很有用，但毕设项目里不一定需要做那么重。
3.3 axios 拦截器与 token 失效处理
axios 拦截器在这里负责两件事：请求时带上token、响应时处理401。考试系统的token我建议设置一个较长的有效期，比如24小时，但每次请求都刷新token的过期时间，这样学生中途去吃饭也不至于被强制弹出登录。401处理逻辑要统一：弹出提示、清除本地用户信息、跳转登录页。
3.4 成绩统计可视化
成绩页不应该只给一个总分。我更建议后端返回一份完整的答题分析数据，包括得分、客观题正确率、各知识点得分率，前端用 ECharts 画雷达图或柱状图展示。这个模块虽然看起来只是锦上添花，但对用户体验提升很大，而且教师端同样需要班级成绩分布图，前后端接口可以复用，性价比很高。
4. MySQL8.0 表结构设计与数据库层面的坑
数据库设计是整个考试系统能跑多稳的地基。我在这个项目里的核心表一共六张，表结构设计思路分享如下。
4.1 核心表设计与字段规划
用户表sys_user和通用后台用户表差异不大，区别是考试系统通常需要额外的student_no学号字段和grade班级字段。这些字段在教师端按班级筛选成绩时会被频繁使用，需要在建表时预留索引。
题目表exam_question是最核心的一张表，字段包括：题目类型、知识点、难度、题干、选项、标准答案、答案解析。选项我用了一个取巧的做法：选择类的题目，选项A/B/C/D直接存成JSON字符串，解析由前端处理。这样选择题、多选题、判断题都能共用一张表，表结构不用因为题型不同而变形。
试卷表和答题记录表的设计要点如下：
| 表名 | 作用 | 关键字段 |
|---|---|---|
| exam | 保存考试的基础信息 | title, exam_type, start_time, end_time, duration, total_score |
| exam_question | 保存某次考试包含哪些题目及每题分数 | exam_id, question_id, score, sort_order |
| exam_record | 保存每个学生的参考状态和总成绩 | exam_id, user_id, start_time, submit_time, score, status |
| answer_detail | 保存每题的实际作答明细 | record_id, question_id, user_answer, is_correct, score |
考试系统的核心查询基本都围绕exam_record和answer_detail两张表转，所以在这两张表上我倾向加联合索引。exam_record表建(exam_id, user_id)唯一索引很有必要，这是防止学生重复交卷的兜底方案；answer_detail表建(record_id, question_id)唯一索引，保证同一份试卷里每道题只有一条作答记录。
4.2 MySQL8.0 连接配置的常见坑
MySQL8.0 在本地开发时要特别注意 JDBC 连接的几个参数。第一个是驱动类名变了，用的是com.mysql.cj.jdbc.Driver，旧版com.mysql.jdbc.Driver在新版驱动里已经移除了。第二个是连接串里必须带serverTimezone=Asia/Shanghai，否则日期时间字段会出现8小时时差。第三个让我印象最深的是下面这个报错：
Public Key Retrieval is not allowed这个报错出现在使用 mysql-connector-java 8.x 连接MySQL8.0时，默认不允许获取服务器的公钥。解决办法是在JDBC连接串后面加allowPublicKeyRetrieval=true。很多第一次从MySQL5.7迁移到8.0的项目都会卡在这里。
4.3 MyBatis-Plus 批量插入：saveBatch 并不一定真的"批量"
题库录入时，教师经常一次导入几百道题。很多同学直接用 MyBatis-Plus 的saveBatch()，以为它就是批量插入，其实它默认走的是单条Insert循环执行。想让它真正变成批量插入，需要在JDBC连接串中加入：
url: jdbc:mysql://localhost:3306/exam?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true&useSSL=false关键就是rewriteBatchedStatements=true。加了这个参数，MySQL JDBC驱动才会把多条插入语句重写成INSERT INTO ... VALUES (...),(...)的形式，插入300道题的时间能从几十秒降到几秒。我用过ExecutorType.BATCH的方式重写SqlSession模板，代码侵入性太大，反而没有加连接参数来得干净。
4.4 数据库初始化脚本要一劳永逸
项目文档里如果没有完整的建库建表脚本，很多人拿到源码第一关就过不去。我建议把初始化SQL拆成两份：一份是表结构创建脚本，一份是基础数据脚本。基础数据至少要有管理员账号、一个教师账号、一个学生账号、几道不同难度的测试题，让拿到项目的人能在十分钟内跑起来并看到效果。
5. 从源码到跑通：部署与踩坑实录
这一部分写给想把这个项目落地运行的同学。环境准备、配置修改、常见报错，这几关过了，项目才算真正属于你。
5.1 本地环境清单
- JDK：8 或 11，SpringBoot2 系列建议 JDK8+，稳定。
- Maven：3.6+，用于后端依赖管理和打包。
- Node.js：16 或 18，配合 Vite 使用。Vite4 在 Node16 上跑没问题，Node14 会有兼容性报错。
- MySQL：8.0。做完第四步的初始化脚本导入后就能用。
- 前端包管理器选择 npm 或 pnpm 都可以，如果你在 pnpm 下安装依赖经常报错，直接用 npm 更省心。
5.2 从无到有的四个步骤
按顺序来能避免一半的问题：
# 1. 导入数据库 mysql -u root -p < exam.sql # 2. 启动后端 (application.yml改好数据库账号密码) mvn spring-boot:run # 3. 安装前端依赖并启动 cd frontend npm install npm run dev前端默认端口一般配在8080，后端接口在8081或你自己约定的端口。前后端之间通过代理解决跨域：Vite 的server.proxy把/api前缀转发到后端地址，这样浏览器看到的都是同源请求，不用在后端纠结 CORS 配置。
5.3 运行常见报错与定位思路
我帮人排查项目时遇到的报错频率从高到低排一下：
报错一：数据库连接失败或时区错误。一般集中在application.yml里的 url、username、password 三项。MySQL8.0 的默认密码校验规则在本地连接时没问题，但如果同时配置了useSSL=false，MySQL 可能会在连接阶段做额外校验。
报错二：纯前端报错，页面白屏。大概率是接口跨域或接口地址不对。先按F12看 Network 里面/api请求的状态码，如果是404，检查后端的 context-path；如果是500，去后端控制台看异常堆栈。别一头扎进Vue代码里找原因，前后端问题要先用网络面板定位。
报错三：登录之后接口返回401。通常是token没带或者认证拦截器的放行配置漏了。留意拦截器配置中不要拦截/login、前端静态资源、swagger 文档路径。我把放行路径统一维护在一个常量类里，比在拦截器里写死字符串更清晰：
public class AuthConstant { public static final String[] WHITE_LIST = { "/auth/login", "/auth/register", "/doc.html", "/webjars/**", "/swagger-resources/**" }; }报错四：文件上传失败。如果教师需要传图片或者Excel导入题目，SpringBoot2 默认单文件上传上限是1MB，调大一下就行：
spring: servlet: multipart: max-file-size: 10MB max-request-size: 50MB5.4 并发交卷时如何避免丢数据
真实考试场景里，一个考场60人同时交卷，如果不做防重和幂等，后端很可能会处理重复请求。我采用的方案是三层兜底：
第一层，前端交卷按钮点击后禁用，同时通过防抖状态防止二次点击。第二层，后端在交卷接口里判断exam_record表中该考生是否已有提交时间，如果记录不为空直接返回已提交，不做重复计算。第三层，也是最关键的一层，exam_record表加(exam_id, user_id)唯一索引，即使两条并发请求同时打进来，数据库索引也能保证只有一条插入成功。
这三级防护下来，我实测并发场景基本没有出现过成绩丢失或重复记录的问题。如果你的考试规模更大，可以在交卷接口前加一个Redis分布式锁，但普通项目和毕业设计做到数据库唯一索引这一层已经很够用了。
6. 从考试系统源码扩展出去的更多玩法
如果你手里拿到这套源码，我强烈建议不要只满足于它能跑。考试系统的代码结构，天然适合二次扩展成多个方向的业务平台。
6.1 抽离出通用后台脚手架能力
考试系统已经具备了一个后台管理系统需要的全部基础功能：登录鉴权、用户管理、角色权限、文件上传、分页列表、数据库操作。把这些模块抽象出来，你可以快速搭出培训管理、问卷调查、在线评测、人事考核等系统。区别只是核心业务表不同，前后端的框架代码几乎可以原封不动复用。
6.2 组卷算法往"智能"方向升级
当前的随机组卷能满足基本需求，但如果你想优化，可以把组卷策略升级成约束满足问题：按知识点覆盖率、难度系数、区分度多个维度加权抽题，使整张试卷的平均难度落在预设区间。这一步可以在后端引入简单的贪心算法，每次先抽取最稀缺的知识点题目，再调整难度比例。
6.3 成绩分析模块做深一层
目前成绩分析如果只做到班级平均分和及格率，对学生来说参考价值有限。扩展方向可以是为每个学生生成详细的知识点掌握度报告，把答题记录按题目类型和知识点聚合，得出"三角函数掌握良好、数列较弱"之类的结论。这部分数据实际上考试系统已经全部存了，只是要多写几个查询接口和可视化页面。
我自己在实际做过几个类似项目之后的体会是：考试系统这种类型最考验人的地方不在某一项技术有多深，而在于业务状态机、数据校验、并发边界这些务实的老问题。SpringBoot2、Vue3、MyBatis-Plus、MySQL8.0这四样东西网上单点教程一大堆，但真正把它们揉进一个完整项目后还能跑得稳、改得动，才是这套源码的实际价值。你拿到代码后别急着疯狂加功能，先把考试从创建到出成绩的完整路径走通，再沿着异常分支去补边界，那时候很多当初不理解的设计选择，你自然就明白为什么这么写了。
