从培训机构到企业内部在线考试早就是刚需了但真正把一套在线考试系统从零搭到能上线用中间的细节远比想象中多。这套基于SpringBootVueMyBatisMySQL的在线考试系统源码不是一个demo级别的玩具而是一套贴近真实业务场景的企业级管理系统前台考生能登录考试、倒计时交卷、查成绩后台管理员能维护题库、组卷、发布考试、人工阅卷、导出成绩。说白点它就是一个小型化、完整闭环的教务考试平台。这套东西适合谁来用两类人最合适一是刚学完SpringBoot和Vue、想找一个完整全栈项目练手或写进简历的同学二是企业内部或培训机构的技术负责人——拿它改改就能用在月度考核、入职测评、知识竞赛这些场景。我见过不少人把这类源码下载下来就懵了目录结构复杂数据库脚本一执行报错跑起来页面白屏最后弃坑。所以这篇文章我不打算只贴功能清单而是把架构选型、表设计、组卷逻辑、前后端联调、部署和排坑一次讲透。1. 为什么是SpringBootVueMyBatisMySQL这套组合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.Driver5.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?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.DriverserverTimezoneAsia/Shanghai不加很可能会报“The server time zone value ... is unrecognized”的错误useSSLfalse主要是避免SSL握手警告和连接失败allowPublicKeyRetrievaltrue是配合MySQL 8.0的认证方式用的不加可能遇到Public Key Retrieval is not allowed。第三步启动后端。在项目根目录执行mvn clean package -Dmaven.test.skiptrue 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。逐条排查连接串是否加了useSSLfalse和allowPublicKeyRetrievaltrue连接串是否加了serverTimezoneAsia/ShanghaiMySQL用户是否允许远程连接如果是局域网部署要检查用户表的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: ./ }改动后再builddist目录里的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回调就能搞定。我还试过给系统加“练习模式”——考生可以随机刷题做题立刻出答案和解析并自动生成错题本。这个是在线考试系统的天然延伸很多用户拿到手第一句话就问“能刷题吗”可见需求很普遍。最后再说一个我在实际使用中的体会这类源码最重要的不是“跑起来”而是“敢改动”。下载下来先通读一遍表结构和核心接口自己画一遍业务流程图再动手改掉其中一两个功能比照着视频敲一遍代码学到的东西多得多。组卷逻辑、状态机设计、事务边界这三个地方值得反复推敲。把这套系统吃透了后面不管换什么技术栈做业务系统思想都是相通的。