Java在线考试系统源码实战：从环境搭建到防作弊改造

简介：这是一份 Java 语言实现的在线考试系统源码，后端整合 Spring MVC、MyBatis、FreeMarker，前端结合 Bootstrap、jQuery 与 Vue.js 完成页面渲染和数据交互，适合正在完成课程设计、毕业设计，或希望了解传统 Java Web 与前端 MVVM 整合方式的开发者。压缩包共包含 332 个文件，其中 Java 类 47 个、HTML 页面 22 个、CSS 样式 69 个、JavaScript 脚本 58 个，还包含 SQL 数据库脚本、XML 工程配置、项目说明文件等，压缩后大小 10.33MB；整体结构按照后端代码、前端页面、静态资源等进行了分类，目录层级明确，便于快速定位功能模块对应的代码或样式文件。从文件结构看，项目覆盖了在线考试常见的用户、试题、考试、成绩等业务模块，代码分层相对清晰，并保留了数据库初始化脚本，可快速搭建可运行环境，同时便于在此基础上扩展新功能；通过查看 Java 源码与前端页面，可以较好地理解 Spring MVC 的请求处理流程、MyBatis 的映射配置以及 Vue.js 与后台的数据交互方式。这份源码包已有 1111 人学习/下载，对于需要现成 Java Web 项目参考的开发者来说，能够节省从零搭建框架的时间，具有较强的实用价值。

1. 这份Java在线考试系统源码，能撑起课设答辩，也能做小型上机考试工具

很多同学下载这份 Java在线考试系统源码 的动机，我太清楚了：课程设计或毕业设计需要一个能演示、能答辩、能写进报告的完整项目；也有小团队想拿它做单位内部的上机考试系统。无论哪种，你真正要解决的都是同一件事：线上考试不是发一份网页问卷那么简单，它要同时管住题库、组卷、答题、判分、成绩这五个环节，还得考虑学生中途切走页面、交卷丢成绩这些细节。

这套源码包的价值不在某个功能多惊艳，而在于角色分明、流程闭环。你拿到手要做的事也很清晰：先把环境跑通，再把代码链路读懂，然后把默认题库换成你自己的，最后把几个致命坑堵上。下面按这个顺序一步步来，新手能跟得动，熟手也能直接跳到第5章看排错。

2. 把zip变成本地能跑的项目：JDK、Maven、MySQL版本匹配与启动命令

先把丑话说在前面：这类源码包能不能跑起来，九成取决于环境而不是代码。忘掉“直接双击运行”的幻想。按下面的顺序走一遍，能避掉80%的环境坑。

2.1 解压与目录识别：先花两分钟判断这是什么架构

拿到zip先别急着扔进IDEA。第一步是解压，然后把目录结构看清楚。

unzip Java在线考试系统源码.zip -d exam-system cd exam-system tree -L 2 -d

看输出结果就能判断架构：有src/main/java和resources/application.yml，一般是Spring Boot单体应用，自带Maven构建；如果出现src/main/webapp，多半是老式JSP+Servlet项目，要部署到外部Tomcat而不是直接run；还有一种前后端分离版本，前端目录放的是Vue或Layui的静态资源，后端是纯接口工程，这种会多一层目录。不要急着改代码，先确认类型再选启动方式，这是血泪经验。

tree -L 2 -d表示只列两层目录、只看文件夹。不加-d会把target里的class文件全部刷出来，干扰判断。接着看根目录有没有README或sql目录：

ls -la ls sql/

sql目录里一般放着建库脚本（exam.sql或init.sql），README里通常会写默认账号。如果都没有，就去resources下找application.yml，看数据库配置里的库名。这一步很关键，因为很多老脚本的默认账号是admin/123456，而不是你猜的root。

2.2 JDK与Maven匹配：一个报错就把你卡半小时

这类源码绝大多数跑在JDK 1.8上，少数近两年的版本用JDK 17。先确认你本机的版本和项目要求是否一致。

