上个月朋友拿一个在线考试的项目需求来找我说要做一套能同时支持学生在线答题、教师管理题库、自动批改客观题的Web系统。我当时直接给的组合就是SpringBoot2 Vue3 MyBatis-Plus MySQL8.0。这套技术栈在Java Web项目里几乎算是毕业设计、内部管理系统、中小型业务平台的标准搭配了SpringBoot2负责后端接口Vue3做前端页面MyBatis-Plus把数据库操作简化到不用写SQLMySQL8.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 deleted1。第二个是自动填充。创建时间、更新时间、创建人、更新人这种通用字段如果每张表每个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_scoreexam_question保存某次考试包含哪些题目及每题分数exam_id, question_id, score, sort_orderexam_record保存每个学生的参考状态和总成绩exam_id, user_id, start_time, submit_time, score, statusanswer_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在新版驱动里已经移除了。第二个是连接串里必须带serverTimezoneAsia/Shanghai否则日期时间字段会出现8小时时差。第三个让我印象最深的是下面这个报错Public Key Retrieval is not allowed这个报错出现在使用 mysql-connector-java 8.x 连接MySQL8.0时默认不允许获取服务器的公钥。解决办法是在JDBC连接串后面加allowPublicKeyRetrievaltrue。很多第一次从MySQL5.7迁移到8.0的项目都会卡在这里。4.3 MyBatis-Plus 批量插入saveBatch 并不一定真的批量题库录入时教师经常一次导入几百道题。很多同学直接用 MyBatis-Plus 的saveBatch()以为它就是批量插入其实它默认走的是单条Insert循环执行。想让它真正变成批量插入需要在JDBC连接串中加入url: jdbc:mysql://localhost:3306/exam?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghairewriteBatchedStatementstrueallowPublicKeyRetrievaltrueuseSSLfalse关键就是rewriteBatchedStatementstrue。加了这个参数MySQL JDBC驱动才会把多条插入语句重写成INSERT INTO ... VALUES (...),(...)的形式插入300道题的时间能从几十秒降到几秒。我用过ExecutorType.BATCH的方式重写SqlSession模板代码侵入性太大反而没有加连接参数来得干净。4.4 数据库初始化脚本要一劳永逸项目文档里如果没有完整的建库建表脚本很多人拿到源码第一关就过不去。我建议把初始化SQL拆成两份一份是表结构创建脚本一份是基础数据脚本。基础数据至少要有管理员账号、一个教师账号、一个学生账号、几道不同难度的测试题让拿到项目的人能在十分钟内跑起来并看到效果。5. 从源码到跑通部署与踩坑实录这一部分写给想把这个项目落地运行的同学。环境准备、配置修改、常见报错这几关过了项目才算真正属于你。5.1 本地环境清单JDK8 或 11SpringBoot2 系列建议 JDK8稳定。Maven3.6用于后端依赖管理和打包。Node.js16 或 18配合 Vite 使用。Vite4 在 Node16 上跑没问题Node14 会有兼容性报错。MySQL8.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 的默认密码校验规则在本地连接时没问题但如果同时配置了useSSLfalseMySQL 可能会在连接阶段做额外校验。报错二纯前端报错页面白屏。大概率是接口跨域或接口地址不对。先按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这四样东西网上单点教程一大堆但真正把它们揉进一个完整项目后还能跑得稳、改得动才是这套源码的实际价值。你拿到代码后别急着疯狂加功能先把考试从创建到出成绩的完整路径走通再沿着异常分支去补边界那时候很多当初不理解的设计选择你自然就明白为什么这么写了。
