一所要落地一套在线考试系统技术栈锁定成 Java Spring Boot 3 Vue.js 3 MySQL 时我最想劝你的不是“去网上找一个开源系统抄”而是先想清楚边界。这类系统看起来到处都是管理员发布考试、学生在线答题、系统自动打分好像几个页面就能讲完。但真正要支撑一场几百人同时参加的正式考试你会发现难点全都不在页面布局而在考试状态控制、试卷快照、重复提交幂等、异常恢复这些容易被忽略的地方。下面我会按自己的开发经验从设计、建表、后端接口、前端答题页到 MySQL 环境坑、部署和后续演进把这座系统拆开讲一遍。如果你正准备拿它做毕业设计、个人项目或者第一次接触 Spring Boot 3 Vue 3 全栈开发这篇文章会给你一条比较务实的路径。1. 先想清楚考试系统到底在管理什么1.1 核心不是“展示题目”而是“流程状态”很多人拿到需求后第一件事是打开 IDEA 创建实体类写一个Question、写一个Exam、再写一个User然后开始做题目列表和答题页面。这样做到最后通常会得到一个“演示版”能打开考试能选择答案能提交成绩也能算。但你会隐隐觉得哪里不对劲比如学生刷新页面后已答答案丢了。学生快速点了两次“交卷”生成了两份成绩单。考试时间已经到了还能继续点提交。管理员改错了题库里的某道题历史上已经考完的试卷也跟着变了。学生提交时在网络请求里把userId改成别人就能给别人的考试记录填答案。这些问题说明考试系统本质上不是“题目展示系统”而是一套流程控制系统。你要管理的是几个核心状态一场考试创建中、待开始、进行中、待阅卷、已结束、已发布成绩。一名考生的考试记录未开始、答题中、已提交、已阅卷。一道题在一次考试中的使用被选中到某张试卷后内容就不能再跟随题库变化。状态之间必须有约束。否则任何一步都可能绕过去导致数据错乱。1.2 先把关键实体理清楚在写具体代码前我建议先画一张最简单的实体关系图。不用画得很复杂但至少要包含以下这些对象实体作用关键字段user学生、教师、管理员id,username,password_hash,rolequestion题库中的题目id,question_type,content,options,answer,analysis,difficultyexam一场正式考试id,name,start_time,end_time,duration_minutes,total_score,statuspaper_question某场考试生成的试卷快照id,exam_id,question_snapshot,score,sort_noexam_record考生的考试记录id,exam_id,user_id,start_time,submit_time,statusanswer_record考生对每道题的作答明细id,exam_record_id,paper_question_id,user_answer,score有些项目会把question_id直接存在试卷题里然后查询时再去 join 题目表取content、answer。这种做法看似省事其实有一个隐患题库是会被维护的。如果考试结束后有人修改了题目你无法解释历史成绩为什么和当时的考卷对不上。所以说paper_question不应该只是“题目与试卷的关联表”它应当是“试卷快照表”。组卷那一刻要把题目内容、选项、答案、分值都复制过来或者至少把整卷内容存成一份不可变的历史数据。这样才能保证“成绩可追溯”。1.3 先定义最小可用流程不要一开始就做班级管理、科目管理、图形报表、复杂权限。一个能真正跑通闭环的最小流程只需要这样管理员创建一场考试设置开始时间、结束时间和考试时长。管理员从题库中选题生成一份试卷。学生登录后看到可参加的考试点击“开始考试”。后端为该学生生成一份独立的paper_question快照并创建一条状态为“答题中”的exam_record。学生逐题作答可以在页面点“暂存答案”也可以最后一次性提交。交卷时后端先校验时间、状态再保存全部answer_record然后自动批改客观题。教师登录后台对主观题评分完成后发布成绩。如果这个流程还没理通就不要急着写 Vue 路由也不要急着配 Spring Security。先把主干跑起来后续功能都是围绕主干扩展的。2. 从零搭建最小可运行系统先打通一条链路2.1 环境准备别让版本卡住你用 Spring Boot 3 开发前提是 JDK 17。Spring Boot 3 相比 2.x 的变化比较大很多老博客里的写法不一定适用所以不要照抄 2.x 的代码。终端命令里先确认java -version mvn -version node -v npm -v如果你本机没有 MySQL最省事的办法是用 Docker 临时起一个实例。常见的启动命令是docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORDroot123456 \ -e MYSQL_DATABASEexam_system \ -v /your/mysql-data:/var/lib/mysql \ mysql:8这里要注意不要随便把数据卷指向一个临时目录。考试系统最怕数据丢失启动容器时就要想好/var/lib/mysql的持久化路径。本地开发可以图省事但一旦进入真实使用容器可以被删数据卷不能丢。2.2 后端项目的最小配置用 Spring Initializr 创建一个 Spring Boot 3 项目依赖里选择 Spring Web、Spring Data JPA或者 MyBatis-Plus看团队习惯、MySQL Driver、Validation。启动一个空项目后第一步先配置数据源。application.properties的常见写法如下spring.datasource.urljdbc:mysql://localhost:3306/exam_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue spring.datasource.usernameroot spring.datasource.passwordroot123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver为什么要把连接参数写得这么长因为 MySQL 8 默认的认证插件和旧驱动之间会有兼容问题。不加allowPublicKeyRetrievaltrue时某些驱动版本会直接报Public Key Retrieval is not allowed。不指定serverTimezone时时区错误能让日期字段差 8 个小时。考试系统里时间差 8 小时不是小问题它会导致学生看到的交卷截止时间变得很诡异。如果你用的是 JPA建议把ddl-auto先设为none或validate不要一上来就靠 JPA 自动建表。自动建表适合快速演示不适合可控迭代。实际项目中一般会自己维护 SQL 建表脚本。2.3 前端用 Vite 代理对接后端不用被 CORS 卡住Vue 3 项目通常用 Vite 创建。开发时最直接的问题是前端跑在5173后端跑在8080跨域怎么办我的建议是开发环境不用后端配 CORS而是在前端vite.config.js里配置代理import { defineConfig } from vite import vue from vitejs/plugin-vue export default defineConfig({ plugins: [vue()], server: { port: 5173, proxy: { /api: { target: http://localhost:8080, changeOrigin: true, rewrite: (path) path.replace(/^\/api/, ) } } } })这样前端所有请求都走/api/...Vite 在开发服务器上把请求转发给后端省去 CORS 配置也更接近生产环境下 Nginx 反向代理的模式。看起来这些都是小配置但实际项目里不少人被版本、驱动、时区、编码这类问题绊住一调就是半天。先把环境跑通才有心情看业务逻辑。2.4 只跑通一个接口时先别高兴太早第一个能跑通的接口往往非常简单比如登录接口根据用户名查出用户并校验密码。考试列表接口查询当前时间在报名范围内的考试。这时你会发现页面能显示数据了感觉离成功很近。但考试系统真正的复杂度在“作答过程中”。所以请记住单次跑通只代表链路通不代表流程可靠。后面的状态控制、幂等性、异常处理才是决定它能不能被真正使用的分水岭。3. 核心模块题库管理、组卷和自动阅卷3.1 题目表怎么设计更灵活题库表在设计时至少要支持单选题、多选题、判断题、填空题和主观题。为了统一存储最常见的做法是content题目题干可以用 TEXT。options选项统一存 JSON 字符串比如单选题存[A. 请求转发, B. 重定向, C. 创建线程, D. 捕获异常]。answer正确选项也存 JSON 字符串单选存B多选存[A,C]填空存[答案1, 答案2]。analysis解析方便考试后让学生查看。question_type枚举区分题型。difficulty难度等级可以 1-5。这种设计不是唯一方案。如果你有大量复杂大题例如图文混排、音频题那可以把选项拆成单独表来存文件路径如果只是普通考试JSON 存储已经够用而且开发效率高。关键在于无论方案多简单都要给未来扩展留好后路。3.2 试卷快照必须在一开始就生成在线考试系统不能实时去查题库来显示考试题目。组卷时应该把题目复制到paper_question表至少在逻辑上保留一份不随题库变化的快照。固定组卷比较容易管理员从题库勾选题目后端按勾选顺序插入paper_question。随机组卷时很多人的第一反应是SELECT * FROM question WHERE type SINGLE ORDER BY RAND() LIMIT 10这段 SQL 对于小项目是能工作的。如果题库只有几百道题并发量也不高没有太大问题。但你要知道ORDER BY RAND()在数据量大时性能会明显下降因为它会对全表做随机排序。另一种做法是先用 count 拿到题目总数再通过随机主键范围去取题或者用 MySQL 的TABLESAMPLE思路。但这种方法也有边界要根据实际数据规模去选。比起随机算法更要注意的是“同一个人开始考试的并发问题”。学生连续点了两次“开始考试”后端如果不做幂等就有可能出现两条exam_record。解决办法有两层数据库层给exam_record加唯一索引例如(user_id, exam_id)。业务层先查状态状态为“答题中”就直接返回已有记录不再重新组卷。在一个事务里完成“查询是否已有记录、插入考试记录、生成试卷快照”三个动作是更稳妥的。3.3 自动阅卷时不同题型的批改逻辑不同自动阅卷目前能承担的是客观题。实现时不能只用一个简单equals解决所有题型。单选题把userAnswer与正确答案字符串比较。多选题因为前端表单可能会返回数组最稳妥的做法是排序后比较。比如正确答案是[A,C]学生选择[C,A]要先排序再比较。判断题可以统一成true/false或对/错。填空题可以按填空位拆成数组后逐空比对。精确匹配会比较死板但在最小版本里可以先接受。主观题最好不要自动给分至少在系统中保留“待评分”状态由教师在后台给分。只要题目内容写得好自动判分逻辑本身并不复杂。复杂的是“交卷动作”与“判分动作”的一致性。我遇到过的坑是先保存了答案再逐题判分累计完总分后更新考试记录。结果判分过程中抛出异常导致答案已经变成“已提交”但总分没更新。所以建议把“更新答题记录状态”和“写成绩”放在同一个事务里或者把交卷分成两步先提交答案然后异步判分最后把总分写回。小规模考试用同步事务问题不大规模大时再异步化。4. MySQL 连接与统计容易怀疑人生的一章4.1 本地连接不上的常见原因热词里出现过很多 MySQL 安装、连接报错的问题。在一个考试系统项目中最容易遇到的就是本地连不上数据库。比如最常见的报错ERROR 2002 (HY000): Cant connect to local MySQL server through socket /tmp/mysql.sock这个报错通常不是说你的 IP 被限制而是客户端默认通过 Unix socket 连接本机但 MySQL 服务的 socket 不在这里或者 MySQL 服务根本没启动。排查时先确定服务状态如果服务确实启动了再改用 TCP 方式连接mysql -h 127.0.0.1 -P 3306 -u root -p另一种是 Java 后端连接时报Public Key Retrieval is not allowed原因就是我前面强调的 MySQL 8 认证插件兼容问题。解决方式是在 JDBC URL 中增加allowPublicKeyRetrievaltrueuseSSLfalse还有一种情况是 Navicat 等客户端能连但 Java 连不上要先看账号是否有远程权限别只盯着 localhost。最后要把排查链路固化下来先看 MySQL 是否启动再看端口是否通再看账号权限再看 JDBC 驱动版本最后看连接参数。4.2 字符集和时区建库前就要决定如果你在 Windows 上开发Linux 服务器部署考试系统最容易出现的一个现象是网页显示中文正常但导出 Excel 或统计报表时出现乱码。这个坑通常在建库环节就埋下了。建议本地建库时直接指定CREATE DATABASE exam_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;不要再用utf8因为 MySQL 的utf8并不是完整的四字节 UTF-8有些特殊字符存不进去而utf8mb4才是完整支持。时区问题也一样。如果统一将数据库连接参数写成serverTimezoneAsia/Shanghai并且后端在创建LocalDateTime时都从服务端获取时间就不会乱。4.3 保存答案时别一条一条循环插入第一次写答题提交接口时很容易写成这样for (AnswerDTO answer : answers) { answerRepository.save(answer); }数据量小的时候完全没感觉。但当一份试卷有 50 道题同时有 200 个学生提交时就会出现几万条单条插入性能会很差。更合理的做法是使用 JDBC 批处理能力或者在 Spring Data JPA / MyBatis 中执行批量插入。如果使用 JDBC 连接可以在 URL 上加上rewriteBatchedStatementstrueMySQL 驱动会帮忙合并批量语句减少网络和事务开销。4.4 用“行转列”统计成绩分布考试结束后教师通常想看的不只是每个学生总分还有单选题正确率、多选题得分率等。如果把每个题型放在不同列里会方便前台画图。这时用 CASE WHEN 聚合函数就能实现行转列SELECT ar.exam_record_id, SUM(CASE WHEN q.question_type SINGLE THEN ar.score ELSE 0 END) AS single_total, SUM(CASE WHEN q.question_type MULTIPLE THEN ar.score ELSE 0 END) AS multiple_total, SUM(CASE WHEN q.question_type JUDGMENT THEN ar.score ELSE 0 END) AS judgment_total FROM answer_record ar JOIN paper_question pq ON pq.id ar.paper_question_id JOIN question q ON q.id pq.question_id WHERE ar.exam_record_id IN (...) GROUP BY ar.exam_record_id;这类 SQL 不是必须写在数据库存储过程里放在 Service 层简单清晰。对于考试系统我的建议是核心阅卷逻辑不要写成存储过程。存储过程虽然能在数据库里一步完成但它难调试、难版本控制、难做单元测试。尤其是当你还依赖 Spring Boot 事务和 Java 里的复杂业务判断时存储过程并不合适。成绩统计、报表查询这类只读场景可以用复杂 SQL但写数据、判分这种强业务逻辑更适合放在 Java 代码里。4.5 排查 MySQL 性能的固定顺序线上如果出现接口很慢不要一上来就加缓存。先按这个顺序排查看 SQL 是否走了索引优先用EXPLAIN。看 WHERE 条件字段有没有建索引尤其是exam_record.user_id、exam_record.exam_id、answer_record.exam_record_id。看是否有 N1 查询问题。前端展示成绩单时如果先查考试记录再循环查每个学生主观题答案就会产生大量小查询。看事务是否过长。交卷接口里不要在一个事务里做导出或发送通知。看是不是把 JSON 大字段全量查出来了。如果列表不需要题目解析就不要在列表接口里 join 大字段。学校考试场景一般不会打到大数据量瓶颈所以绝大多数慢接口问题都是锁、N1、缺索引导致的而不是 MySQL 本身扛不住。5. Vue3 答题页刷新、切屏、倒计时和幂等提交5.1 不要在路由里到处塞权限逻辑前端适合 Vue 3 Vue Router Pinia Element Plus。角色权限可以先做一个最简方案登录成功后把用户角色和 token 放到 Pinia在路由守卫里根据meta.role判断是否允许进入。但要注意前端路由守卫只是用户体验层面的限制。真正判断用户能不能开始考试、能不能评分必须放在后端。因为所有前端代码都掌握在客户端手里如果只在前端隐藏管理菜单直接请求管理接口照样能访问。所以我说前端的权限负责“页面入口”后端的权限负责“数据安全”。5.2 倒计时应以服务端时间为基准学生答题页面最忌讳的是把考试结束时间直接写成客户端当前时间加时长。因为客户端电脑时间可以调就算不恶意调网络波动也可能造成不准。更合理的做法是学生点击“开始考试”时后端返回该学生的考试开始时间和考试时长或者直接返回基于服务器计算的endTime。前端倒计时可以计算endTime - now不要只依赖setInterval每秒减一因为浏览器切后台后定时器可能会被节流回来时倒计时已经不准了。更稳的做法是每次 tick 时用当前时间重新计算。5.3 刷新页面和切屏监测要不要做考试系统里临时保存答案很重要。我的建议是每做一道题就调用后端接口保存“此题答案”不要全部只存在 Vuex/Pinia 里。虽然请求频率会高一些但这对正式考试更可靠。如果学生不小心刷新了网页重新进入考试时还能从后端加载已保存的答案。切屏监测可以作为一种辅助防作弊手段。学生如果离开考试页面可以用visibilitychange事件感知并向后端发送事件标记。但我不建议做太激进的限制比如一检测到切屏就强行交卷。真正的考试系统里学生可能只是切出去看时间或聊个消息直接判卷会引发大量客诉。可以将切屏次数记录到后端管理员后续查看。5.4 提交按钮的幂等处理前端提交时要做按钮 loading 和置灰防止用户双击。但前端防双击只能挡住普通用户。真正的防线在后端。最稳妥的做法是后端在同一个事务里先更新exam_record的状态UPDATE exam_record SET status SUBMITTED, submit_time NOW() WHERE id #{id} AND user_id #{userId} AND status ! SUBMITTED如果影响行数为 1说明本次提交是第一次更新再继续做保存答案和判分如果影响行数为 0说明已经提交过了直接返回“已提交”。这条路是防重复提交最有效的做法。6. 从能跑到可用上线前还要补几块拼图6.1 交卷时同步算分和异步算分的选择最小实现可以做到同步学生点提交后端在一个事务里保存答案、判分、更新总分然后返回成绩。几百人同时在线考试时这个方案大概率也能扛住因为真正的并发提交高峰通常只是一个瞬间。但如果要支持几千人同时考试且试卷里有大量主观题就不适合在事务里等待计算完成。可以先把答案保存好把考试记录标记为“已提交”然后再通过消息机制或定时任务异步判分。客观题判分结果快主观题等教师评分。得分出来后更新成绩单。这里的核心原则是交卷动作必须快速确认成绩计算可以后置。6.2 断网、断电、超时后的自动交卷在线考试最大的风险不是界面丑而是“学生界面显示提交成功服务端却没有记录”。一旦出现这种情况成绩就没有意义了。要解决这类问题需要明确学生每次作答的答案要尽量实时保存。交卷成功后前端要收到后端明确回执不能只看 Axios 成功就认为成功。服务端要有定时任务在考试结束时间之后扫描所有状态仍为“答题中”的记录将其强制置为“已提交”用最后一份已保存答案进行判分。如果学生从未开始答题强制交卷时按 0 分处理但要有日志记录原因。这样即使学生中途关闭电脑也不会因为没点交卷而永远留在“答题中”。6.3 日志、备份与权限在线考试数据比较敏感。我的经验是数据备份比功能优化更重要。你可以不上 Kubernetes可以不搞微服务但不能不做数据库备份。最简单的方式是每天凌晨用mysqldump全量备份再保留最近 7 天。同时每场考试从创建到交卷、评分、发布成绩都要有日志。至少要记录谁在什么时候创建了考试。谁在什么时候修改了试卷。学生什么时候开始答题什么时候提交。教师什么时候评了哪道主观题。成绩发布是自动还是手动。还要特别提醒答题接口里不要从前端请求参数里读取userId要从当前登录会话中获取。否则一个学生通过改参数就能把答案提交到别人名下去这不是攻击演示而是真实开发中最容易被忽略的越权问题。6.4 容器化部署不要一步跨太大推荐用 Docker Compose 把 Nginx、Spring Boot 服务和 MySQL 组合起来。Nginx 负责静态资源托管和反向代理后端服务只暴露给 NginxMySQL 不直接暴露到公网。不要在这个阶段引入复杂微服务在线考试系统属于典型的单体应用用 Spring Boot 3 做单体完全足够。Docker Compose 只是部署手段不等于工程化。如果项目要长期维护建议补上环境变量分离数据库密码不要写在代码仓库。数据库变更用迁移脚本管理而不是手动改表。接口层写冒烟测试至少覆盖“登录、开始考试、提交试卷、查询成绩”四条主链路。日志挂载到宿主机目录便于排查线上问题。这些工作看起来不产生页面功能但真正决定你能不能安心上线。7. 如果拿它练手或面试怎么避开误区7.1 不要被“八股文”带偏方向现在网上能看到很多 Java 基础、MySQL 安装、Spring Boot 面试题相关的内容背一背对找工作有一定帮助。但面试官不会只问“HashMap 原理”和“MySQL 索引结构”一定会追问项目经历。比如他会问你的考试系统怎么防止同一用户重复提交如果两个学生正好同时参加同一场考试数据库会出什么问题组卷后题目被删除历史成绩还准不准成绩统计的行转列是怎么实现的如果考试时间结束但学生没有点交卷后端怎么兜底这些问题的本质就是八股知识里的“状态机”“事务隔离”“唯一约束”“索引”“批量操作”在真实场景中的应用。把在线考试系统从头到尾做一遍会比只背“八股文”有用得多。7.2 推荐的三阶段学习路线第一个版本先单机跑通最小闭环。用户登录、考试列表、开始考试、答题、自动判分、成绩展示。这个版本能帮你理解 MVC 分层与前后端联调。第二个版本重点补状态和边界。增加试卷快照、交卷幂等、考试结束后强制交卷、权限控制。这个版本会帮你养成“从异常反推系统设计”的意识。第三个版本进入部署和运维。Docker Compose 部署、MySQL 备份、日志收集、基础性能优化。这个版本能让你在面试时讲出项目如何被真正使用而不只是自己电脑上能跑。7.3 判断一个考试系统成熟度的四个问题之后再看类似系统或自己复盘可以不用急着看功能页面多不多。抛四个问题给系统就能摸清它的成熟度学生刷新页面之后已经答过的题还能恢复吗学生连续点击交卷会不会产生多条成绩题库里的题目在考试结束后被修改历史试卷会变吗学生已经断网考试时间到了服务端能不能自动兜底交卷如果四个问题答案都是“能”这个系统基本能支撑正式考试。如果只是能答题但没有任何异常恢复那它更适合当 Demo不适合承担真实考务。如果你现在正准备用 Java Spring Boot 3 Vue.js 3 MySQL 做在线考试系统我建议不要一上来就写代码先把考试状态流转、试卷快照、幂等提交、异常兜底四个设计点想清楚。技术栈从来不是这个项目最大的门槛真正让人放心的是流程可控、数据可追溯、异常有备份。把这四个点做到考试系统就不会只是一堆页面而是一套能让人安心使用的工具。