SpringBoot+Vue在线考试系统毕设源码全解析：从环境搭建到权限控制

翻开你收藏夹里那一堆“毕设项目源码”，是不是都有这种感觉：唬人的项目名一堆，点进详情一看，要么缺模块，要么注释像是机翻，要么好不容易跑起来，一改就崩。今天聊的这个项目标题很直接，“SpringBoot+Vue 考试系统管理平台源码【适合毕设/课设/学习】Java+MySQL”，没有花哨包装，就是一套老老实实的全栈入门项目。我基于这个标题把源码结构和实现逻辑完整拆解一遍，顺便把从下载到本地跑通、再到改造成自己毕设会遇到的问题全部捋清楚，打算做考试类系统的直接参考这份就够了。

这个项目能做什么？简单说就是一个在线考试平台，核心是学生端考试、教师端组卷阅卷、管理员端管人管题管考试。技术上就是当下校园项目最常见的组合：SpringBoot做后端接口，Vue做前端页面，MySQL存数据，基于Java和Maven构建。适合三类人：正在准备Java后端岗位实习的在校生，毕设选题被分到“在线考试系统”或者类似教务类题目的应届生，以及想通过一个完整全栈项目串起Java、Vue、数据库三块知识自学的初学者。

1. 项目到底做什么，为什么值得选

1.1 先理清考试系统的边界和用户角色

很多同学拿到这个标题直接看代码，看半天看不懂。我的建议是先理清系统里有几种人，每种人能干什么，才不会在阅读代码时迷路。

考试系统管理平台基本逃不出三种角色，这套源码也不例外：

• 学生：登录、查看考试列表、进入考试、答题、交卷、查看成绩和自己试卷的得分明细。
• 教师：管理题库（增删改查题目）、创建试卷、组卷、发布考试、批改主观题、查看学生成绩统计。
• 管理员：管理教师账号和学生账号、管理班级/学院/专业信息、查看整体考试数据、系统参数配置。

把这三个角色的需求映射到代码上，你就会发现后端大部分Controller都是围着"角色权限+业务操作"这两件事转的。理解这个后再看代码，你才明白为什么有那么多@RequiresPermissions或者@PreAuthorize注解，为什么前端路由要用动态路由按角色渲染菜单。

1.2 为什么这套组合适合毕设、课设和学习

这可能是你选项目时要问的第一个问题。先说结论：在“能跑起来、能讲清楚、能过答辩”这三个评价标准里，SpringBoot+Vue+MySQL的组合是综合得分最稳的，没有之一。

先说学习维度。SpringBoot把SSM时代那堆繁琐的XML配置全干掉了，你写一个starter依赖再加个配置类，一个Web服务就能起来。Vue的双向绑定和组件化又直观又容易调试，写完立刻能在浏览器里看到效果。就算你这学期Java只学过基础课，用这套框架写出来的代码结构也足够你向面试官展示你对MVC、RESTful API、关系型数据库设计的理解。

再说毕设维度。毕设论文面对的是答辩老师，老师最看重的是“工作量够不够”和“是不是别人做的”。这套系统麻雀虽小五脏俱全，功能覆盖了管理系统的典型模块，数据库表设计、业务逻辑、权限控制、前后端交互都有实实在在的内容可写。你完全可以在它的基础上加一个功能，比如智能组卷、考试防作弊、成绩导出Excel，工作量一笑就上去了。

2. 技术栈选型和核心设计思路拆解

2.1 版本选择：SpringBoot 2.x还是3.x，Java版本怎么配

这是这套源码最容易让新手卡住的地方。先看后端版本，SpringBoot现在主流有两个大版本：2.7.x和3.x。

我强烈建议毕设项目选SpringBoot 2.7.x + JDK 8或JDK 11。原因很直接：

• 大部分网上下载的源码基于2.x，依赖兼容性最好，避免“springboot版本太高”导致的一系列有毒依赖问题。
• JDK 8和JDK 11是大多数学校机房和本地电脑的默认版本，你不用为了跑项目额外装JDK 17+。
• 3.x版本全面转向Jakarta EE，javax.*改成了jakarta.*，很多老代码复制过来直接编译报错，初查起来心态容易崩。

SpringBoot 2.7.18是2.x的最后一个版本，有维护兜底，用这个最保险。Maven构建时如果遇到依赖下载慢，记得换阿里云镜像，这个我在第4节具体说。

前端版本选择也很关键。这个项目如果是Vue 2，跟着Vue 2生态走，Element UI组件库最稳；如果是Vue 3，就用Element Plus。你可以打开源码里的package.json先看一眼，不要硬拿Vue 3的语法去写Vue 2的配置，新手把时间浪费在这种地方非常可惜。

