从培训机构到企业内部，在线考试早就是刚需了，但真正把一套在线考试系统从零搭到能上线用，中间的细节远比想象中多。这套基于SpringBoot+Vue+MyBatis+MySQL的在线考试系统源码，不是一个demo级别的玩具，而是一套贴近真实业务场景的企业级管理系统：前台考生能登录考试、倒计时交卷、查成绩，后台管理员能维护题库、组卷、发布考试、人工阅卷、导出成绩。说白点，它就是一个小型化、完整闭环的教务考试平台。
这套东西适合谁来用？两类人最合适：一是刚学完SpringBoot和Vue、想找一个完整全栈项目练手或写进简历的同学，二是企业内部或培训机构的技术负责人——拿它改改就能用在月度考核、入职测评、知识竞赛这些场景。我见过不少人把这类源码下载下来就懵了，目录结构复杂，数据库脚本一执行报错，跑起来页面白屏，最后弃坑。所以这篇文章我不打算只贴功能清单，而是把架构选型、表设计、组卷逻辑、前后端联调、部署和排坑一次讲透。
1. 为什么是SpringBoot+Vue+MyBatis+MySQL这套组合
1.1 四个技术栈各干各的活
很多初学者拿到项目第一反应是“技术选型是不是太老了”。真不是。这套组合在目前的国内企业里仍然占据相当大的比例，尤其是中小型管理系统和内部平台，它属于“务实到极致”的选型。
简单类比一下：
SpringBoot负责后端“地基+水电”，把Spring的繁杂配置全部自动化，内嵌Tomcat，一个jar包就能起服务。它解决的最大问题是“启动快、集成爽、部署省心”。
MyBatis负责“跟数据库打交道”的活儿，手写SQL、动态SQL都很灵活。考试系统里最常见的就是按知识点、难度、题型组合条件查询试题，这类逻辑用MyBatis动态SQL写出来直观且可控，调优SQL也方便。
Vue负责前端页面和交互，组件化开发让考生端和后台管理端可以拆成两套界面，路由、状态管理、Axios请求这些生态配合得非常好。
MySQL负责存储所有业务数据，用户、题库、试卷、考试记录、成绩全在里面。它是目前最成熟稳定的开源关系型数据库，单机支撑几千人的同时在线考试完全没问题。
1.2 为什么不是JPA或者MyBatis-Plus
这是我要重点说的一点。现在的项目里，JPA、MyBatis-Plus确实越来越流行，但这一套选择MyBatis而不是框架更重的方案，是有明确考虑的。
第一，考试系统的查询场景非常复杂：组卷时要从题库里按题型、难度、知识点组合筛选，还要保证随机性和不重复，这种SQL需要精细控制。MyBatis的XML配置天然适合这种“手写SQL驱动”的需求，if、where、foreach这些动态标签能非常干净地拼接查询条件。
第二，MyBatis对SQL性能的可控性最好。JPA虽然开发效率高，但遇到复杂关联查询和分页时容易生成不够优化的SQL，出了问题你还得花时间反查它是怎么生成的。MyBatis的SQL是你自己写的，哪里慢直接看执行计划，对“考试系统”这种要求性能稳定的场景来说，这种确定性很重要。
第三，MyBatis的学习门槛低，一个后端团队里无论新人老人，拿到XML就能看懂SQL。MyBatis-Plus虽然提供了代码生成器和通用Mapper，但它的逻辑删除、乐观锁这些约定有时候反而会和业务中自定义的复杂SQL产生冲突，对于一套需要完全掌控细节的源码来说，原生MyBatis更稳。
2. 系统整体设计与核心模块拆解
2.1 数据库设计：十张表撑起一整套考试业务
拿到源码第一步不是急着启动项目，而是先看SQL脚本。这套系统的表设计非常规范，整体可以分为四大块：用户权限、题库、考试、作答记录。
用户权限这块至少有四张表：用户表、角色表、用户角色关联表、菜单表。角色不是写死在前端的，而是通过RBAC模型做权限控制。管理员、教师、考生其实全在用户表里，靠角色区分。
题库模块核心是试题表和试题类别表。试题表会记录题型（单选、多选、判断、简答）、难度级别、所属知识点、题干、选项（通常用JSON或分隔符存）、正确答案、分值。这里有个细节，选项不建单独的表，而是用JSON字段存储，对考试系统这种题目选项相对固定的场景，既省事又高效。
考试模块有考试表、试卷表、试卷题目关联表。考试表存考试名称、开始时间、结束时间、时长、总分、及格分、考试状态。试卷表和题目关联表是典型的“中间表”设计，试卷表只存一份试卷的基本信息，试卷题目关联表则记录这道试卷里有哪些题、每道题的分值、顺序和乱序规则。
作答记录模块有考试记录表和答题详情表。考试记录表记录考生是哪场考试、什么时候开始、什么时候交卷、客观题得分、主观题得分、最终成绩。答题详情表记录每一道题考生选的什么答案、是否正确、主观题得分是多少。这两张表是成绩统计和试卷复盘的基础。
2.2 权限模型：为什么不用Spring Security
管理端和考生端需要完全不同的页面和接口，这就要求权限控制必须做到“接口级别”。这套系统用的是自定义拦截器方式：登录成功后后端生成Token，前端每次请求带上Token，拦截器校验登录态，再通过用户角色判断该请求是否有权限访问。
为什么不直接用Spring Security？因为考试系统的权限模型相对固定，只要区分“管理员”“教师”“考生”三种角色就够了，Spring Security的过滤器链和配置方式对这个体量的项目来说反而是负担，学习成本高、配置复杂、出了问题排查也不直观。自定义拦截器配合一个角色注解，十几行代码就能实现同样的效果，维护起来很轻松。
这种方式有一个必须在实操中注意的点：任何需要登录的接口都要在拦截器的拦截范围内，但登录接口、验证码接口、静态资源必须排除在外，否则会把自己拦在外面。源码里的配置类或拦截器注册处一般会自带白名单，你改接口路径时要同步更新。
2.3 考试流程状态机：创建到归档的完整闭环
一套在线考试系统的业务核心是流程，不是CRUD。考试状态必须严格流转：草稿状态（管理员创建考试、配置试卷和考生范围）→ 发布状态（考生可以看到并进入考试）→ 进行中（考生开始答题）→ 已结束（系统自动交卷或管理员手动结束）→ 归档（成绩统计、试卷分析）。
我见过很多半成品系统就在状态上翻车，比如考试还没开始考生就能点进答题页，或者交卷后还能重复提交。这套源码在处理这个问题时用的是状态字段+时间判断双重校验：前端根据考试时间控制按钮显隐，后端接口再次校验当前服务器时间和考试起止时间，保证只靠改前端时间也钻不了空子。
考试记录表的状态也需要单独记录，待考试、考试中、已交卷、缺考这几种状态要清晰。交卷动作不是简单的update，而是一个事务操作：写入答题详情、计算客观题得分、更新考试记录状态、更新统计缓存或统计表，全部在一个事务里完成才能保证数据一致性。
3. 关键功能实现与实操细节
3.1 随机组卷怎么实现才公平又高效
组卷是在线考试系统的灵魂功能。手动组卷是管理员从题库里逐题勾选，适合小规模测试；随机组卷则是系统按规则自动抽题，更适合大规模考试。
这套源码里的随机组卷逻辑值得细看：管理员先设定试卷结构，比如单选题20道每题2分、多选题10道每题3分、判断题10道每题2分，然后限定知识点范围（比如从“第一章Java基础”和“第二章面向对象”里出），再限定难度比例（比如简单40%、中等40%、困难20%）。系统按这些条件生成SQL查询符合条件的题目集合，再通过RAND()函数随机抽取并保证不重复。
但这里就有一个高频性能问题：在题目数量很大的表上直接ORDER BY RAND()，随着数据的增多，排序会越来越慢。数据库要把所有符合条件的行都查出来，再随机排序，这在大数据量下非常消耗性能。
一个很实用的优化方案是：先用一个查询拿到符合条件的题目ID集合，然后用随机函数取偏移量，或者给题目表加一个随机数种子字段，按种子字段排序加上WHERE条件过滤。比如先查出最大ID，随机生成一个ID值，再LIMIT n取相邻区间。虽然不是绝对均匀随机，但性能提升明显，对考试组卷来说足够用。我在优化这类功能时通常会写一个专用的XML查询，用子查询先缩小范围再随机，实测效果很好。
3.2 倒计时与防止舞弊的落地做法
考试页的倒计时几乎是必备功能，实现时要注意“以服务器时间为准”，不能信任客户端时间。前端从后端接口获取考试结束时间戳，本地做倒计时显示，交卷时上传的也是服务器时间，否则考生调快或调慢本机时钟就能影响考试。
这套前端的倒计时组件一般使用setInterval每秒钟更新一次，同时监听到达结束时间后自动执行交卷动作。但setInterval有两个坑：一是浏览器切到后台后定时器会变慢，二是网络请求未完成时定时器仍在跑。比较稳的做法是：倒计时只在纯前端做视觉展示，真正的截止判断在后端接口完成。考生就算靠卡前端绕过倒计时，后端接口一收到提交请求就先校验时间，超时就直接拒绝。
防作弊这块系统通常提供几个层次的方案：一是IP限制，一个IP只允许一个账号参与同一场考试；二是考试中途禁止切出页面的前端监听，监听到visibilitychange事件就给出警告，但坦白讲，前端监听只能防小白，真正要严格防作弊还是得靠高级别监考工具；三是题目乱序和选项乱序，即不同考生拿到的题目顺序、选项顺序不同，这在源码里一般用随机算法在生成试卷时或前端展示时做。
3.3 自动判分与成绩导出的实现细节
客观题判分相对简单。考生提交答案后，后端遍历答题详情，拿每道题的答案和正确答案比对，单选判断直接匹配，多选则要校验选项集合完全一致，答错或漏选都不得分。判分逻辑在事务里一次性执行，把得分写入考试记录表。
主观题判分需要教师介入。后台通常会有一个待阅卷列表，教师逐题查看考生答案和评分标准，给分、写评语。这里有个细节：主观题采用流水阅卷还是整卷阅卷，在后台功能设计时要考虑清楚，简单系统一般按试卷整卷阅，复杂一点的需要做到按题目维度随机分配。
成绩导出这块源码一般会集成EasyExcel或POI。按考试ID或班级或部门筛选出成绩列表，一键导出为Excel文件。导出实现时要注意数据量大的情况，不能一次性把几万条数据全查出来放进内存，最好分页查询，边查边写，或者创建临时文件流式写入。还有一个小坑：导出文件的列名要用英文或中文标题，模板要对应，否则用户拿到Excel还要自己调整格式。
4. 实操过程：从源码到能跑起来的完整流程
4.1 环境版本匹配：最容易被忽略的坑
整套系统跑起来，最麻烦的往往不是代码本身，而是版本匹配。这个项目常规搭配是：JDK 1.8、Maven 3.6+、SpringBoot 2.7.x、Node.js 16+、Vue 2.6+、MySQL 5.7或8.0。
为什么要特意提版本？因为SpringBoot 3.x对JDK的要求是17+，很多老项目的依赖版本在SpringBoot 3.x下会直接报兼容错误，比如javax包名变成jakarta。如果你本机只装了JDK 17，又直接用了SpringBoot 3.x，那源码里的旧依赖极有可能编不过去。最稳的方案就是照着源码的pom.xml里的SpringBoot版本对应的JDK要求来装环境。
MySQL版本同样要注意，8.0和5.7的驱动依赖不一样，8.0的驱动类是com.mysql.cj.jdbc.Driver，5.7是com.mysql.jdbc.Driver。你下载的源码里如果用的是8.0驱动，本地却装了5.7数据库，只要连接串和驱动类能对上，其实也能运行，但要注意8.0默认使用 caching_sha2_password 加密方式，老版本客户端连接时可能会报认证失败。
4.2 后端配置与启动步骤
拿到源码后，第一步是导入数据库。打开Navicat或MySQL命令行，执行源码里SQL目录下的脚本。注意脚本执行顺序，一般先建库，再建表，最后插入基础数据，一次性全选执行也可以，但如果有外键约束，建表顺序错了会报错。建议挨个执行，出问题好排查。
第二步改配置。打开后端项目的application.yml或application.properties，把数据库连接的URL改成你本地的，用户名密码改掉。特别要说一个常见故障：连接字符串里的时区参数。MySQL 8.0以上的连接串建议写成：
spring: datasource: url: jdbc:mysql://localhost:3306/exam_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.DriverserverTimezone=Asia/Shanghai不加，很可能会报“The server time zone value ... is unrecognized”的错误；useSSL=false主要是避免SSL握手警告和连接失败；allowPublicKeyRetrieval=true是配合MySQL 8.0的认证方式用的，不加可能遇到Public Key Retrieval is not allowed。
第三步启动后端。在项目根目录执行：
mvn clean package -Dmaven.test.skip=true java -jar target/exam-system.jar如果打包遇到依赖下载慢的问题，可以给Maven配置阿里云镜像。启动后看到Tomcat started on port 8080，后端就起来了。后端通常不会有太多坑，真正容易出问题的是依赖版本冲突，解决方式就是看Maven依赖树，排除冲突项。
4.3 前端工程化配置与联调步骤
前端项目通常是个Vue CLI工程，也可能是Vite构建。在frontend目录下执行：
npm install npm run servenpm install如果报错，先看node版本是不是太高。如果你用的是Node 18甚至更高版本，老项目的Webpack 4构建会弹出OpenSSL错误：error:0308010C:digital envelope routines::unsupported。这是Node 17以后OpenSSL升级导致的兼容问题。解决办法两个：一是换Node 16版本，推荐用nvm管理Node版本；二是在package.json的scripts里设置环境变量：
"scripts": { "serve": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve", "build": "set NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service build" }Mac和Linux系统用export NODE_OPTIONS=--openssl-legacy-provider。
前端跑起来之后，需要和后端联调。本地开发一般用Vue CLI的代理转发解决跨域问题，在vue.config.js里配置：
module.exports = { devServer: { proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } } }如果你的前后端不在一台机器上，后端又没开CORS，那联调时请求会被浏览器拦截。生产环境最常见的方式是Nginx统一代理，后端接口路径和前端资源都走同一个域名，既解决跨域又兼顾部署。
4.4 前后端分离部署：Nginx配置一体化
考试系统上线部署时，建议用Nginx托管前端静态文件，同时反向代理后端接口。Vue项目执行npm run build后会生成一个dist目录，把这个目录放到服务器上，Nginx配置可以这样写：
server { listen 80; server_name exam.example.com; root /usr/share/nginx/html/dist; index index.html; location / { try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }try_files那一行是Vue Router的history模式必须配置的，否则刷新页面就会404。如果后端接口没有统一以/api开头，记得按实际路径调整location匹配规则。
后端部署直接用jar包运行，配合systemd或任意进程守护工具即可。如果数据库也在同一台服务器，记得检查MySQL最大连接数，并发考试时连接数不够会导致大量请求报错，一般把max_connections调高到500以上，再配合连接池参数一起调整。
5. 常见问题与排查技巧实录
5.1 MySQL连接时报SSL错误或认证失败
这个几乎是新环境必现问题。报错信息通常是Communications link failure、SSL connection error或Public Key Retrieval is not allowed。逐条排查：
- 连接串是否加了useSSL=false和allowPublicKeyRetrieval=true
- 连接串是否加了serverTimezone=Asia/Shanghai
- MySQL用户是否允许远程连接（如果是局域网部署，要检查用户表的host字段）
- 数据库版本和驱动版本是否匹配
处理顺序就是这样：先改URL，再查用户权限，最后查驱动。大多数情况下改URL就能消灭问题。
5.2 SpringBoot启动成功但接口路径404
这类问题典型的特征是：后端日志显示启动成功，前端页面也能打开，但登录请求报404或Failed to fetch。原因基本都在路径前缀。后端接口默认前缀可能是/context-path，也可能是控制器类上的@RequestMapping带了/api前缀，而前端axios封装的baseURL没对应上。
你要做的第一件事是打开浏览器F12看Network面板，看清楚实际请求的URL是什么，再看后端Controller的映射路径是什么，二者对齐就行。有时候是前端在/api下，后端也在/api下，但Nginx代理又把/api转发了一遍，变成/api/api，这种多层前缀叠加的坑我踩过不少次。
5.3 MyBatis查询报错或结果与预期不符
查询报错要区分是SQL语法错误还是参数绑定错误。SQL语法错误在控制台会打印完整的SQL和异常信息，看### Error querying database.后面的提示，一般能定位到XML文件的具体语句。参数绑定错误通常是#{}和${}用混了，#{}是预编译占位符，${}是字符串拼接，后者易引发SQL注入，写XML时要注意。
结果与预期不符，通常是驼峰映射没开。MySQL字段默认下划线命名，Java属性是驼峰命名，如果MyBatis没有开启mapUnderscoreToCamelCase，查出来的实体类字段就是null。配置很简单：
mybatis: configuration: map-underscore-to-camel-case: true5.4 前端页面加载不出来或白屏
页面白屏无外乎几种情况：一是dist目录路径不对，静态资源引用的是绝对路径导致404；二是路由模式是history但服务器没有配置try_files；三是JS报错，打开控制台能直接定位。
有一个容易被忽略的问题是本地开发一切正常，一打包部署到服务器就白屏，这种基本是publicPath的问题。Vue CLI打包时默认publicPath是/，如果你的项目部署在子路径下，就要改成相对路径：
module.exports = { publicPath: './' }改动后再build，dist目录里的index.html引用的资源路径就会变成相对路径，放到任意子目录都能访问。
5.5 拿到jar包想改代码怎么办
很多读者下载的不是完整源码，而是打包好的jar。想改代码最实用的做法是反编译。反编译工具有很多选择，界面上比较直白的是JD-GUI，命令行主力是CFR。将jar包反编译后会得到一整套java源码，导入IDEA后修修改改，再重新打包成新jar。
但这里有一个必须提醒的坑：反编译出来的源码不是100%可编译的。反编译工具会把一些语法还原成奇怪的形式，比如内部类、泛型、枚举会被打散，直接拿来编译大概率报错。我的经验是反编译仅用于排查问题和理解逻辑，真要长期开发还是得拿到原始工程。如果只是想改数据库连接、端口这些配置，根本不用反编译，用WinRAR解压jar包，修改里面的application.yml，再把文件替换回去就可以了。SpringBoot的fat jar支持这种覆盖方式，实测有效。
6. 这套源码还能怎么扩展
说实话，这套系统的核心价值在于“完整性”。题库、试卷、考试、判分、成绩统计、权限管理全链路打通，这已经覆盖了绝大多数企业内部考试场景。但如果你愿意继续折腾，有几个扩展方向非常值得做。
第一个扩展方向是视频监考。现在很多严肃考试要求远程监控，可以在考生端加视频采集和水印叠加，配合WebSocket推送考场状态到后台，实现多宫格监考画面。这个是当前在线考试的硬需求，但实现起来工作量不小，建议独立模块来做。
第二个扩展方向是成绩分析和试卷分析。现在系统大概率只做到成绩列表和简单统计，你可以继续做班级平均分、题目正确率、知识点掌握度分析，甚至用ECharts画雷达图和柱状图。这些功能对培训机构特别有用，能直观看到学员薄弱点。
第三个扩展方向是考试公告和消息通知。结合企业微信或钉钉机器人，把考试发布、成绩出炉、补考通知这些事件自动推送给考生，可以显著减少教务参与度。实现也不难，用一个事件监听器加HTTP回调就能搞定。
我还试过给系统加“练习模式”——考生可以随机刷题，做题立刻出答案和解析，并自动生成错题本。这个是在线考试系统的天然延伸，很多用户拿到手第一句话就问“能刷题吗”，可见需求很普遍。
最后再说一个我在实际使用中的体会：这类源码最重要的不是“跑起来”，而是“敢改动”。下载下来先通读一遍表结构和核心接口，自己画一遍业务流程图，再动手改掉其中一两个功能，比照着视频敲一遍代码学到的东西多得多。组卷逻辑、状态机设计、事务边界这三个地方，值得反复推敲。把这套系统吃透了，后面不管换什么技术栈做业务系统，思想都是相通的。
