简介：本资源是一套完整的微信小程序+SpringBoot双端刷题系统毕业设计源码，面向计算机专业本科生、Java与前端初学者及毕设开发者，解决在线学习平台从0到1的全栈开发实践问题。资源包共773个文件，涵盖101个Java后端业务逻辑与实体类、93个Vue组件与22个WXML/WXSS小程序页面、89个JS交互脚本、175个PNG/SVG图标资源及25MB左右的项目配置与静态资源，整体压缩包25.76MB，结构清晰，前后端分离明确。已有118人下载学习，适合用于课程设计、毕业设计复现或技术栈整合训练。读者可直接导入IDE运行完整系统，获得含用户登录、动态题库加载、实时答题评分、错题自动归集、成绩统计报表等核心功能的可执行工程，并参考配套的bat启动脚本、YML配置、SQL建表语句及模块化Vue组件结构，深入理解小程序与SpringBoot协同开发的关键实现路径。

1. 微信小程序刷题系统：一个能跑通登录、做题、判分、错题回看的 SpringBoot 全栈毕业源码，不是 Demo，是真实可部署的最小可行产品

你手头正赶着毕设开题，导师说“别整虚的，得能点开、能注册、能做三道题、能看分数”，但翻遍 GitHub 和 CSDN，要么是只有前端页面的“假刷题”（点击提交没响应），要么是后端空有 Controller 却缺数据库表结构和业务逻辑的“半成品”。这个基于微信小程序 + SpringBoot 的刷题系统源码，就是为这种场景生的——它不是教学 Demo，而是一个从微信授权登录、题目随机抽取、单选/多选实时判分、错题自动归集、到管理员后台批量导入题库，全部走通的完整闭环。它用的是 SpringBoot 2.7.x（非最新但稳定兼容 JDK8）、MySQL 5.7+、MyBatis-Plus，前端完全基于原生微信小程序（不依赖 uni-app 或 Taro），所有接口都经过真机调试（iOS/Android 微信客户端实测）。适合计算机/软件工程专业本科生直接拿去改题库、换 UI、加功能，而不是花三天配环境、两天调跨域、一天查 session 失效原因。如果你需要的不是一个“看起来像系统”的截图集合，而是一份能让你在答辩现场打开手机、扫码、注册、做题、当场展示分数和错题本的源码，那它就是你现在该停下来的那个。

2. 项目结构与核心模块拆解：SpringBoot 后端怎么组织，小程序前端如何对接，为什么这样设计

2.1 后端目录结构：按业务域划分，不是按技术层堆砌

这个 SpringBoot 项目没有照搬教科书式的controller/service/mapper三层平铺，而是以“用户行为流”为线索组织包结构：

com.example.quiz ├── config // WebMvcConfigurer、RedisConfig、Swagger 配置 ├── controller │ ├── api // 小程序端调用的 REST 接口（/api/user, /api/question） │ └── admin // 管理员后台接口（/admin/question, /admin/report），带 @PreAuthorize("hasRole('ADMIN')") ├── entity // JPA 实体类（User, Question, UserAnswer, WrongQuestionRecord） ├── dto // 数据传输对象（LoginDTO, SubmitAnswerDTO, QuestionPageDTO） ├── vo // 视图对象（用于返回给前端的精简字段，如 QuestionVO 只含 id/title/options/correctAnswer） ├── service │ ├── impl // 业务实现（UserServiceImp、QuestionServiceImp、AnswerServiceImp） │ └── strategy // 判分策略接口 + 多选/单选/判断题不同实现类（Strategy Pattern 落地） ├── mapper // MyBatis-Plus Mapper 接口（继承 BaseMapper） └── util // 工具类（WxMaCode2SessionUtil、IdWorker 雪花ID生成器、JSONResult 封装类）

提示：strategy包的存在，是它区别于大多数“毕设级”源码的关键。单选题判分是==，多选题是Collection.equals()，判断题是布尔值比对——这些逻辑被抽成独立策略类，后续加“填空题”只需新增一个FillInBlankStrategy并注册进 Spring 容器，不用动AnswerService主干代码。