2.2 前后端分离的职责划分：谁管页面，谁管接口

这套项目采用的是前后端分离架构，前端跑在localhost:8080（或者80）这类端口负责渲染页面，后端跑在localhost:8081这类端口负责提供接口，两边通过JSON格式数据交互。理解这个分离特别重要，因为它决定了你后面遇到的90%的问题都是"跨域"问题。

后端接口设计遵循RESTful风格，比如：

• POST /api/auth/login登录
• GET /api/exam/list考试列表
• POST /api/exam/{id}/start开始考试
• POST /api/exam/answer/submit提交答案
• GET /api/score/my我的成绩

前端只负责把这些接口返回的数据渲染成页面，不直接操作数据库。这一点可以和传统JSP模式对比：以前Java后端写的Java代码可以直接拼HTML，看着简单但代码互相纠缠，改个页面要重启服务。现在前后端分离，前端开发的时候起一个Node服务做热更新，后端团队只管接口，两边并行开发，这才是企业里真实的工作方式。

2.3 数据库设计：核心表之间怎么互相关联

数据库是这套源码的骨架，可以说后端80%的代码都在围着表转。一个正常的考试系统管理平台至少需要这几张核心表：

这个设计的巧妙之处在于用sys_user一张表统一存所有用户，再通过role字段区分身份，省去了建三张用户表的麻烦；用tb_paper_question这种关联表来解耦“试卷”和“题目”，将来你要换题、改分值就不用动试卷主表。

另外要重点提一下密码存储，我见过太多毕设源码直接把用户密码以明文存在数据库，答辩的时候老师一旦问起安全问题，场面会很尴尬。这套源码如果用了BCrypt加密，在登录验证时通过BCryptPasswordEncoder.matches()比对；如果发现是明文存储，建议你自己动手改成加密，这是成本最低的安全加分项。

3. 核心功能模块的实现拆解

3.1 登录认证与权限控制：不能只靠"前端隐藏按钮"

每个管理系统的地基都是登录认证和权限控制，考试系统尤其是。如果权限没做好，学生调用一个接口把自己成绩改了，整个系统就废了。

登录流程一般是这样：前端提交用户名密码，后端用UserDetailsService加载用户信息，校验密码后用JWT签发一个token返给前端。前端把token存在localStorage或者Vuex/Pinia里，之后每次请求都在请求头带上Authorization: Bearer <token>，后端通过拦截器或Spring Security过滤器在请求到达Controller之前先验证token和角色。

JWT里存什么很讲究，通常只存userId、username、role这类非敏感信息，签名密钥要足够复杂，过期时间一般设2小时。源码里如果用了Sa-Token或者Spring Security框架，你只需要关注它的配置类和注解即可。以Spring Security为例：

@Configuration @EnableGlobalMethodSecurity(prePostEnabled = true) public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) .and() .authorizeRequests() .antMatchers("/api/auth/**").permitAll() .antMatchers("/api/admin/**").hasRole("ADMIN") .antMatchers("/api/teacher/**").hasRole("TEACHER") .antMatchers("/api/student/**").hasRole("STUDENT") .anyRequest().authenticated(); } }

前端这边对应要做的事是在axios拦截器里统一加token。比如request.js这个文件是每个Vue管理系统必备的：

import axios from 'axios' import { getToken, removeToken } from '@/utils/auth' const service = axios.create({ baseURL: process.env.VUE_APP_BASE_API, timeout: 10000 }) service.interceptors.request.use(config => { if (getToken()) { config.headers['Authorization'] = 'Bearer ' + getToken() } return config }) service.interceptors.response.use(response => { return response.data }, error => { if (error.response && error.response.status === 401) { removeToken() location.reload() } return Promise.reject(error) }) export default service

很多同学跑通登录之后，前端路由还不受控，直接在router/index.js里把管理端页面全都写死，这不叫权限控制，叫“前端隐藏按钮”。正确的做法是根据登录用户角色，用router.addRoutes()动态添加路由，后端也要在接口层做二次校验，前端只是提升体验，后端才是最后一道闸门。

3.2 题库管理和试卷生成：随机组卷的算法细节

题库管理模块是系统内容的生产源头，也是课设答辩时老师最爱追问的模块。题目的增删改查本身不复杂，就是单表的CRUD，真正的难点在试卷生成策略。

最常用的策略有两种：手工选题和自动随机抽题。手工选题是老师在题库页勾选题目加入试卷并设置每题分值，这个逻辑简单，直接操作关联表即可。自动随机抽题就要写点算法了，要求支持按题型、按章节（课程）、按难度设置数量：