java -version mvn -v grep -A 3 "<parent>" pom.xml | head -20

java -version看当前PATH下的JDK；mvn -v里也有一行Java version，那是Maven实际使用的JDK，两者必须一致，否则编译时会出现“一个JDK编译、另一个JDK运行”的怪问题。最后一条命令看pom.xml里的Spring Boot父工程版本：Spring Boot 2.x要求JDK 1.8，Spring Boot 3.x要求JDK 17。课程设计源码包里九成是2.x，如果你电脑装的是17，后面那个“源发行版 17”的报错就在等你了。老项目不要硬升JDK，装回1.8最省事。

再配Maven镜像。国内直接拉中央仓库会卡到怀疑人生，配置在~/.m2/settings.xml里。

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <url>https://maven.aliyun.com/repository/public</url> </mirror>

这段写在<mirrors>节点内。mirrorOf写*表示所有依赖都走这个镜像，代价是某些冷门依赖镜像里没有，再换回中央仓库。id随便起，url建议用public聚合仓，它同时代理了central和jcenter。

2.3 数据库初始化：建库、导脚本、统一UTF8

MySQL 5.7或8.0都能跑，关键在驱动和连接串。先手动建库再导脚本，比直接在脚本里改库名更可控。

mysql -uroot -p -e "CREATE DATABASE IF NOT EXISTS exam_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;" mysql -uroot -p exam_db < sql/init.sql

第一条命令把库建好，字符集直接指定utf8mb4，避免后面中文乱码。第二条把脚本导进去。注意看导入过程有没有报错，特别是外键约束报错——很多脚本建表顺序是乱的，被引用表还没建就执行了外键语句，这种情况把建表语句按依赖顺序手动调整，或者干脆把外键那行注释掉。

然后改数据库配置。老源码包的项目名五花八门，但配置文件的字段基本一样：

spring: datasource: url: jdbc:mysql://localhost:3306/exam_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver

逐个说参数：characterEncoding=utf8保证JDBC读写中文正常；serverTimezone=Asia/Shanghai解决MySQL 8下的8小时时差；allowPublicKeyRetrieval=true是MySQL 8的caching_sha2_password认证插件需要的，不加会报Public Key Retrieval is not allowed。如果driver-class-name写的是com.mysql.jdbc.Driver，说明依赖里是MySQL 5.x驱动，连5.7没问题，连8.0建议换成上面这个cj驱动。

2.4 启动与登录验证：看到登录页才算跑通

Spring Boot项目直接打包启动。

mvn clean package -Dmaven.test.skip=true java -jar target/exam-*.jar

第一行跳过测试打包，课程设计源码里的测试类经常写坏，跳过能少报一堆错。第二行用jar方式启动，绕开IDEA里各种花式配置差异。看到Started ExamApplication in x.x seconds说明服务起来了。老式JSP项目则要打war包丢进Tomcat的webapps目录，启动Tomcat后看日志不再报错再访问。

打开浏览器输入http://localhost:8080，如果配置了server.servlet.context-path，就在后面加路径（比如/exam）。默认账号别在登录页瞎猜，去数据库里查最准——这一步的具体SQL在第4章。

提示：8080端口被占用时，先lsof -i:8080看是谁占的，再决定改端口还是杀进程。这是环境问题，不是项目问题。

3. 读懂核心模块的三个链路：登录鉴权、随机组卷、自动判分

跑通只是起点。想答辩时讲清楚原理，想把系统改造成自己的，必须读懂代码里的三条主链路。按业务顺序来：登录、组卷、答题判分。

3.1 登录鉴权：三套角色怎么区分，session里存了什么

登录模块的Controller逻辑一般是这个套路：