2.2 小程序前端关键页面与数据流

小程序共 6 个核心页面，全部使用wx.request直连 SpringBoot 后端（无 Nginx 代理层，简化部署）：

注意：所有wx.request均封装在utils/request.js中，统一处理 loading、token 自动注入、401 跳转登录页。这是小程序端最值得复用的基建代码——它把“每次请求都要写 header、catch error、showToast”这种重复劳动，压缩成一行request.get('/api/user/info')。

2.3 为什么选 MyBatis-Plus 而不是 JPA？为什么不用 Redis 缓存题目？

• MyBatis-Plus 选型理由：毕设场景下，题库表（question）常需复杂查询（如“查某科目下难度为‘中’且未被该用户做过的题目”），JPA 的 JPQL 写起来冗长且难调试；而 MyBatis-Plus 的QueryWrapper链式调用（.eq("subject_id", 1).eq("level", "MEDIUM").notInSql("id", "SELECT question_id FROM user_answer WHERE user_id = ?")）更贴近 SQL 思维，学生 debug 时直接复制 SQL 到 Navicat 执行验证，效率高。

• 不用 Redis 缓存题目的真实原因：不是技术不能，而是没必要。题库总量通常 < 5000 题，MySQL 单表查询毫秒级；而引入 Redis 带来额外运维成本（本地要装 Redis、Docker Compose 编排、缓存穿透/雪崩处理），对毕设而言属于“过度设计”。真正用 Redis 的地方只有两个：① 用户登录态 token 存储（SETEX token:abc123 3600 {userId:123}）；② 管理员后台的题库导入任务状态（HSET import:task:789 status "PROCESSING" progress 65）。

3. 从零部署：数据库建表、后端启动、小程序配置三步落地

3.1 MySQL 数据库初始化：5 张表 + 初始化脚本说明

项目附带src/main/resources/sql/quiz_init.sql，执行前请确认：

• MySQL 版本 ≥ 5.7（因用到了JSON类型字段存储选项）
• 字符集为utf8mb4（支持 emoji，微信昵称可能含）

建表语句核心片段（已去除非关键约束）：