public List<PaperQuestion> autoGeneratePaper(GeneratePaperRequest req) { List<PaperQuestion> result = new ArrayList<>(); for (QuestionTypeItem item : req.getTypeItems()) { // 先按题型和难度筛选出候选题目 List<Question> candidates = questionMapper.selectCandidates( item.getType(), item.getCourseId(), item.getLevel()); if (candidates.size() < item.getCount()) { throw new ServiceException("题目数量不足，请扩充题库"); } // 随机抽取指定数量的题目，避免考过多次的题目重复出现在同一张试卷 Collections.shuffle(candidates); List<Question> selected = candidates.subList(0, item.getCount()); for (Question q : selected) { PaperQuestion pq = new PaperQuestion(); pq.setQuestionId(q.getId()); pq.setScore(item.getScore()); result.add(pq); } } return result; }

这里有两个细节值得注意。第一，抽题时先Collections.shuffle再取前N道，比每次随机取一条再判断是否重复的写法性能高得多，题目多的时候差距很明显。第二，题目表一定要有course_id和level（难度）字段，否则自动组卷就是无源之水，这也是数据库设计时容易被忽略的点。

题目类型这里，常见的是单选、多选、判断、填空、主观题。前三种适合机器自动判分，填空题要注意答案的容错匹配：不能只做字符串精确equals，要处理空格、中英文标点、大小写。

3.3 在线考试、倒计时、自动交卷：前端交互最重的模块

打开试卷进入考试页，你会面对整个系统里最需要细心处理的部分。考试时间到要自动交卷，学生刷新页面不能丢答案，离开页面要有提示，这些细节点处理得好不好，直接决定这个毕设项目的完成质量。

计时器这块，一定要用截止时间减去当前时间来维持倒计时，而不是单纯把每秒减一的数字存下来。因为前端定时器在浏览器休眠或切后台时会被节流，如果只靠累减计数，回来之后时间就不准了。正确做法：

const endTime = new Date(examInfo.endTime).getTime() // 或者从接口拿到 startTime 和 duration 自己算 endTime const timer = setInterval(() => { const remain = Math.floor((endTime - Date.now()) / 1000) if (remain <= 0) { clearInterval(timer) submitExam() // 自动交卷 } currentTime.value = remain }, 1000)

答题状态保存有两种路线。简单路线是每做一题就调一次保存接口，实时写到后端缓存表，刷新后还能从后端拉回来，但考试期间请求频率很高，对新手来说要处理好异步竞态和接口防抖。省事路线是先把答案存在前端状态里，交卷时一次性提交，缺点是学生刷新页面会丢数据，体验不太好。我的建议是核心岗位或正式考试场景用“实时保存”，课设项目如果时间紧用“交卷统一提交”，并在答辩时主动说出你的取舍理由，反而显得思考有深度。

交卷按钮和离开页面拦截也不能忘。页面路由切换到其他地址前，用beforeRouteLeave守卫弹出确认框；监听window.addEventListener('beforeunload')阻止用户误关页面；答题卡的进度高亮，有助于用户在交卷前快速检查未做的题目。

3.4 自动阅卷与成绩统计：后端最见功底的模块

在线考试的阅卷分两块：客观题自动判分，主观题教师人工评分。一套源码做得好不好，重点就看客观题判分的实现是否严谨、主观题评分流程是否完整。

客观题判分最忌讳的写法是把学生答案和标准答案直接equals之后判等，因为多选和判断题的“漏选、错选、全对”得分规则不一样。更好的思路是把答案标准化之后比较集合。比如单选，标准答案是A，学生答Bb，这是不能给分的。多选题的得分策略常见两个版本：只要和标准答案完全一致得满分、否则加入“少选给一半分”的规则。解题流程是把题目的标准答案按分隔符拆成Set，再把学生的作答作为一个Set，最后统一比较。

public boolean checkMultiChoice(String standard, String studentAnswer) { if (standard == null || studentAnswer == null) { return false; } Set<String> standardSet = splitAnswer(standard); Set<String> studentSet = splitAnswer(studentAnswer); return standardSet.equals(studentSet); }

主观题如果只提供“教师能看到学生答案和参考答案，自己手动打分”，这已经及格了。想加分可以参考猿题库的做法：后台先按关键词命中情况给出一个建议得分区间，教师在页面上微调并填写评分理由，这个理由学生端可见。在成绩统计模块，按课程、按班级、以及按时间维度的平均分、及格率、最高分统计，都是加分项。用MyBatis的<select>里直接写聚合SQL和分组就能做出来，不需要额外引入报表框架。

4. 环境搭建与本地运行全流程

4.1 环境准备：JDK、Maven、Node、MySQL版本匹配

新手在环境上卡的坑，远超代码本身。先说结论，这套项目推荐的环境组合：

• JDK：1.8 或 11。安装后在终端验证java -version。
• Maven：3.6.x或3.8.x。设置M2_HOME和PATH，并修改settings.xml里的阿里云镜像。
• Node：14.x或16.x。Vue 2项目尤其要避开Node 18以上的版本，后端和node-sass有版本兼容问题。
• MySQL：5.7或8.0。推荐8.0，大部分现成sql脚本都兼容。

这几个工具安装顺序无所谓，但要注意PATH配置，mvn -v和node -v能输出版本号才算成功，在控制台看到'mvn' 不是内部或外部命令这种提示，通常是环境变量没配置好。MySQL安装完成后，通过命令行或者Navicat都行，把源码附带的exam.sql导入数据库。注意如果sql里带有create database exam语句，导入前不用自己手动建库；导入后刷新一下表列表，看到十几张表基本就成功了。

4.2 后端启动：核心配置文件和第一个报错

SpringBoot项目导入IDE（IDEA或Eclipse）之后，重点打开application.yml文件看这三个配置块：

server: port: 8081 spring: datasource: url: jdbc:mysql://localhost:3306/exam?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 你自己的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

这三个地方是新手必炸区。port改成8081是为了和前端分开端口；password必须和本地MySQL一致，否则报Access denied for user；JWT相关配置、文件上传路径配置一般也在这个文件里。如果是SpringBoot 3.x版本，连接MySQL 8.0不需要手动写driver-class-name，但MySQL 5.7需要。

数据库版本和驱动不匹配也会报错，常见错误是Public Key Retrieval is not allowed，解决办法是连接串后面加allowPublicKeyRetrieval=true。启动类是主类名带Application的那个Java文件，右键Run就启动，日志末尾出现Started ExamApplication in x.xxx seconds字样才是成功。

4.3 前端启动：npm安装依赖和跨域处理

前端目录结构一般是/exam-ui或/frontend，进入该目录先执行npm install。这里有个经验：如果你在国内，最好配置npm镜像：

npm config set registry https://registry.npmmirror.com

依赖安装完成后，npm run dev，默认会在8080端口弹出页面。登录失败先别怀疑代码，绝大多数是跨域问题。浏览器里打开开发者工具，看到No 'Access-Control-Allow-Origin' header或cors error就是跨域。

跨域解决有三种常见方案，从最简单到最规范排列：

1. 后端加个配置类，该方法适合全栈开发阶段。

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOrigins("http://localhost:8080") .allowedMethods("*") .allowedHeaders("*") .allowCredentials(true); } }

