最近在整理一套可以交付的考试系统源码后台用 SpringBoot前台用 Vue数据库是 MySQL压箱底的东西翻出来重新捋了一遍感觉这套组合对正在做毕业设计、或者公司内部想快速搭一套在线考试平台的朋友来说省事程度是直接拉满的。源码拿到手不是光能跑而是能改、能扩、能看懂这才是“可直接运行”四个字真正的价值。这套系统解决的核心问题很直接传统纸质考试从出题、印卷、发卷、监考、收卷、阅卷到成绩统计流程长、人工成本高、出错概率大。尤其到了期末或者公司培训考核几百号人同一时间考试光试卷分发和监考调度就够折腾的。而线上考试系统能把整个闭环搬到网页上管理员在后台上传题库、组卷、发布考试考生登录即可答题交卷后客观题自动判分成绩实时汇总连试卷分析都能一键导出。整个过程数据留痕、权限分明比人工操作省下不止一个量级的时间。这套源码里的技术选型也很有意思。SpringBoot 负责后端接口和业务逻辑Vue 负责前端页面渲染和交互MySQL 负责数据持久化这是目前 Java 全栈领域最经典也最稳的组合。没有引入太多花里胡哨的中间件不依赖微服务架构部署门槛低一台普通服务器甚至本机就能跑起来。对我来说这种“刚刚好”的架构反而比高大全的分布式方案更值得推荐——学习成本低、排错容易、二次开发的空间大。下面我把这套系统的核心设计、模块功能、数据表关系、运行步骤和自己踩过的坑完整理一遍照着操作的话从零到跑起来大概只需要半小时。1. 系统整体设计与技术选型思路1.1 为什么是 SpringBoot Vue MySQL 这套组合技术选型这事不同阶段有不同答案。如果让我从零设计一套生产级考试系统可能会考虑 Spring Cloud 微服务、Redis 缓存、消息队列这些东西。但作为一套面向毕业设计、课程设计、中小型企业内部使用的源码SpringBoot Vue MySQL 的组合是最务实的。SpringBoot 的价值在于它把 Spring 家族繁琐的 XML 配置全部干掉自动装配机制让项目初始化变得极快。对于考试系统这种业务逻辑集中在 CRUD 和简单事务处理的应用SpringBoot 自带的 spring-boot-starter-web、spring-boot-starter-data-jpa 或 MyBatis-Plus 完全够用不需要人为引入分布式事务、服务注册发现这些重型武器。Vue 作为前端框架核心优势是响应式数据和组件化开发。考试系统中倒计时、题目切换、选项选中状态、答题卡联动这些场景天然适合 Vue 的响应式特性。用 Vue 组件去封装题目卡片、倒计时条、成绩单表格复用性极高。比如单选题组件、多选题组件、判断题组件、填空题组件分开写组卷的时候按题型去引用对应组件代码结构非常干净。MySQL 更不用多说考试系统的核心数据是结构化的用户表、角色表、题目表、试卷表、考试记录表、答题明细表都是典型的关系型数据模型。MySQL 的事务特性和 ACID 保证在提交试卷这种需要同时更新多张表的场景下特别重要。比如考生点击交卷后端要同时写入考试记录状态、逐题写入答题明细、更新总分和正确率这三步必须在一个事务里完成否则就会出现“记录显示已交卷但答题明细没存上”的脏数据。1.2 单体架构如何支撑完整业务闭环这套系统的架构设计走的是经典的前后端分离单体部署模式。后端是独立工程前段是独立工程中间通过 RESTful API 通信最终打包部署时可以分开部也可以前端打包后丢进 SpringBoot 的 static 目录做成一个 Jar 直接跑。我特别推荐后一种部署方式尤其适合课程设计和给非技术人员演示。前端执行 npm run build 后dist 目录里全是静态文件直接把整个 dist 文件夹复制到后端 src/main/resources/static 下重新打包 SpringBoot 工程一个 java -jar 命令就能启动整个系统不需要单独配 Nginx也不需要处理跨域问题——因为前端静态资源和后端接口同源浏览器根本不会触发 CORS 策略。这种单体架构的另外一个好处是调试方便。开发阶段前端工程用 npm run serve 起在 8080 端口后端 SpringBoot 起在 8081 端口通过 Vue CLI 的 proxy 配置把 /api 前缀的请求代理到 8081前后端分开调测互不干扰。上线前再合并打包一套代码两种跑法非常灵活。角色权限设计这块系统采用了经典的 RBAC 模型即用户-角色-权限三级结构。管理员、教师、考生三种角色各司其职管理员负责系统配置和用户管理教师负责题库维护、试卷组卷和考试发布考生只能参加考试和查看自己的成绩。权限校验通过 JWT Token 实现登录成功后后端返回签名 Token前端存储在 localStorage每次请求带上 Authorization 头后端拦截器统一校验。这个方案实现成本低、效果可靠适合中小型系统。当然如果要求更细粒度的权限控制可以在拦截器里配合注解做接口级别鉴权源码里也留了扩展点。1.3 这套源码适合什么人能学到什么如果你正在做 Java 课程设计、毕业设计或者想从零入门全栈开发这套源码的学习价值非常突出。它能让你看到一条完整的技术链路前端页面如何发起请求、后端接口如何接收处理、MyBatis 或 JPA 如何操作数据库、数据又是如何回显到页面上。从登录鉴权到考试交卷每个环节都是教科书级的真实案例。更重要的是这套源码的代码风格和命名规范比较整洁没有一堆无意义的复制粘贴。Controller 只负责参数接收和结果封装Service 层处理业务逻辑Mapper/Repository 层做数据访问分层清晰。对照着源码去理解三层架构比看任何理论书籍都来得快。2. 核心功能模块与数据表设计的细节拆解2.1 功能模块地图从登录到试卷分析的完整链路把功能模块拆开来看系统可以分为前台考生端和后台管理端两块后台再细分为管理员和教师两个视角。模块之间不是孤立存在的而是通过数据流转和页面跳转串联成完整闭环。考生端功能包括用户注册与登录支持用户名密码登录注册时默认分配考生角色。考试列表展示当前可以参加的考试、进行中的考试、已结束的考试。在线答题支持单选、多选、判断、填空四种题型题号导航可以快速跳转已答题目有高亮标识。倒计时功能页面顶部实时显示剩余时间时间到自动交卷。我的成绩考试结束后查看客观题得分、主观题得分和总分管理员或教师阅卷后可看到最终成绩。个人信息修改修改密码、维护个人基础信息。后台管理端功能包括用户管理管理员可以查询、新增、禁用用户分配角色。题库管理支持按科目分类维护题目批量导入导出支持 Excel 模板导入。试卷管理手动组卷、随机组卷两种方式。手动组卷是逐题从题库选择随机组卷是设置每种题型的数量后由系统随机抽题。考试管理创建考试、关联试卷、设置考试时间、选择参考班级或指定考生。阅卷管理对主观题人工评分评分后自动汇总考生总分。成绩统计按考试维度查看成绩分布、平均分、最高分、及格率支持导出 Excel。系统监控简单的登录日志和操作日志记录。2.2 关键数据表之间的血缘关系数据表设计是这套系统的地基我把核心表逐一列出来理解了表之间的关系整个系统的业务逻辑就通了一半。用户表字段包括用户ID、用户名、密码、真实姓名、角色、部门/班级、邮箱、手机号、状态、创建时间。这是全系统的身份基础。题目表是整个题库的实体字段包括题目ID、科目ID、题型、难度、题干内容、选项A到D针对选择题、正确答案、解析、分值、创建人、创建时间。这里的正确答案字段对客观题自动判分至关重要。试卷表与试卷题目关联表属于组合关系。试卷表记录试卷名称、总分、考试时长、组卷方式。试卷题目关联表记录试卷ID、题目ID、题目在试卷中的序号和该题分值。为什么要单独设计关联表而不是在试卷表里直接存一串题目ID因为题目可能被多张试卷引用多对多关系必须用中间表解耦否则数据维护会非常痛苦。考试表是连接考生与试卷的桥梁。字段包括考试ID、考试名称、关联的试卷ID、开始时间、结束时间、考试状态、创建人。这里的考试状态由后端定时任务或时间判断动态更新比如当前时间在开始时间和结束时间之间考试状态就是“进行中”。考试记录表记录的是某位考生参加某场考试的宏观信息包括考试记录ID、用户ID、考试ID、得分、交卷时间、考试用时、状态未完成、已交卷、已阅卷。这张表配合试卷表可以快速统计一场考试的参与人数、平均分、及格率。答题明细表是考试系统的核心表字段包括明细ID、考试记录ID、题目ID、考生答案、是否得分、得分分值。阅卷时就是扫描这张表客观题和题库表里的正确答案比对得分主观题由人工评分后回填分值。交卷事务里最关键的操作就是批量写入这张表。这几张表的关系可以用一句话概括用户通过考试表参加考试考试表关联试卷表考生交卷后生成考试记录考试记录下面挂着一堆答题明细答题明细再关联到题目表取回正确选项做判分。数据流是单向递进的非常清晰。3. 核心业务逻辑实现与原理解析3.1 登录鉴权和 JWT 的设计细节登录鉴权模块我花了不少心思。最初版本用的是传统 Session 方案登录成功后把用户信息放进 Session前端通过 Cookie 携带 SessionID 维持会话。但前后端分离模式下Session 方案会有跨域问题而且移动端、多端登录场景下体验不佳于是换成了 JWT。JWT 的逻辑是这样的用户提交用户名和密码后端校验通过后生成一个 Token。Token 由三部分组成头部声明加密算法和类型载荷存放用户ID、用户名、角色、过期时间签名用密钥对头部和载荷做 HMAC-SHA256 加密。前端把 Token 存起来后续每个请求通过 Authorization 头带回。后端用一个拦截器读取 Token、验证签名、解析载荷从中拿到当前用户身份去执行业务。这套机制里有个小坑值得说Token 是无状态的后端不存储 Token 记录所以一旦签发在过期之前无法主动让它失效。解决方式有两个一是设置较短的过期时间比如两小时前端在 Token 快过期时用刷新 Token 重新获取二是在后端维护一个 Token 黑名单把注销的 Token 丢进 Redis。考虑到这套系统的定位我用的是偏简单的方式Token 有效期 24 小时用户修改密码后所有旧 Token 失效。为什么修改密码能废掉旧 Token因为 Token 载荷里带了用户密码的版本标记密码一变标记对不上旧 Token 自然验证失败。3.2 组卷算法随机组卷如何确保不重复且覆盖知识点随机组卷是考试系统里最容易出 bug 的地方之一。最简单的实现是查询题库全部题目然后用随机函数抽 N 道。但这样有两个问题一是可能抽到重复题二是性能差题库上万道题时一次性查出来内存开销不小。更稳妥的做法是利用 SQL 的 ORDER BY RAND() 来随机排序后取前 N 条。比如要随机出 5 道单选题SQL 可以写成 SELECT * FROM question WHERE type SINGLE AND subject_id ? ORDER BY RAND() LIMIT 5。MySQL 在处理这个查询时会对符合条件的记录生成随机数再排序数据量不大时性能可以接受。但题目量超过几万时这个查询会全表扫描并用临时表排序性能瓶颈明显。优化思路是先随机取 ID 范围再回表查询或者用一张随机数映射表做预洗牌不过考试系统通常不会到百万级题库ORDER BY RAND() 够用了。随机组卷还有一个隐藏需求知识点覆盖。如果纯粹随机可能出现五道单选题全考同一个知识点的极端情况。为此我加入了知识点权重的概念题目表里维护一个知识点字段组卷时先按知识点分组每个知识点至少抽取一题剩余题目再全局随机。这样既保证了覆盖面又不至于让组卷算法复杂到不可维护。手动组卷的逻辑相对简单教师从题库列表中勾选题目设置每题分值然后入卷。不过有一个点需要处理试卷的题目顺序应该固化不能因为后续往题库里加题或删题而影响已发布试卷。这就靠前面说的试卷题目关联表固化了题目快照试卷一旦发布关联表的数据就是最终版本不随题库变化。3.3 交卷事务与自动判分的核心逻辑考生点击交卷按钮的瞬间后端要处理的逻辑是整套系统里事务最密集的地方。流程可以拆成四步第一步校验考试时间和交卷合法性。如果考试已结束或重复提交直接拒绝并返回错误信息。第二步创建考试记录。写入用户ID、考试ID、交卷时间状态设为已交卷。如果之前已经有未完成的考试记录要把旧的记录逻辑删除或标记作废避免同一个人对同一场考试产生多条有效记录。第三步逐题处理答题明细。前端把答题数据封装成 JSON 数组传到后端后端遍历数组对每道题判断题型。客观题直接和题目表中的正确答案比对一致则得分主观题先把答案写入答题明细得分暂记为 0等待人工阅卷。第四步计算客观题总分并更新考试记录。这里需要先查询试卷题目关联表获取每题分值再统计客观题得分总和写入考试记录表的“客观题得分”字段。如果试卷全是客观题交卷后直接就是最终成绩如果含主观题则需要等待教师阅卷后补上主观题分数再汇总总分。整个流程必须放在一个事务里任何一个环节异常都要整体回滚。可以生动一点理解事务的概念就好像你要一次性往桌面上叠五个碗如果第三个放上去时歪了整个五个碗都得撤下来重新摞不能留三个歪歪扭扭的碗在桌上。数据库事务的原子性就是保证这五步要么全成功要么全失败。前端交卷还有一个体验问题防止误触。我在交卷按钮上做了二次确认弹窗提示“还有 N 题未作答确认交卷吗”并且交卷接口做了幂等处理同一考生同一考试的重复交卷请求只会生效一次。3.4 倒计时与考试状态的动态管理倒计时功能看似简单实现却有几个容易翻车的细节。最开始我打算直接把结束时间戳传给前端让前端用 setInterval 每秒计算剩余时间。但这里有个致命问题前端本地时间是可以被改的考生把电脑时间调后两小时倒计时立刻失效。正确做法是后端在进入考试时返回服务器的当前时间戳和考试结束时间戳前端用差值做倒计时这样本地时间修改不会影响到倒计时。更严格一点的方案是前端定时向后端发送心跳请求让后端校验时间差一旦发现本地时间与服务端偏差过大就强制交卷。考虑到实现复杂度我采用了第一种方案同时在后端交卷接口里再次校验服务器时间双保险。考试状态字段有几种未开始、进行中、已结束。由于考试的开始和结束时间是由管理员配置的而系统没有一个常驻的定时任务去扫描更新状态我是通过一个状态计算方法动态判断的。每次查询考试列表时拿当前时间和考试的开始、结束时间做比对实时得出状态。这样做的好处是省去了定时任务缺点是列表接口不能对考试状态字段建索引做查询。在数据量不大的场景下动态计算完全可行。4. 从零到部署完整运行步骤与本地环境搭建4.1 环境准备JDK、Maven、Node.js、MySQL 的版本选择这套源码的运行环境我建议按照以下版本去准备能少走很多弯路。JDK 建议用 1.8 或 11。SpringBoot 如果用的是 2.x 版本JDK 8 完全兼容如果源码版本是 SpringBoot 3.x那必须 JDK 17 以上。拿到源码后先看一眼 pom.xml 里 spring-boot-starter-parent 的版本号再决定装哪个 JDK。Maven 需要 3.6 以上。Maven 的作用是统一管理 Java 依赖包pom.xml 里写了什么依赖Maven 会自动从中央仓库下载。如果下载慢可以换成国内镜像源这个后面细说。Node.js 版本要注意和 Vue CLI 的兼容性。Vue 2 项目一般用 Node 14 或 16 没问题Vue 3 Vite 项目建议 Node 16 以上。安装 Node 时自带 npm后续用 npm 安装前端依赖即可。MySQL 建议 5.7 或 8.0 版本安装时字符集选 utf8mb4不然存不了中文表情符号。这里要留意数据库连接驱动版本MySQL 5.7 和 8.0 的驱动类名略有差异源码里如果配置的是 com.mysql.jdbc.DriverMySQL 8.0 下会报驱动类找不到要改成 com.mysql.cj.jdbc.Driver。4.2 数据库初始化与配置文件的修改技巧工程里应该自带 exam.sql 或 init.sql 这类数据库初始化脚本用 Navicat 或命令行执行就能建库建表并且会写上几条管理员测试账号。执行脚本后最好自己实际登录一遍确认初始化数据插入成功。接下来修改后端的配置文件。SpringBoot 工程里配置文件名一般是 application.yml 或 application.properties需要修改的关键项是数据源配置。包含地址、端口、数据库名、用户名、密码。这里有一个经常被忽略的点url 地址里的参数要带时区设置。MySQL 8.0 的时区默认是 America/New_York如果不在连接串里加 serverTimezoneAsia/Shanghai启动时控制台会报时区相关的异常查询出来的时间也会差 8 到 13 个小时。修改完后端配置还需要确认后端启动端口。默认一般是 8080 或 8081如果本机端口被占用可以改 server.port 换一个。前端工程里如果配了反向代理代理目标地址要和后端端口保持一致。4.3 后端启动步骤与前端构建打包的完整过程后端启动流程不复杂。用 IDEA 打开后端工程等待 Maven 自动下载依赖。首次下载依赖可能耗时较长如果卡住不动检查 Maven 的 settings.xml 里是否配置了阿里云镜像。依赖下载完成后直接运行主类里的 main 方法启动 SpringBoot 应用控制台出现 “Started ExamApplication in x.xxx seconds” 就说明启动成功了。此时在浏览器访问后端接口地址比如 http://localhost:8080/api/ping应该能看到返回的 JSON 数据。前端启动分开发模式和生产模式两种。开发模式下进入前端工程目录执行 npm install 安装依赖然后执行 npm run serveVue CLI 会启动一个开发服务器默认在 localhost:8080 端口。此时需要确认前端项目里 vue.config.js 的 devServer.proxy 配置是否把 /api 开头的请求转发到了后端端口否则页面能打开但接口全部 404。生产模式的处理更简单执行 npm run build等待打包完成dist 目录下就是所有静态资源文件。把这些文件复制到后端工程的 src/main/resources/static 目录下重新打包 SpringBoot 工程用 java -jar exam-system.jar 命令直接启动浏览器访问 http://localhost:8080 就是完整的系统界面。4.4 账号体系初始化与第一场考试的配置流程系统跑起来后第一步是用管理员账号登录后台。账号信息可以在 SQL 脚本里找到一般是 admin/admin123 之类。登录后建议先修改默认密码再创建教师账号。接着创建科目。考试系统的题库是按科目分类管理的先有科目才能有题目。科目信息包括科目名称、编码、所属部门或年级创建后题库管理页面就能按科目筛选题目。然后往题库里导入题目。除了手工逐条添加系统多半支持 Excel 批量导入。这里要注意模板格式第一行是表头必须和系统要求完全一致比如“题型”、“题干”、“选项A”、“选项B”、“正确答案”、“分值”列顺序不能错。导入时最容易踩坑的是题型字段的枚举值写法有的系统要求填 SINGLE有的要求填“单选题”写错就会导入失败。题库有货之后创建试卷。先设置试卷名称、总分、时长然后选择手动组卷或随机组卷。手动组卷从题库勾题可以给每道题单独设置分值随机组卷设置好题型题量后由系统抽题。试卷保存后可以进行预览检查题目顺序和分值是否正确。最后创建考试。考试需要关联试卷设置开始时间和结束时间指定参考考生。发布考试后考生账号登录系统就能在考试列表中看到这场考试时间到了即可进入答题。到此一套完整的考试流程就跑通了。5. 常见部署问题与避坑指南5.1 启动报错的排查思路后端启动崩溃是最常见的问题先把几类高频报错列出来。SpringBoot 启动时找不到数据源通常是数据库连接失败。先检查 MySQL 服务是否在运行再用命令行测一下账号密码能否正常登录最后核对配置文件里的地址、端口、库名、用户名、密码是否完全正确。如果是在云服务器上部署还要注意 MySQL 端口有没有在安全组里放行。Maven 依赖下载失败导致项目无法编译。排查方法查看 settings.xml 是否配置了镜像查看本地仓库最后下载的文件是否有 .lastUpdated 后缀的残留文件如果有要先删除再重新下载。前端 vue.config.js 的代理配置写错导致接口 404。排查方法先不开启代理直接用浏览器访问后端接口地址确认后端正常工作然后检查代理路径和后端 Controller 的 RequestMapping 前缀是否一致。常见错误是前端请求 /api/login但后端接口是 /login少了前缀。5.2 前端报错的经典问题与处理方案前端报错相对复杂因为问题可能出在依赖、代码、配置多个层面。我建议按以下顺序排查。npm install 安装依赖时出现 ERESOLVE 错误说明依赖版本冲突。解决方式有两种一是把 package.json 里的依赖版本号调整到兼容区间二是使用 npm install --force 强制安装。不过强制安装可能带来运行时问题不是首选方案。页面打开空白但控制台报 JavaScript 错误。打开浏览器开发者工具看具体报错内容常见的是某个组件没注册、路由路径写错、接口返回数据结构和页面预期不一致。后两者比较常见。接口数据结构不一致时用 Network 面板查看响应体和后端 Controller 返回的字段做比对修正前端字段名即可。跨域报错 Access-Control-Allow-Origin。如果前端通过代理访问后端不会跨域如果前端直接请求后端后端需要开启 CORS 配置。SpringBoot 里可以用 CrossOrigin 注解或全局 CORS 配置类解决。报这个错的时候先确认请求是不是真的走了代理——有时候前端打包部署后和接口不同源也会触发跨域。5.3 部署上线时的数据库时区与字符集设置上线部署和本地运行有个容易被忽视的差异服务器数据库的默认时区可能不是中国时区。连接串里一定要带 serverTimezoneAsia/Shanghai否则所有时间字段的存取都会偏差。另外如果 MySQL 的字符集不是 utf8mb4中文数据写入时会变成问号。建库时明确指定 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci表和字段如果没有单独指定会走库级默认值。还有一个容易被忽略的点是数据库的 max_allowed_packet 参数。Excel 批量导入大题库时单条 SQL 可能比较大如果这个参数默认值太小会出现 PacketTooBigException。临时修改可以用 SET GLOBAL max_allowed_packet 64M永久修改需要改 MySQL 配置文件并重启服务。5.4 考试过程中考生端异常的应对策略考试过程中最怕考生答题中途断网、误关页面、设备故障。这套系统在异常恢复上做了几层防护。答题数据防丢失。考生每答完一题前端会自动把答案存入 localStorage。如果页面被误关重新打开后会提示恢复未交卷的考试从本地缓存里找回答案状态。不过 localStorage 缓存和服务器数据可能不一致所以交卷时仍然以服务器最终收到的数据为准。考试重进与续考机制。如果考生考试中途断网重新登录后系统会检查是否存在未交卷的考试记录存在则允许继续考试但已流逝的倒计时不会重置。这部分逻辑要注意如果考生可以无限重置倒计时考试就失去意义了。提交超时处理。倒计时归零时前端会自动触发交卷请求。如果此时断网请求失败后端会如何兜底我的做法是后端在考试结束时间之后仍然允许交卷接口接受该场考试的答卷但只延后五分钟超过五分钟则拒绝并视为超时未交卷。这意味着前端自动交卷失败后考生重新联网还有机会补交但窗口很短保障服务器数据一致性的同时给了考生操作余地。6. 进阶扩展方向与二次开发建议6.1 加入 Redis 缓存提升高并发考试能力如果要把这套系统用在几百甚至上千人同时在线考试的场合数据库压力会成为瓶颈。这时候引入 Redis 缓存是性价比最高的优化方案。Redis 能做的事很多缓存考试配置信息比如考试和试卷的关联关系变化少可以缓存起来减少数据库查询用 Redis 存储 Token 让登录鉴权变成可主动失效的状态做计数器比如统计实时在线考试人数利用 Redis 的 SETNX 实现分布式锁防止同一考生重复交卷。改造思路也不复杂引入 spring-boot-starter-data-redis 依赖把数据访问层中高频查询的方法加上缓存注解交卷事务里用 Redis 分布式锁保护同一用户的交卷请求即可。需要注意的是Redis 中缓存的数据要做失效处理否则题库修改后试卷缓存里还是旧题目。6.2 前端接入富文本编辑器提升题目表达能力原生方式存储题干的缺点很明显不支持图文混排、公式渲染、代码高亮。为了解决理科考试和编程类考试的需求可以接入富文本编辑器。比较适合的方案是 wangEditor 或 TinyMCE。wangEditor 轻量、中文文档友好、上手快适合把图片以 base64 形式存入数据库或上传到服务器后存图片地址。TinyMCE 功能更全能处理复杂排版但配置项多学习成本高一些。富文本编辑器的引入不只是改前端后端存储字段也要配合调整。题目表的题干字段类型如果数据库是 MySQL建议改成 MEDIUMTEXT 或 LONGTEXT因为 HTML 格式的题干比纯文本大得多。另外要注意 XSS 防护富文本内容里可能包含 script 标签存储和渲染时必须过滤危险标签否则会引发存储型 XSS 攻击。6.3 对接 MinIO 实现考试附件资源统一管理系统升级到一定规模后考试相关的附件资源比如富文本里插入的图片、Excel 导入的临时文件、考生上传的答题附件需要一个统一的对象存储服务来管理。MinIO 是开源的轻量方案兼容 Amazon S3 接口部署简单社区也活跃。SpringBoot 整合 MinIO 也很简单引入 minio 依赖配置 Endpoint、AccessKey、SecretKey封装一个文件上传下载的工具类然后在题目编辑、考生附件上传等场景调用。前端上传文件后拿到文件 ID提交表单时只提交 ID数据库存的就是一个引用而不是二进制数据这能显著减小数据库体积。6.4 成绩导出与可视化报表的增强初始版的成绩统计是简单的列表加基础表格如果想让系统更完整可以增加可视化报表功能。后端生成统计数据前端用 ECharts 展示成绩分布直方图、各科目通过率对比图、试卷难度分布图甚至可以做班级成绩雷达图。后端统计接口的核心是聚合查询用 MySQL 的 GROUP BY 和 AVG、MAX、MIN 等聚合函数就能完成。比如按分数段统计人数可以用 CASE WHEN 配合 GROUP BY 实现。前端拿到统计数据后初始化 ECharts 实例type 选择 bar、pie、radar 对应不同图表。这套扩展在源码的“成绩分析”模块基础上做增量修改即可不会破坏原有逻辑。7. 个人经验与项目交付的几点建议代码能跑起来和代码能交付是两码事。在这个项目上我倾注了很多时间也在反复给别人讲解的过程中沉淀了一些思路。如果你打算拿着这类系统去完成毕业设计或者作为商业项目交付有几件事值得提前做。数据库初始化脚本一定要写得干净。给别人看的项目第一印象往往不是代码质量而是环境能否搭起来。SQL 脚本要包含完整的建库、建表、初始数据语句注释写清楚。账号密码用加密后的字符串但要在文档里注明明文值方便别人登录。接口文档要同步维护。哪怕是后端 Controller 的注释也行但最好有统一的 API 列表写清楚每个接口的请求方式、参数、返回值示例。你永远想象不到接手的人会在哪个接口上困惑一份完整的接口文档能让交付体验提升一大截。代码里的魔法值要消灭掉。所谓魔法值就是直接写在代码里的数字或字符串常量不解释的话没人知道什么意思。比如状态字段 0、1、2最好定义成枚举类命名成 EXAM_NOT_STARTED、EXAM_IN_PROGRESS、EXAM_FINISHED可读性立竿见影。最后再分享一个很实际的小技巧。如果你打算用这套系统做演示预先准备一个“满配”演示环境题库里塞满上百道题、建好三五张试卷、设置一个正在进行中的考试、注册几个考生账号并放几条考试成绩。然后在演示时只需要登录、点进考试列表、展示在线答题和成绩统计十分钟就能让观众完整感受到系统的能力边界。而不要从建题库开始操作那会花掉大量演示时间观众也容易失去耐心。考试系统这种项目业务场景明确技术栈通用做得好就是能实实在在解决痛点的工具。这套源码的架构和设计给我最大的感受是技术不在于多新多复杂关键在于能否把一个业务闭环完整落地。SpringBoot、Vue、MySQL任何一项单独拎出来都不是稀缺技术但组合在一起配上一个清晰的数据模型和完整的事务保障就能撑起一套可以交付使用的考试平台。照着这个思路去扩展、去优化、去填自己的业务细节才是这套源码真正的价值所在。