@PostMapping("/login") public Result login(@RequestBody LoginRequest req, HttpSession session) { User user = userMapper.findByUsername(req.getUsername()); if (user == null || !passwordEncoder.matches(req.getPassword(), user.getPassword())) { return Result.error("用户名或密码错误"); } session.setAttribute("loginUser", user); session.setAttribute("role", user.getRole()); // 1管理员 2教师 3学生 return Result.ok(user); }

这里做了两件事：一是查用户后比对密码摘要，二是把用户对象和角色写进session。密码比对用passwordEncoder.matches()而不是把数据库密码取出来equals，是因为表里存的是MD5或BCrypt摘要，原始密码不可见。你应该顺着代码找一下拦截器，一般有个LoginInterceptor，检查session里有没有loginUser，没有就重定向到登录页。

角色值别靠记，去看SysRole枚举或user表字段注释。三个角色的功能边界是：学生进考试中心和成绩查询，教师进题库和阅卷，管理员进系统设置和考试发布。前端靠登录返回的role字段控制菜单显示，后端接口再校验一次权限——两层都做缺一不可，只靠前端隐藏菜单等于裸奔。

3.2 随机组卷：为什么考试开始前要把试卷“落库”

组卷分两种：固定试卷和随机组卷。固定试卷就是试卷题目表里一行行把题目选好；随机组卷只存规则，考试发布时按规则抽题。抽题时机的选择是代码里比较讲究的点。

简单实现是学生点“开始考试”那一刻临时抽题，这样每个学生拿到的题都不一样。常见做法是考试发布后由管理员触发，为每个学生生成一份独立试卷并落库。核心方法大概长这样：

public void assignPaperToStudent(Integer examId, Integer studentId) { List<PaperRule> rules = paperRuleMapper.findByExamId(examId); for (PaperRule rule : rules) { List<Question> questions = questionMapper.randomPick( rule.getSubjectId(), rule.getQuestionType(), rule.getQuestionCount()); for (Question q : questions) { paperQuestionMapper.assignStudentQuestion( examId, studentId, q.getId(), rule.getScore()); } } }

两层循环，外层遍历组卷规则（比如单选20题、多选10题、简答4题），内层按规则随机抽题并写入试卷题目表。关键点：随机抽题发生在考试开始前，而不是交卷时。这样学生交卷后试卷是冻结的，复查时能看到自己当时抽到的原题。如果抽题放在查询时临时拼，会出现“查成绩时题目变了”的离谱事故。

配套的SQL是抽题核心：

<select id="randomPick" resultType="Question"> SELECT * FROM question WHERE subject_id = #{subjectId} AND question_type = #{questionType} AND status = 1 ORDER BY RAND() LIMIT #{count} </select>

ORDER BY RAND()在小数据量时足够简单，上万条题目时性能很差，因为MySQL会对全表排序。做课设无所谓，拿去支撑真实考试就要改成先查最大id再用随机偏移量定位。status = 1表示只抽启用状态的题目，避免把草稿题发给学生。

3.3 自动判分：客观题机改，主观题不要硬判

判分逻辑是答辩高频考点。原则是：单选、多选、判断交给程序比对，填空题可以按文本精确匹配，简答题必须留给教师人工阅卷。强行用关键词匹配判简答题，会在答辩时被老师问住。

public void judgeObjective(List<AnswerDetail> details) { for (AnswerDetail d : details) { Question q = questionMapper.findById(d.getQuestionId()); if (q.getQuestionType() <= 3) { boolean correct = q.getAnswer().equalsIgnoreCase(d.getStudentAnswer()); d.setScore(correct ? d.getFullScore() : 0); } else { d.setStatus(2); // 待阅卷 } answerDetailMapper.update(d); } }

这段能跑的前提是题库表里answer字段存的是规范格式：单选题存“B”，多选题存“ABD”，判断题存“T”或“F”。比较时用equalsIgnoreCase是个细节，不然学生填小写b会被误判。多选题最坑：学生答案顺序和标准答案不一致时，直接equals会判错，比较前最好把字符串拆成List再containsAll。

3.4 考试记录与成绩表：先落库还是先返回

交卷接口最容易写错。做过一次你就会记住：成绩更新必须先落库再返回前端，而且要用事务。一次事务内完成：更新考试记录表的状态和总分、批量写入答题明细、提交事务。如果先把结果算出来返回给前端再异步落库，用户一关浏览器，下次查成绩就是0分。这个黑匣子问题每年都有人答辩翻车。

记录状态一般用数字字段表示：

exam_record表负责总账：谁考的哪场、多少分、什么状态；answer_detail表负责明细：每道题学生答了什么、得了多少分。两表共用exam_id和user_id关联。重点是时序：插入record → 插入detail → 更新score，三件事必须在一个@Transactional方法里，缺一个都可能导致“总分对不上明细分”。

4. 把默认题库改造成你自己的：核心表结构、初始化SQL与数据隔离

跑通和看懂之后，真正的活开始了：把项目里自带的示例数据换成你自己的题目和科目。这一步决定答辩时老师问你“这套系统你自己改了多少”时的底气。改之前的核心原则是：先备份原库，再动手，避免把联军数据搞坏。

4.1 核心表关系：一张图拆成文字

这类考试系统的表结构大同小异，核心表就六张：用户表、科目表、题库表、考试表、试卷关联表、考试记录表。想快速定位，在SQL目录里搜：

grep -n "CREATE TABLE" sql/init.sql

一次性列出所有建表语句，很快能看到哪些是主业务表。常见命名：sys_user、subject、question、exam、paper_question、exam_record、answer_detail。如果脚本分散在多个.sql文件里，就逐个grep。

表之间的关联靠外键或逻辑字段：用户表用role区分身份；题库表通过subject_id关联科目；考试表通过exam_id挂接试卷；试卷表通过paper_question表把题目关联进来；考试记录表通过exam_id和user_id记录“哪场考试哪个考生”。在纸上把这几个关联画一遍，代码里的Mapper就全对上了。

4.2 建表细节：考试记录表必须有的唯一索引

特意单独看建表语句，这是数据安全里最容易被忽略的一环：

CREATE TABLE `exam_record` ( `id` bigint NOT NULL AUTO_INCREMENT, `exam_id` bigint NOT NULL COMMENT '考试ID', `user_id` bigint NOT NULL COMMENT '考生ID', `score` int DEFAULT '0' COMMENT '总分', `status` tinyint DEFAULT '0' COMMENT '0考试中 1待阅卷 2已完成', `submit_time` datetime DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_exam_user` (`exam_id`, `user_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

UNIQUE KEY的意思是：同一个用户在同一场考试只能有一条记录。没有这个约束，学生多点几次交卷，就可能出现多条记录，成绩展示时不知道取哪条，甚至第二次提交的0分覆盖第一次的真实得分。这是这类系统最常见“成绩丢失”事故的根源。前端做防重复点击只是体验优化，数据库唯一约束才是后悔药。

4.3 初始化题库：往question表插自己的题

换掉示例数据，最直接的方式是先看题目表字段，再按字段插入。

INSERT INTO subject (subject_name, teacher_id) VALUES ('Java核心基础', 2); INSERT INTO question (subject_id, question_type, content, option_a, option_b, option_c, option_d, answer, difficulty, score, status) VALUES (1, 1, '下列哪个是Java的基本数据类型？', 'String', 'int', 'Integer', 'Object', 'B', 1, 2, 1);

这是最朴素的单条插入。实际改造时不要手写几千条SQL，常见做法是先在Excel里整理题目，再用脚本批量生成INSERT，或者用Navicat的导入功能。注意答案字段和判分逻辑强相关，错一个字符学生就白考了。插入前确认subject_id对得上，插完跑一句检查：

SELECT q.id, q.content, q.answer, s.subject_name FROM question q JOIN subject s ON q.subject_id = s.id LIMIT 20;

这条查询把题目和科目串起来，看有没有题目挂到不存在的科目下。如果出现脏数据，随机组卷时抽题SQL会静默过滤掉，试卷题量不足，更麻烦。

4.4 数据隔离：教师只能出自己科目的题

改题库前先想清楚权限。如果只有一个管理员账号，那无所谓；但系统里有教师角色，就必须考虑A老师能不能看到B老师的题。常见做法是加一张关联表：

CREATE TABLE teacher_subject ( id bigint NOT NULL AUTO_INCREMENT, teacher_id bigint NOT NULL, subject_id bigint NOT NULL, PRIMARY KEY (id), UNIQUE KEY uk_teacher_subject (teacher_id, subject_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这张表表达“教师和科目的多对多授权关系”。题库列表查询时，在SQL里join它，只返回该教师有权限的科目下的题目。没有这张表的简化源码，通常会在question表加creator_id字段，按创建人过滤。两种都行，但关联表更灵活——一个老师可以带多门课。答辩时主动讲出这层数据隔离设计，比堆功能更拿分。

对应查询的Mapper改造：

SELECT q.* FROM question q INNER JOIN teacher_subject ts ON q.subject_id = ts.subject_id WHERE ts.teacher_id = #{teacherId} ORDER BY q.id DESC

#{teacherId}要从登录用户的session里取，不要信任前端传参。有些源码的坑是登录后不存用户id，查询时让前端把teacherId作为参数传进来，接口一旦被调用者知道参数名，就能看别人的题。至少要做到：教师id从服务端会话取。

5. 跑不起来和成绩不靠谱：5个高频问题的排查记录

这一章写给那些对着报错日志发愁的同学。每个问题都是实际见过的翻车场景，按“现象→原因→解决”三步写，直接对照着排查。

5.1 启动即报“源发行版 17 需要目标发行版 17”

现象：mvn编译或IDEA构建时报java: invalid source release: 17或“源发行版 17 需要目标发行版 17”。

原因：当前JDK是17，而项目本身是Spring Boot 2.x、为JDK 1.8写的；反过来也可能项目要求高版本JDK但机器是1.8。本质是JDK版本和编译参数对不上。

解决：先确认项目的Spring Boot版本。如果是2.x，直接装JDK 1.8并把三个位置切过去：IDEA的Project Structure里Project SDK、Maven Runner的JRE、系统环境变量JAVA_HOME。同时改pom：

<properties> <java.version>1.8</java.version> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties>

这三组配置分别控制Spring Boot插件、Maven编译源码版本、编译目标字节码版本。统一成1.8后一般就好。如果项目是Spring Boot 3.x，那只能换JDK 17，因为3.x在字节码层面就不支持1.8，光改<java.version>糊弄不过去，运行时照样报错。

5.2 Maven依赖下载不动，卡在Downloading

现象：编译时一直卡在Downloading https://...，最后报Could not resolve dependencies。

原因：默认中央仓库从国内访问不稳定，或本地仓库里缓存了损坏的lastUpdated标记文件。

解决：先配阿里云镜像，然后清理本地仓库标记文件：

find ~/.m2/repository -name "*.lastUpdated" -delete

Maven下载失败后会在本地仓库留下*.lastUpdated空文件，下次构建时看到这个文件就认为依赖已存在，直接跳过下载，于是越报越错。删掉后重新mvn clean package即可。如果公司内网有私服，把settings.xml里的<mirror>换成私服地址。判断依赖是否下载完整，看~/.m2/repository里对应groupId目录下有没有_remote.repositories文件。

5.3 页面中文全是问号

现象：登录页和题目页面中文正常，但提交的答案、新增的题目在页面上显示成???或乱码。

原因：三个环节至少一个没统一字符集——页面文件编码、数据库表字符集、JDBC连接串。

解决：按顺序排查。先看页面源文件编码，老项目很多是GBK，用IDEA打开文件右下角转为UTF-8；再看数据库表字符集，执行SHOW CREATE TABLE question确认是utf8mb4；最后确认JDBC url里有characterEncoding=utf8。三段统一后重启。

注意：如果数据已经以错误编码写入数据库，改完配置后乱码依旧，说明写进去的字节本身就是错的。先备份数据，再重导一次，别指望改配置能修复历史脏数据。

5.4 交卷成功成绩为0或重复提交记录丢失

现象：学生交卷前端提示成功，教师端看成绩是0；或者同一学生考试记录出现多条，状态混乱。

原因：交卷接口没有做幂等。第一次交卷正常，第二次交卷带空答案再次进入判分逻辑，把score更新成了0；或者表上没有唯一索引，插入了多条record。

解决：先加唯一索引，再在Service层做“先查后判”。

ALTER TABLE exam_record ADD UNIQUE KEY uk_exam_user (exam_id, user_id);

ExamRecord old = recordMapper.findByExamIdAndUserId(examId, userId); if (old != null && old.getStatus() != 0) { throw new BizException("已交卷，请勿重复提交"); }

唯一索引是数据层兜底，代码判断是业务层提示，两者同时做才稳。注意判断条件是status != 0而不是“记录存在就拒绝”，因为考试中途可能有自动保存的进行中记录，状态是0，这种要放行。

5.5 考试时间对不上，整体差8小时

现象：管理员设置9点开考，数据库里看着也是9点，学生端到点却进不去，日志显示服务器时间是凌晨1点。

原因：JVM默认时区、MySQL连接时区、操作系统时区三者不一致，最常见是连接串没写serverTimezone，驱动用UTC时区，和东八区正好差8小时。

解决：改连接串是最快的：

url: jdbc:mysql://localhost:3306/exam_db?serverTimezone=Asia/Shanghai&useLegacyDatetimeCode=false

加了参数后，驱动按东八区解析时间。如果还不对，检查Linux服务器本身的时区。Windows本地跑一般不犯这个错，这个坑多出现在部署到服务器之后，部署时用timedatectl set-timezone Asia/Shanghai把系统时区一起修正。数据库里datetime字段本身不带时区，靠的是客户端解析时指定时区，这就是这个参数最核心的作用。

6. 从“能跑”到“能交差”：验收清单、防作弊改造与一个技巧

6.1 先按一条完整链路验收

功能验收别停留在“能打开首页”。按真实流程走一遍：管理员建考试并指定试卷规则，教师出一题并发布，学生进入考试、刷新一次页面再提交，教师给主观题打分，学生端查到最终成绩。这条链路每步截图按时间排好，答辩时比十张登录页截图有用。再多测一个边界场景：考试结束前1分钟交卷，再重进系统，确认记录状态是已交卷。

6.2 防作弊最小改造

老源码大多只做前端倒计时，改系统时间就能续考。最小改造是把判时逻辑放到后端：

@Scheduled(cron = "0 * * * * ?") public void autoSubmitTimeoutExams() { List<ExamRecord> timeoutRecords = recordMapper.findTimeoutRecords(); for (ExamRecord record : timeoutRecords) { submitService.forceSubmit(record.getExamId(), record.getUserId()); } }

这个定时方法每分钟扫一次考试记录，把超过结束时间还处于考试中的记录强制交卷。cron表达式0 * * * * ?表示每分钟第0秒执行，对数据库只做一次范围查询，压力很小。学生改本地时间也没用，判断依据全在服务器。

6.3 一个教训

当年做课设偷懒用了纯前端倒计时，结果同学把电脑时间改慢又考了一轮，被指导老师在演示现场当场点破，场面很难忘。后来我把时间校验全挪到后端，又给exam_record加了唯一索引。这份源码里最值得你花时间的就这两个位置：判时和后端防重。它俩同时解决“超时交卷”和“重复交卷”两个致命问题，改完你就超出大多数课设水平了。希望帮到你。

本文还有配套的精品资源，点击获取