2. 前端脚手架代理：在vue.config.js里配置devServer.proxy，把/api开头的请求转发到http://localhost:8081。

3. 登录后才能访问的接口返回401：注意前端proxy方式不需要后端配置Cors，但把前端打包后放到后端同源部署时，Cors又变回“不需要”的状态，因为同源。

4.4 前后端部署集成：把dist文件夹放进SpringBoot

前面说过前端开发调试用npm run dev，上线部署时要用npm run build，前端会生成dist目录，里面是静态文件。要把它们集成到后端，最简单的方式是复制dist里的内容到后端的src/main/resources/static目录，然后打成jar包，这样直接用Tomcat内置服务器跑一个端口就够，还消除了跨域问题。

如果部署环境里需要改后端接口地址，前端代码里就不要把baseURL写死，可以用.env.development和.env.production两个文件来区分开发和生产环境。Vue CLI项目里默认规则是：开发环境读.env.development，生产环境读.env.production。这一点答辩的时候主动提到，会让老师觉得你有真实部署经验。

5. 常见问题与排查技巧实录

5.1 启动报错速查表

按我接触过的学生项目经验，70%的问题都集中在下面这四类，直接对照排查。

这里说一个新手最容易忽视的问题：@MapperScan的扫描包路径。如果你的Controller里注入了QuestionMapper，但@MapperScan("com.xxx.mapper")里的包名和实际Mapper包路径不一致，Spring容器就会找不到Bean，报错信息却杂乱到让你怀疑数据库，其实只是包名拼写问题。检查顺序建议是：application.yml → Mapper扫描路径 → SQL脚本 → 依赖冲突。

5.2 MySQL连接和编码：乱码、时区、SSL错误

这个模块能遇到的报错种类几乎每个学生项目都逃不掉。MySQL连接串建议直接抄这份：

jdbc:mysql://localhost:3306/exam?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true