-- 用户表：微信 openid 是主键，避免重复注册 CREATE TABLE `user` ( `openid` varchar(64) NOT NULL COMMENT '微信唯一标识', `nick_name` varchar(50) DEFAULT NULL COMMENT '微信昵称', `avatar_url` varchar(255) DEFAULT NULL COMMENT '头像URL', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`openid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 题目表：options 字段存 JSON 数组，如 ["A. Java", "B. Python", "C. Go"] CREATE TABLE `question` ( `id` bigint NOT NULL AUTO_INCREMENT, `subject_id` int NOT NULL COMMENT '科目ID', `title` text NOT NULL COMMENT '题干', `options` json NOT NULL COMMENT '选项JSON数组', `correct_answer` varchar(10) NOT NULL COMMENT '正确答案，如 "A" 或 "AB"', `level` enum('EASY','MEDIUM','HARD') DEFAULT 'MEDIUM', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 用户答题记录表：一次练习生成一条 record，关联多道题 CREATE TABLE `user_answer_record` ( `id` bigint NOT NULL AUTO_INCREMENT, `user_openid` varchar(64) NOT NULL, `subject_id` int NOT NULL, `score` int NOT NULL DEFAULT '0', `total_count` int NOT NULL DEFAULT '0', `correct_count` int NOT NULL DEFAULT '0', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_user_openid` (`user_openid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 用户每道题作答详情：record_id 关联上表，便于查某次练习的所有题 CREATE TABLE `user_answer_detail` ( `id` bigint NOT NULL AUTO_INCREMENT, `record_id` bigint NOT NULL, `question_id` bigint NOT NULL, `user_answer` varchar(10) DEFAULT NULL COMMENT '用户选择，如 "A" 或 "BC"', `is_correct` tinyint(1) NOT NULL DEFAULT '0', `answer_time_ms` int NOT NULL DEFAULT '0' COMMENT '答题耗时（毫秒）', PRIMARY KEY (`id`), KEY `idx_record_id` (`record_id`), KEY `idx_question_id` (`question_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 错题本：用户做错的题，按 (user_openid, question_id) 联合唯一，避免重复插入 CREATE TABLE `wrong_question_record` ( `id` bigint NOT NULL AUTO_INCREMENT, `user_openid` varchar(64) NOT NULL, `question_id` bigint NOT NULL, `first_wrong_time` datetime DEFAULT CURRENT_TIMESTAMP, `wrong_count` int NOT NULL DEFAULT '1', PRIMARY KEY (`id`), UNIQUE KEY `uk_user_question` (`user_openid`,`question_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

逻辑说明：user_answer_record和user_answer_detail的一对多关系，是支撑“查看某次练习详情”的基础。很多毕设源码把所有答案塞进一个大 JSON 字段，导致无法按“某题被多少人答错”统计，这里用规范关系型设计，为后续扩展留出空间。

3.2 SpringBoot 后端启动：三处必须修改的配置

项目使用application.yml，以下三项必须人工确认：

spring: datasource: url: jdbc:mysql://localhost:3306/quiz_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username: root # 改为你本地 MySQL 账号 password: 123456 # 改为你本地 MySQL 密码 redis: host: localhost # 若本地没装 Redis，注释掉或改为 127.0.0.1 port: 6379 database: 0 # 微信小程序配置（从微信公众平台获取） wechat: miniapp: appid: wx1234567890abcdef # 必填！替换成你的小程序 AppID secret: your_miniapp_secret # 必填！替换成你的小程序 AppSecret mch-id: "" # 无需支付，留空

启动方式（IDEA 或命令行）：

# 方式1：IDEA 直接运行 QuizApplication.java # 方式2：Maven 打包后运行 mvn clean package -Dmaven.test.skip=true java -jar target/quiz-server-1.0.jar

启动成功标志：控制台输出Started QuizApplication in X seconds，且访问http://localhost:8080/swagger-ui.html能打开 Swagger 文档（管理员接口/admin/**需登录后才可见）。

3.3 小程序开发者工具配置：三个关键文件修改

打开project.config.json，确认appid为你自己的小程序 ID：

{ "description": "刷题系统", "packOptions": {}, "setting": { "urlCheck": false, // 必须关掉！否则本地调试时 wx.request 会被拦截 "es6": true, "enhance": true, "postcss": true, "preloadBackgroundData": false, "minified": false, "newFeature": true }, "compileType": "miniprogram", "libVersion": "2.28.2", "appid": "wx1234567890abcdef", // 替换此处 "projectname": "quiz-miniprogram", "debugOptions": { "hidedInDevtools": [] }, "isGameTourist": false, "simulatorType": "wechat", "simulatorPluginLibVersion": {}, "condition": {} }

然后修改utils/config.js中的后端地址：

// utils/config.js const BASE_URL = 'http://localhost:8080'; // 开发时指向本地 SpringBoot // const BASE_URL = 'https://your-domain.com'; // 上线时替换为 Nginx 反向代理地址 module.exports = { BASE_URL, LOGIN_URL: `${BASE_URL}/api/user/login`, QUESTION_RANDOM_URL: `${BASE_URL}/api/question/random`, ANSWER_SUBMIT_URL: `${BASE_URL}/api/answer/submit`, // ...其他接口 };

提示：微信开发者工具默认开启“不校验合法域名”，但urlCheck: true会强制校验request域名。务必在project.config.json中设为false，否则所有请求 404。这是新手最常卡住的点——不是代码错，是工具配置没关。

4. 关键业务逻辑实现：从微信登录到自动判分，代码级还原

4.1 微信小程序登录全流程：code 换 session_key + 自定义登录态

小程序端调用wx.login()获取code，传给后端/api/user/login：

// 小程序 login.js wx.login({ success: res => { if (res.code) { wx.request({ url: config.LOGIN_URL, method: 'POST', data: { code: res.code }, success: res2 => { if (res2.data.code === 200) { wx.setStorageSync('token', res2.data.data.token); wx.switchTab({ url: '/pages/index/index' }); } } }); } } });

后端LoginController处理逻辑（关键在WxMaCode2SessionUtil）：

@PostMapping("/login") public Result<String> login(@RequestBody LoginDTO dto) { // 1. 调用微信接口换取 openid/session_key WxMaJscode2SessionResult sessionResult = this.wxMaService.getUserService().getSessionInfo(dto.getCode()); String openid = sessionResult.getOpenid(); if (StrUtil.isBlank(openid)) { return Result.fail("微信登录失败，请重试"); } // 2. 查询用户是否存在，不存在则创建 User user = userMapper.selectById(openid); if (user == null) { user = new User(); user.setOpenid(openid); user.setCreateTime(new Date()); userMapper.insert(user); } // 3. 生成自定义 token（JWT），有效期 7 天 String token = JwtUtil.generateToken(openid, 7 * 24 * 3600); // 4. 将 token 存入 Redis，设置过期时间 redisTemplate.opsForValue().set("token:" + token, openid, 7, TimeUnit.DAYS); return Result.success(token); }

参数说明：JwtUtil.generateToken()使用 HS256 算法，密钥硬编码在JwtUtil.java中（private static final String SECRET = "quiz-secret-key-2024";），实际部署需改为环境变量读取。redisTemplate存 token 是为了登出时可主动失效（DELETE token:xxx），比 JWT 黑名单更轻量。

4.2 随机抽题逻辑：保证同一用户两次练习不重复

QuestionService.randomQuestions()方法核心逻辑：

public List<QuestionVO> randomQuestions(Long userId, Integer subjectId, Integer count) { // 1. 查出该用户已做过的所有题目ID（避免重复） List<Long> doneIds = userAnswerDetailMapper.selectQuestionIdsByUser(userId); // 2. 构建 QueryWrapper，排除已做题 + 按科目筛选 QueryWrapper<Question> wrapper = new QueryWrapper<>(); wrapper.eq("subject_id", subjectId) .last("AND id NOT IN (" + buildInSql(doneIds) + ")") // 动态拼 IN 子句 .orderByAsc("RAND()") // MySQL 随机排序 .last("LIMIT " + count); // 限制条数 List<Question> questions = questionMapper.selectList(wrapper); // 3. 转 VO（过滤敏感字段，如 correct_answer 不返回） return questions.stream() .map(q -> { QuestionVO vo = new QuestionVO(); vo.setId(q.getId()); vo.setTitle(q.getTitle()); vo.setOptions(q.getOptions()); // JSON 字符串，前端解析 vo.setLevel(q.getLevel()); return vo; }) .collect(Collectors.toList()); }

注意：buildInSql(doneIds)是一个防 SQL 注入的工具方法，当doneIds为空时返回"0"（使NOT IN (0)恒真），避免NOT IN ()语法错误。这是生产级写法，比网上常见的if (doneIds.isEmpty()) { ... } else { ... }更简洁安全。

4.3 多选题自动判分策略：Strategy Pattern 的真实落地

判分入口在AnswerService.submitAnswer()，根据题目类型委派给不同策略：

@Service public class AnswerService { @Resource private Map<String, AnswerStrategy> strategyMap; // Spring 自动注入所有 Strategy 实现 public AnswerResult submit(UserAnswerDTO dto) { Question question = questionMapper.selectById(dto.getQuestionId()); AnswerStrategy strategy = strategyMap.get(question.getType()); // type = "SINGLE"/"MULTI"/"JUDGE" boolean isCorrect = strategy.judge(dto.getUserAnswer(), question.getCorrectAnswer()); // 保存答题详情... return new AnswerResult(isCorrect, calculateScore(isCorrect, question.getLevel())); } } // 多选题策略实现 @Component("MULTI") public class MultiChoiceStrategy implements AnswerStrategy { @Override public boolean judge(String userAnswer, String correctAnswer) { // userAnswer="AB", correctAnswer="AB" → true // userAnswer="A", correctAnswer="AB" → false（少选错） // userAnswer="ABC", correctAnswer="AB" → false（多选错） return StrUtil.equals(userAnswer, correctAnswer); } }

逻辑说明：多选题判分严格遵循“完全匹配”，不支持“少选得部分分”。若需扩展，只需新增PartialMultiChoiceStrategy并在@Component("MULTI_PARTIAL")，再改strategyMap的 key 映射即可，主流程代码零修改。

5. 避坑指南：那些让毕设答辩前夜崩溃的 4 个真实问题

5.1 现象：小程序真机调试时wx.request报request:fail net::ERR_CONNECTION_REFUSED

原因：开发者工具勾选了“不校验合法域名”，但真机调试时微信客户端仍强制校验request的域名是否在小程序后台配置的“服务器域名”中。localhost不被允许。
解决：

• 方案 A（推荐）：用ngrok或localtunnel将本地8080端口映射为公网 HTTPS 地址（如https://abc123.ngrok.io），填入小程序后台「开发管理 > 开发者工具 > 服务器域名」；
• 方案 B：在手机上安装 Charles 或 Fiddler，设置手机代理到电脑，抓包确认请求是否发出；
• 方案 C（仅测试）：在小程序后台临时添加127.0.0.1到 request 合法域名（微信不支持，此路不通，纯属常见误操作）。

5.2 现象：SpringBoot 启动报Caused by: java.lang.ClassNotFoundException: org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration

原因：pom.xml中spring-boot-starter-web依赖被错误排除，或 Maven 仓库损坏导致 jar 包不全。常见于从 GitHub 下载源码后未执行mvn dependency:resolve。
解决：

• 删除项目根目录下target文件夹和~/.m2/repository/org/springframework/boot/下对应版本文件夹；
• 在 IDEA 中右键项目 →Maven → Reload project；
• 终端执行mvn clean compile -U（-U强制更新快照）；
• 检查pom.xml是否存在<exclusions>误删了 web 依赖。

5.3 现象：管理员后台登录成功，但访问/admin/question/list返回 403 Forbidden

原因：Spring Security 配置中，/admin/**路径要求ROLE_ADMIN，但管理员用户在数据库user表中role字段为空或不是ADMIN。
解决：

• 连接 MySQL，执行UPDATE user SET role = 'ADMIN' WHERE openid = 'admin123';（假设管理员 openid 为admin123）；
• 或在AdminLoginController登录逻辑中，手动设置角色：

  UsernamePasswordAuthenticationToken auth = new UsernamePasswordAuthenticationToken(username, password, Arrays.asList(new SimpleGrantedAuthority("ROLE_ADMIN")));

5.4 现象：小程序提交答案后，/api/answer/submit接口返回{"code":500,"msg":"空指针异常"}，日志显示questionId=null

原因：小程序端exam.wxml中form提交时，<button form-type="submit">的name属性未与form的bindsubmit事件中e.detail.value的 key 对应。例如：

<!-- 错误写法：name 是 'qid'，但后端 DTO 期望 'questionId' --> <input name="qid" value="{{question.id}}" hidden/> <!-- 正确写法：name 必须与 DTO 字段名一致 --> <input name="questionId" value="{{question.id}}" hidden/>

解决：

• 在exam.js的formSubmit(e)方法中console.log(e.detail.value)，确认字段名；
• 检查SubmitAnswerDTO的@DataLombok 注解是否生效（IDEA 需安装 Lombok 插件并启用 annotation processing）；
• 在 Controller 方法参数加@Valid和@RequestBody，让 Spring Boot 自动校验必填字段。

6. 进阶技巧：如何快速定制题库、更换主题色、添加新题型

6.1 题库批量导入：Excel 解析 + 事务回滚保障数据一致性

管理员后台/pages/admin/import/import页面提供 Excel 上传功能。后端AdminQuestionController.importExcel()使用 Apache POI：

@PostMapping("/import") public Result<String> importExcel(@RequestParam("file") MultipartFile file) { try (Workbook workbook = WorkbookFactory.create(file.getInputStream())) { Sheet sheet = workbook.getSheetAt(0); List<Question> questions = new ArrayList<>(); for (int i = 1; i <= sheet.getLastRowNum(); i++) { // 跳过标题行 Row row = sheet.getRow(i); if (row == null) continue; Question q = new Question(); q.setSubjectId(getIntCellValue(row.getCell(0))); // 科目ID q.setTitle(getStringCellValue(row.getCell(1))); // 题干 q.setOptions(JSON.toJSONString(Arrays.asList( getStringCellValue(row.getCell(2)), getStringCellValue(row.getCell(3)), getStringCellValue(row.getCell(4)), getStringCellValue(row.getCell(5)) ))); // 选项转 JSON q.setCorrectAnswer(getStringCellValue(row.getCell(6))); // 正确答案 q.setLevel(QuestionLevel.valueOf(getStringCellValue(row.getCell(7)).toUpperCase())); // 难度 questions.add(q); } // 事务内批量插入，任一失败则全部回滚 questionService.saveBatch(questions); return Result.success("导入成功，共 " + questions.size() + " 题"); } catch (Exception e) { log.error("Excel 导入失败", e); return Result.fail("导入失败：" + e.getMessage()); } }

提示：Excel 模板由后台/admin/download-template接口生成，返回预设格式的.xlsx文件，避免学生自己瞎填列。模板包含数据验证（下拉选科目、难度），降低出错率。

6.2 小程序主题色一键切换：CSS 变量 + 全局样式覆盖

所有颜色定义在app.wxss根样式中：

/* app.wxss */ page { --primary-color: #07c160; /* 主题绿，可全局替换 */ --bg-color: #f8f8f8; --border-color: #e0e0e0; --text-color: #333; } .question-item { border-left: 4px solid var(--primary-color); } .submit-btn { background-color: var(--primary-color); }

如需换为蓝色主题，只需改一行：

--primary-color: #1890ff;

注意：微信小程序不支持 CSS Custom Properties 在style属性中动态绑定（如style="color: {{themeColor}}"），所以主题色必须编译时确定。若需运行时切换，需用wx.setStorageSync('theme', 'blue')+ 多套 wxss 文件theme-blue.wxss/theme-green.wxss，在app.js中动态require。

6.3 添加新题型（填空题）：三步扩展法

填空题与选择题核心差异：① 题干含{{blank}}占位符；② 用户输入文本而非选择；③ 判分需模糊匹配（如忽略空格、大小写）。扩展步骤：

Step 1：数据库加字段
在question表新增blank_answerTEXT 字段，存标准答案（如"Java"），correct_answer字段保留给选择题。

Step 2：后端加策略

@Component("FILL_IN") public class FillInBlankStrategy implements AnswerStrategy { @Override public boolean judge(String userAnswer, String correctAnswer) { // 忽略首尾空格、转换为小写、去除所有空格后比较 String cleanUser = userAnswer.trim().toLowerCase().replaceAll("\\s+", ""); String cleanCorrect = correctAnswer.trim().toLowerCase().replaceAll("\\s+", ""); return cleanUser.equals(cleanCorrect); } }

Step 3：小程序端适配
在exam.wxml中，根据question.type === 'FILL_IN'渲染input组件而非radio-group，并调整提交逻辑：

<view wx:elif="{{question.type === 'FILL_IN'}}"> <input bindinput="onFillInput" placeholder="请输入答案" value="{{fillAnswer}}" /> </view>

// exam.js onFillInput(e) { this.setData({ fillAnswer: e.detail.value }); }, formSubmit(e) { const answer = this.data.question.type === 'FILL_IN' ? this.data.fillAnswer : e.detail.value.answer; // 选择题走原有逻辑 // ...提交 }

从那以后我每次接手毕设源码，第一件事就是打开pom.xml看 SpringBoot 版本和application.yml里的数据库配置，第二件事是找sql/目录下的初始化脚本，第三件事是运行mvn clean compile确认依赖无误——这三步走完，90% 的“跑不起来”问题就消失了。剩下 10%，基本都在小程序project.config.json的urlCheck和后端application.yml的wechat.miniapp.appid里。希望帮到你。

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