简介这是一款面向考研备考场景的小程序毕业设计源码包基于Java/PHP后端、MySQL数据库与uniapp/原生小程序前端构建适合用于毕业设计、课程设计或小程序前后端开发实操练习。压缩包共59个文件主要包含15个JSON配置文件、12个JS逻辑文件、11个WXSS样式表、10个WXML页面模板另有PNG/JPG图片素材、MP4操作录像和DOC说明文档整体约5.98MB文件结构清晰便于按模块对照学习。项目主要功能覆盖考试信息查询、院校与专业浏览、社区论坛、在线真题练习、模拟考试及成绩分析基本涵盖考研备考的核心环节。目前已有61人浏览学习特别适合正在筹备毕设或想完整走通小程序开发全流程的同学参考。资源内附项目说明文档、需求文件和操作演示视频结合完整前后端源码可理解MySQL表设计、接口调用及小程序页面生命周期便于答辩展示和二次功能开发。1. 考研小程序源码到手先别急着双击打开每年毕业季都能看到同一类场景从网上下载了一份「考研小程序源码完整前后端mysql说明文档.zip」解压之后有一堆前端文件、后端工程和一个SQL脚本然后就卡在第一步。有人用微信开发者工具直接打开了小程序目录发现登录接口一直转圈有人把后端扔进IDEA等了三分钟还在报数据库连接失败还有人根本没有MySQL环境卡在安装环节就开始焦虑。这些现象和项目本身关系不大多半是没搞懂这份源码的运行顺序。这类毕业设计项目通常不是单页应用而是一个完整的前后端分离项目微信小程序负责展示和交互后端接口负责业务逻辑MySQL负责持久化。你要解决的第一个问题不是读代码而是把这个三件套在本地按正确顺序跑起来。本文会从结构拆解、数据库设计、部署步骤、避坑经验到答辩加分改动完整过一遍让这份源码真正变成本科四年里最拿得出手的一个项目。2. 拆解考研小程序的前后端结构这三层决定你能否顺利答辩2.1 小程序前端页面、接口封装、状态管理的最小可用写法考研小程序的用户端一般包含首页、题库练习、错题本、学习打卡、个人中心这几个页面。如果用的是微信原生开发目录结构通常是pages/下按功能分文件夹每个页面由.wxml、.wxss、.js、.json四个文件组成。拿到源码后先打开app.json看pages数组的第一项——那是小程序的启动首页也能顺便看出这个项目一共有多少个页面模块。接口请求部分规范的项目会在utils/request.js里封装一个wx.request的统一方法。常见做法是const BASE_URL http://localhost:8080/api; function request(path, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json, token: wx.getStorageSync(token) || }, success: (res) { if (res.statusCode 200) { resolve(res.data); } else if (res.statusCode 401) { wx.removeStorageSync(token); wx.navigateTo({ url: /pages/login/login }); reject(new Error(登录已过期)); } else { reject(new Error(请求失败)); } }, fail: (err) reject(err) }); }); } module.exports { request };这段封装做了什么第一把 base URL 集中到一个常量后面切换真机调试地址时只改一行第二统一在 header 里携带 token避免每个页面重复写第三把wx.request的成功回调包装成 Promise页面里可以用async/await写业务逻辑比嵌套回调清晰得多。参数说明里最重要的一项是BASE_URL——本地调试用localhost真机预览时必须改成电脑在局域网中的 IP比如http://192.168.1.5:8080/api否则手机访问不到你的后端。2.2 后端服务Spring Boot 接口与登录鉴权怎么搭绝大多数这类毕设的后端是 Spring Boot 工程结构上分成controller、service、mapper三层。你不需要每行代码都读懂但必须理解请求是怎么穿透这三层的。以「获取考研政治选择题列表」为例小程序端调用/api/question/list先由 Controller 接收参数并做基础校验然后调用 Service 层的业务方法Service 再通过 MyBatis 的 Mapper 接口执行 SQL最终把结果封装成 JSON 返回给前端。登录鉴权部分常见做法是使用 JWT。用户在小程序里输入学号和密码后端校验通过后签发一个 token前端存到wx.setStorageSync(token, ...)之后每次请求都带上。后端用一个拦截器统一校验public class JwtInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(token); if (token null || token.isEmpty()) { response.setStatus(401); return false; } try { Claims claims JwtUtil.parseToken(token); request.setAttribute(userId, claims.get(userId)); return true; } catch (Exception e) { response.setStatus(401); return false; } } }这段代码的逻辑很简单每个请求进来先检查 header 里有没有 token没有或解析失败就直接返回 401让小程序端跳登录页解析成功就把用户 ID 放进 request 属性后面的 Controller 可以直接取。这里要注意一个参数Claims claims JwtUtil.parseToken(token)如果源码里的 JwtUtil 设置了过期时间默认可能是 2 小时甚至 7 天答辩演示时如果时间太长可以改短一些再展示「登录过期自动跳转」这个功能点这种细节很加分。2.3 后台管理端与数据流向管理员用什么维护题库和内容考研小程序通常不只有用户端还配套一个后台管理端用来维护题库、发布资讯、查看用户学习记录。后台的形态有两种一种是独立 Web 项目Vue Element UI 或若依框架另一种简单粗暴直接用小程序里隐藏的管理员入口。从数据流向来看两端共用同一个后端接口和同一套 MySQL 表只是权限不同。用户和管理员都存储在user表里通过role字段区分管理端接口会在拦截器里额外校验角色。拿到源码后建议先梳理清楚「谁往数据库写数据」。小程序用户产生的数据是学习记录、打卡、错题管理员写入的是试题、公告、专业库。如果源码里带了后台管理页面先跑这个而不是先跑用户端因为空数据库里没题小程序首页刷出来是空的你会误以为项目坏了。合理顺序是先导入数据库脚本再启动后端然后用管理端账号录几道题进去最后打开小程序看效果。如果源码没带管理端你也可以用Navicat直接往question表里插几条测试数据效果一样。3. 考研业务落地到 MySQL库表设计、SQL 与参数选型3.1 用户表、题库表、学习记录表三张核心建表语句考研小程序的业务核心是「用户做题系统记录结果」所以数据库设计绕不开这几张表。拿到源码里的.sql文件后先别急着执行打开扫一眼重点看字段注释和主键策略。规范的毕设库表通常长这样CREATE TABLE user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录账号, password varchar(100) NOT NULL COMMENT MD5加密后的密码, nickname varchar(50) DEFAULT NULL COMMENT 昵称, role tinyint(4) DEFAULT 1 COMMENT 角色1用户 2管理员, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 注册时间, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表;注意几个设计细节password字段长度是 100 而不是 50因为 MD5 之后是 32 位如果用了加盐或 BCrypt长度会到 60 到 100role用tinyint而不是varchar省空间且查询快create_time默认取当前时间这样插入时不用显式赋值。如果你打算答辩时讲数据库设计这三个点每个都能展开说半分钟。题库表是考研小程序最有区分度的表因为考研科目是分政治、英语、数学、专业课的每道题还要关联章节和知识点CREATE TABLE question ( id int(11) NOT NULL AUTO_INCREMENT, subject_id int(11) NOT NULL COMMENT 科目ID1政治 2英语 3数学, chapter_id int(11) DEFAULT NULL COMMENT 章节ID, type tinyint(4) DEFAULT 1 COMMENT 题型1单选 2多选 3简答, content text COMMENT 题干, options text COMMENT 选项JSON如[A.xx,B.xx], answer varchar(10) DEFAULT NULL COMMENT 正确答案, analysis text COMMENT 解析, difficulty tinyint(4) DEFAULT 2 COMMENT 难度1易 2中 3难, PRIMARY KEY (id), KEY idx_subject (subject_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT题库表;options字段用 text 存 JSON 字符串这是很多毕设项目的常见写法。好处是建表简单坏处是无法用 SQL 直接查某个选项但考研题目的选项在业务上不需要单独检索所以这是一个合理的取舍。type字段区分单选多选前端拿到之后按不同类型渲染不同的答题组件。analysis字段一定要有数据考研类小程序的核心卖点就是「做错的题能看到解析」答辩时老师大概率会问「你的错题本数据从哪来」——答案就在这里。第三张核心表是学习记录表它承担了打卡、错题收集、学习统计三个功能CREATE TABLE study_record ( id int(11) NOT NULL AUTO_INCREMENT, user_id int(11) NOT NULL, question_id int(11) NOT NULL, is_correct tinyint(1) DEFAULT 0 COMMENT 0错误 1正确, user_answer varchar(10) DEFAULT NULL, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user (user_id), KEY idx_question (question_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学习记录表;这张表的每一行代表用户做了一道题对错、答案、时间都记录在案。用is_correct 0和user_id联查就是错题本的数据来源按天分组统计就是打卡数据。注意create_time的类型是datetime如果你用timestamp类型在跨时区场景会有 8 小时偏移问题虽然国内毕设一般不涉及时区但答辩时能说清楚这个区别是加分项。3.2 用一条 SQL 做出「每日打卡统计」和「错题本」表设计好了接下来演示一下最常见的统计需求怎么用 SQL 实现。考研小程序里有一个高频功能首页展示「今日已打卡」「连续学习天数」。今日已打卡的统计极其简单SELECT COUNT(*) AS today_count FROM study_record WHERE user_id 1 AND DATE(create_time) CURDATE();只要今天有任何一条做题记录就算打卡成功。DATE(create_time) CURDATE()这种写法把 datetime 字段转成日期再比较忽略时分秒。这里有个性能细节如果study_record表数据量大了DATE()函数会导致索引失效全表扫描。改进写法是用范围查询SELECT COUNT(*) AS today_count FROM study_record WHERE user_id 1 AND create_time CURDATE() AND create_time DATE_ADD(CURDATE(), INTERVAL 1 DAY);两种写法结果一样但第二种能用上idx_user联合create_time的索引。这个优化思路拿到答辩场上比背十遍「索引能提高查询效率」有说服力得多。错题本功能的核心 SQL 是查「某用户最近做错且还没做对的题」。如果源码里没有实现「重新做错题后自动从错题本移除」的逻辑最常见的查询是SELECT q.id, q.content, q.analysis, r.user_answer, r.create_time FROM question q INNER JOIN ( SELECT question_id, MAX(id) AS max_id FROM study_record WHERE user_id 1 AND is_correct 0 GROUP BY question_id ) r ON q.id r.question_id ORDER BY r.max_id DESC;子查询的思路是先找该用户每道错题的最新一条错误记录再关联题目表取题干和解析。为什么要查MAX(id)而不是直接查is_correct 0因为用户同一道题可能错三次又对一次如果直接查所有错误记录会出现重复题。用MAX(id)找出每个题号最近一次做题记录再判断这次是否做错才能得到真正的当前错题列表。这种细节代码里未必写对了你理解之后甚至可以自己改进成为答辩亮点。3.3 字符集、存储引擎与连接池参数字段注释和保留字的坑数据库层面还有一个容易被忽略但经常在导入时报错的点字符集和排序规则。考研题库里大量内容是中文很多还是政治论述题里的长段落如果表默认用了latin1或utf8导入时轻则中文乱码重则直接报Incorrect string value错误。拿到 SQL 脚本后全局搜索CHARSET统一改成utf8mb4。utf8mb4和utf8的区别在于前者支持 emoji 和生僻字虽然考研题里不会有表情符号但「」这类扩展区汉字是可能出现的用utf8会存不进去。存储引擎建议统一使用InnoDB。MySQL 8.0 默认就是 InnoDB但有些网上扒下来的脚本可能混用了 MyISAM。InnoDB 支持事务和外键MyISAM 不支持。考研小程序里的学习记录插入和错题更新是典型的高频写操作如果表是 MyISAM并发插入时容易出现表锁体验上表现为「多人同时做题时打卡保存变慢」。虽然毕设不会有真正的高并发但这个点属于「老师一问就露馅」的范畴提前把脚本里的ENGINEMyISAM全部替换掉。还有一个毕设源码经常翻车的细节字段名撞了 MySQL 保留字。之前接过一个项目order表用来存题目顺序user表用来存账号信息单独建表没问题但写 SQL 时SELECT * FROM order直接报语法错误。MySQL 保留字列表里有order、group、rank、desc等考研项目里最容易踩的是desc——有些人用desc当字段名存题干描述。解决办法有两个要么建表时改名成description要么写 SQL 时用反引号包起来。我建议前者因为后者要求每条 SQL 都记得加反引号漏一条就报错。4. 把 zip 变成能跑的完整前后端部署顺序与配置修改4.1 环境准备JDK、Node、MySQL 的版本匹配从 zip 解压到项目跑起来最容易翻车的是各软件版本不匹配。先说 Java 后端。考研小程序的后端如果是 Spring Boot 2.x要求 JDK 8 或 11如果是 Spring Boot 3.x就必须 JDK 17 以上。怎么判断找pom.xml文件看parent标签里的version看到一个具体的版本号比如2.7.18那你就装 JDK 8 或 11看到3.2.5那就直接装 JDK 17。不要在 JDK 版本上赌因为我见过太多次UnsupportedClassVersionError这个报错翻译成人话就是「编译这个项目的 JDK 版本比你本地装的新读不了」。MySQL 版本方面脚本如果是 5.7 写的用 MySQL 8.0 导入大概率会遇到Unknown collation: utf8mb4_0900_ai_ci报错因为utf8mb4_0900_ai_ci是 8.0 才有的排序规则。反过来脚本里写了utf8mb4_general_ci在 8.0 里也能正常导入。所以常见做法是先看 SQL 脚本开头的SET NAMES语句排序规则再决定装哪个版本。如果你是全新安装直接上 MySQL 8.0然后用文本编辑器把脚本里所有utf8mb4_0900_ai_ci替换成utf8mb4_general_ci这样兼容性最好。小程序前端不需要额外安装 SDK微信开发者工具本身就是编译环境。但要注意如果你的源码是基于 uni-app 开发的目录结构里会有src和manifest.json那就不能用微信开发者工具直接打开得先装 HBuilderX再用它导入项目并「发行到微信小程序」。怎么分辨看根目录有没有manifest.json和pages.json有就是 uni-app 项目。这一条排错思路能帮你省掉至少半天。4.2 导入 MySQL 脚本与修改后端数据源配置环境装好之后第一步永远是导入数据库而不是启动后端。打开 MySQL 命令行或 Navicat先建一个空数据库再导入脚本。命令行导入方式mysql -u root -p -e CREATE DATABASE kaoyan DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p kaoyan /path/to/kaoyan.sql第一行创建数据库第二行把 SQL 脚本导入进去。注意kaoyan.sql路径里不要带中文和空格Windows 上尤其容易因为路径问题导致命令找不到文件。如果你用的 Navicat右键数据库选「运行 SQL 文件」也行但前提也是先手动建好一个空库再导入不要直接「新建查询」粘贴整个脚本——脚本里如果有CREATE DATABASE语句你粘贴到任意库里执行没问题但没有的话原库不存在就会报No database selected。导入完成后修改后端的数据源配置。Spring Boot 项目的配置在src/main/resources/application.yml或application.properties里spring: datasource: url: jdbc:mysql://localhost:3306/kaoyan?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver必须改的是password其次确认url里的数据库名和你在 MySQL 里建的一致还有serverTimezoneAsia/Shanghai——如果不加这个参数Java 8 之后连接 MySQL 8.0 会报时间时区相关的Server returns invalid timezone错误。useSSLfalse是因为本地开发没有配置证书加上反而会有警告日志。改完配置建议先单独测一下连接用一个最简单的 JDBC 测试类或 Navicat 用同样账号密码连一次能连上再启动项目省得后端启动日志报错时你分不清是密码错还是端口被占。4.3 启动后端、编译小程序、真机预览的完整顺序启动顺序有讲究。第一步启动 MySQL确保服务在运行。Windows 上可以net start mysql或在服务管理器里启动Mac 上brew services start mysql。第二步启动后端在 IDEA 里直接运行主类或者用 Maven 打包后运行mvn clean package -DskipTests java -jar target/kaoyan-0.0.1-SNAPSHOT.jar-DskipTests跳过测试避免因为某个测试用例数据不匹配而构建失败。启动日志里看到Started和Tomcat started on port(s): 8080就说明后端起来了。这时先用浏览器访问一下http://localhost:8080/api/health之类的健康检查接口或者在 Swagger 页面看接口列表。如果后端里有springfox或springdoc依赖访问/swagger-ui/index.html能看到接口文档这是你确认后端是否正常的捷径。第三步打开微信开发者工具导入项目时选择解压目录里的「小程序前端」文件夹而不是整个 zip 解压后的根目录。导入后先在「详情 → 本地设置」里勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」否则请求http://localhost:8080会被拦截。然后编译看到首页数据渲染出来部署完成。真机预览时把你电脑的 IP 地址找出来替换utils/request.js里的BASE_URL手机和电脑连同一个 WiFi扫码预览即可。5. 考研小程序毕设的避坑指南导入报错、请求 404、Token 失效5.1 坑一MySQL 脚本导入时报Unknown collation现象用 Navicat 运行下载的.sql文件执行到一半弹出红色报错信息类似Unknown collation: utf8mb4_0900_ai_ci后续语句全部停止。原因这份脚本是在 MySQL 8.0 上导出的8.0 默认排序规则是utf8mb4_0900_ai_ci而你的 MySQL 版本是 5.7 或 MariaDB不认识这个排序规则。更麻烦的是报错发生在建表语句中段导致前面已经建好的表留下了后面没执行。解决先用DROP DATABASE把半成品库删掉再用文本编辑器的全局替换把utf8mb4_0900_ai_ci全部换成utf8mb4_general_ci重新建库导入。删除命令是DROP DATABASE kaoyan;重建时沿用上一章的命令。5.2 坑二后端启动了小程序请求还是 404现象后端日志显示Tomcat started on port(s): 8080但小程序端所有请求都返回 404浏览器访问接口也一样。原因大多数时候是路径问题。第一种可能是后端工程部署的 context path 不是根路径比如配置文件里有server.servlet.context-path: /kaoyan那么实际接口地址是http://localhost:8080/kaoyan/api/...前端BASE_URL没带/kaoyan。第二种可能是前端请求的路径和后端 Controller 的RequestMapping拼起来不一致比如前端写的/question/list后端类上是/api/question方法上是/list但前端少拼了/api。解决打开后端 Controller 源码逐个看类上的RequestMapping注解拼出完整路径再对比utils/request.js里的BASE_URL和请求路径。把完整 URL 放到浏览器里直接访问一次能返回 JSON 就说明后端没问题问题只出在前端拼路径。如果浏览器访问也 404就用排除法把RequestMapping的路径一段段去掉测。5.3 坑三开发者工具里正常真机上一刷新就退出登录现象微信开发者工具里登录、做题都很流畅但用手机扫码预览后一打开就提示登录过期或者操作几下就被踢回登录页。原因最常见的原因是BASE_URL还写的是localhost。手机上的localhost指向手机自己不是你的电脑所以所有请求都失败而前端封装里遇到非 200 状态码就清 token 跳登录页表现就是「不断退出登录」。另一个原因是电脑和手机不在同一局域网或者电脑防火墙拦截了 8080 端口的入站请求。解决把BASE_URL改成电脑的局域网 IP比如http://192.168.1.5:8080/api。然后在电脑浏览器上访问http://192.168.1.5:8080/api/health确认通 ping。如果浏览器能访问但手机不行去防火墙设置里放行 8080 端口Windows 是「高级安全 Windows Defender 防火墙 → 入站规则 → 新建规则 → 端口」这条操作是无数毕业生熬夜掉的头发换来的经验。5.4 坑四数据库里的时间字段正常小程序显示NaN或Invalid Date现象学习打卡记录的时间在小程序端显示成NaN-NaN-NaN或Invalid Date但 Navicat 里看数据完全正常。原因后端的日期序列化格式和小程序端的解析格式不一致。Java 的 Jackson 默认序列化日期会输出时间戳或2025-06-01T12:00:00.00000:00这种 ISO 格式小程序端如果直接用new Date(res.data.createTime)来解析某些情况下格式化会失败尤其是时区偏移带了Z后缀时。解决在后端配置里统一日期格式。在application.yml中加入spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: Asia/Shanghai改完重启后端再看小程序端时间字段就会变成2025-06-01 12:00:00这样规整的字符串前端不需要再解析。注意修改后要确认小程序端没有用时间戳格式做排序的地方有的话要做兼容处理。5.5 坑五SQL 语句里用了保留字导致查询失败现象后端日志里出现You have an error in your SQL syntax但同一个 SQL 在 Navicat 里单独执行却能通过。或者所有功能点的 SQL 都能跑唯独某一个列表页报错。原因科研项目里最常见是desc、order、group这些保留字被直接作为字段名或表别名使用。Navicat 会帮你自动补全反引号但 MyBatis 的 XML 映射文件里可没有这个功能SQL 原样发送给 MySQL 就直接语法报错。在考研小程序里最容易踩的是用desc字段存题目描述。解决修改 Mapper XML 或注解 SQL把保留字用反引号包起来。如果你不想逐个找最彻底的方法是改字段名desc改成question_descorder改成sort_order。这也是业界的规范做法答辩时老师问起「为什么这么设计」你可以回答「为了规避数据库保留字冲突保证 SQL 的可移植性」。6. 答辩前的验证与进阶把「能跑」变成「有说服力」项目跑通了离毕业答辩还差一步证明它稳定、有真实用户价值而不是一个「能打开就完事」的demo。我建议答辩前花一个晚上做三轮验证。第一轮数据完整性验证。清空数据库的study_record表用一个新用户账号走完魔鬼链路注册 → 选科目 → 做 10 道题 → 故意答错 3 道 → 查看错题本 → 重新做错题 → 查看打卡日历。每一步截图记录的「按时间倒序」「错题收集」「打卡连续天数」这些现象直接对应你数据库里study_record表的新增行。老师如果问「你这个打卡是怎么判断的」你打开 MySQL 给他看SELECT COUNT(*) FROM study_record WHERE user_id? AND DATE(create_time)CURDATE();的查询结果比任何 PPT 都有说服力。第二轮异常场景验证。把后端停掉小程序端重新进入应该看到统一的错误提示而不是某个页面白屏。把数据库密码改错启动后端观察启动日志报错信息是不是「连不上数据库」而不是「驱动类找不到」。这些异常表现写进操作说明文档里能展示你作为开发者对错误处理的用心程度很多毕设项目恰恰输在这里——正常功能有边界情况全崩。第三轮选择一个点做小幅度进阶。结合你自己的使用体验给考研小程序加一个「学习时长统计」或者「考研倒计时」功能。以倒计时为例前端只需一行setInterval每秒更新剩余天数后端不需要任何改动。但答辩时你可以借这个点讲「如果未来接入消息推送可以在这个组件的基础上做每日提醒」。加一个小功能比把原有代码改得面目全非要安全得多毕竟毕设和真实生产项目不一样稳定拿到学分才是核心目标。最后说一句真话这类源码包里最值钱的部分不是代码本身而是你对「用户怎么用、数据怎么流、挂了怎么查」这个完整链路有没有理解。我每次带毕设学生都让他们先自己把项目跑挂了再去日志里找原因这样连续三次就能把这个项目的脾性摸透。我也希望这篇文章帮你绕开我走过的那些弯路把精力花在真正会加分的地方。希望帮到你。本文还有配套的精品资源点击获取