其中characterEncoding=utf8解决中文乱码，serverTimezone=Asia/Shanghai解决时区相差8小时，useSSL=false解决MySQL 8.0默认开启SSL导致的手握证书报错。如果你在“另存为sql脚本后导入”这一环节出现乱码，用Notepad++或VS Code把文件“转为UTF-8编码”，再重新导入，简单有效。

5.3 修改源码时需要注意的坑

拿到源码后，大多数人第一件事就是改完部署，然后各种新bug一个接一个。这里提醒几个我要重复一百遍的注意事项：

• 修改数据库密码时，不要把连接串里的password留空，否则大概率会解析报错。
• 在application.yml里不要用server.port=8081这种properties写法，这个项目如果是yml格式，就保持缩进对齐。
• 前端路由跳转报404，可能是Vue Router的history模式和后端接口路径冲突。
• 修改了后端代码以后，如果前端登录请求返回数据还是旧的，清掉浏览器缓存，或者看看后端服务是否真的重新编译了。

5.4 数据不对、成绩不显示这类“软”问题的排查思路

比启动报错更折磨人的是“能跑，但结果不对”。比如自动阅卷成绩单显示0分，或者某个学生报名了考试却查不到考试成绩。面对这类问题，第一优先级是看前端Request请求的URL和后端路径是否对得上，第二是看接口返回的JSON结构里对应字段是不是改了名字，第三才怀疑数据库数据不对。用Postman或Apifox直接调接口，一边调一边看SQL日志（MyBatis开启log-impl后控制台会打印SQL），基本能定位到问题去改SQL还是改前端判断逻辑。

6. 从“能跑”到“好答辩”：扩展点和学习建议

6.1 性价比最高的几个扩展功能

这个项目的骨架很全，但要想在答辩时拿出差异化，可以从以下方向人为“造工作量”。挑选一两个加进去，配合对应的表设计和接口说明，可以让整个项目深度上一个台阶：

• Excel导入导出：题目批量和学生信息批量导入，用EasyExcel或POI实现。这个功能很有展示性，老师非常认可。
• Redis缓存验证码：登录加图形验证码，验证码存Redis并设置过期时间。
• 考试防作弊：切换页面超过一定次数自动交卷、考试中途随机抓拍（如果摄像头权限允许的话）这些功能确实能成为答辩亮点。
• 成绩分析报表：用ECharts做雷达图展示知识点掌握情况，或者用柱状图展示班级平均分对比。

6.2 论文写作和答辩的思路参考

毕设论文核心框架建议按这个结构搭：绪论 → 相关技术介绍 → 系统需求分析 → 系统设计 → 系统实现 → 系统测试 → 总结。源码本身对应的内容，在“系统设计”章节画E-R图和用例图，“系统实现”章节配合核心模块截图写实现逻辑，“系统测试”章节用功能测试用例表格覆盖。答辩时一定不要停留在“我做了登录、查询、添加功能”这种流水账，老师更想听的是：你遇到过什么问题、怎么定位问题、为什么用这个方案。

答辩常见的几个补充问题，你可以提前准备：为什么选JWT不选Session？解决跨域的机制是什么？自动组卷的随机算法怎么避免重复？多选漏选怎么计分？MySQL里一道题和一张试卷的关联怎么设计？每个问题都不深，但都能看出来你是否真正理解了代码，所以不要满足于“能跑”。

6.3 学习路线的最后一步：复盘和改造

下载源码跑起来只是第一步，真正有价值的是把项目里的某个模块删除重置，再凭自己的记忆重新实现一遍。比如把试卷生成模块从项目中拆出来，自己重新写一次Service层的代码，然后再对照源码看差距在哪。这个过程前期会比较痛苦，但比背十遍八股知识点扎实得多。

关于学习节奏，我的建议是：先花半天把环境跑通，再花一天读通表结构，再花两天从登录到考试走通一个完整链路，最后花一周做扩展和写论文。不用太贪心，一个系统里真正参与到的业务闭环——登录、考试、判分、出成绩——完整走一遍，对Java全栈的理解绝对比你单独看Spring Boot也好、单独学Vue也好要深得多。

我自己带过的同学里，有不少人一开始连Autowired都看得半懂，做完考试系统后能直接跟面试官讲清楚Spring Security的过滤器链和组件化前端路由的加载过程。这套源码的“学习”价值就在这里：它不高大上，但恰好覆盖了企业里管理系统开发中最常出现的那些套路。拿到它之后，与其收藏吃灰，不如尽快启动起来，跑通一遍再动手改一版，然后就可以放心地把它变成你自己的项目了。