简介面向高校毕业设计或课程设计的考研小程序完整源码包含前端小程序、Java/PHP后端以及MySQL数据库设计适合筹备小程序类项目、希望快速搭建考研备考应用的学生和开发者参考。资源共59个文件压缩包约5.98MB前端以wxml、wxss、js、json等文件为主分别承担页面结构、样式、交互逻辑与项目配置后端代码与数据库脚本配合说明文档使用另有doc版研读笔记和mp4演示录像可直观了解项目部署与运行效果。内容涵盖考试信息查询、历年真题练习、模拟考试、成绩分析等考研备考常用功能并采用uni-app或原生小程序框架方便跨平台适配。项目目录结构清晰包含说明文档、需求文件、录像及project源码目录便于按需检索和二次开发。目前已有61人学习使用对于需要完成类似课题或入门小程序全栈开发的人来说是一份高性价比的实践素材。1. 考研小程序源码这是一套能跑通前后端闭环的完整工程拿到这份考研小程序源码的第一天我先翻了说明文档重装了 MySQL改了三个配置二十分钟后登录页出现在模拟器里。这套源码的价值不在于页面多精致而在于它是真正能跑起来的完整工程——小程序端、后端接口、MySQL 数据库都齐还带一份能照着操作的说明文档。适合三类人拿去做毕业设计或课程设计的同学、想学 Java/PHP MySQL uniapp 前后端分离的开发者以及需要一套可二次开发脚手架的产品。下面按我实际拆解的顺序从技术选型聊到避坑。2. 技术栈拆解Java/PHP MySQL uni-app 这套组合到底怎么选2.1 前后端分离架构小程序端、后端接口、数据库三条线的职责这套源码严格说是一套前后端分离的工程而不是把逻辑塞进小程序里的单页应用。小程序端只负责渲染、收集用户行为和发起请求后端单独跑在一台服务器或本地开发机上暴露 HTTP 接口MySQL 单独存储用户、真题、论坛等数据。三者通过 JSON 交换数据这也是为什么你在源码里会同时看到 app.js、utils/util.js 这样的前端工具文件以及后端的 Controller、Service 分层目录。前端选择 uniapp 或原生小程序对应两条开发路线。uniapp 的价值在于同一套代码可以编译到微信小程序、H5 和 App原生小程序则更贴近微信生态调试响应快。这份源码里两种入口都有HBuilder X 跑 uniapp微信开发者工具跑原生建议你根据自己熟悉的工具链选一条不要混着用。我一般会优先用原生小程序调试页面用 uniapp 看多端效果。后端接口的设计遵循经典 Restful 风格比如 /api/subject/list 返回科目列表/api/exam/submit 接收答题结果。前后端分离的一个重要坑是跨域但小程序通过 wx.request 发请求不受浏览器同源策略限制所以你只需保证后端监听 0.0.0.0 且小程序里配置的合法域名或本地开发地址正确。下面是源码中小程序端请求封装最常见的写法我把 url 和 token 处理标注出来。// utils/request.js - 常见的小程序请求封装 const BASE_URL http://127.0.0.1:8080/api; // 本地调试用局域网地址 function request(url, method, data, header {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method: method || GET, data: data || {}, header: { Content-Type: application/json, Authorization: wx.getStorageSync(token) || , // 登录后从缓存取 token ...header }, success(res) { if (res.statusCode 200) { resolve(res.data); } else { reject({ code: res.statusCode, msg: res.data.msg || 请求失败 }); } }, fail(err) { reject(err); } }); }); } module.exports { request, BASE_URL };这段代码里的 BASE_URL 是你需要改的第一个参数。真机调试时不能用 127.0.0.1要改成电脑的局域网 IP后端启动时监听 0.0.0.0。token 从微信缓存拿确保每次请求带上登录凭证否则后端拦截器会直接返回 401。理解这三条线后面跑起来才踏实。2.2 数据库设计考研场景下核心表结构和字段说明考研小程序的数据库设计我拆出来的核心表有四类用户表、院校表、科目表、真题表再配一张考试报名表和一张成绩表。这种设计在毕设里算标准结构拆开能看明白每个模块怎么关联。用户表主要存微信 openid、昵称、头像、目标院校和专业院校表存学校名称、所在省份、双一流标识、复试分数线科目表存政治、英语、数学、专业课这类公共维度真题表则按科目关联存题目内容、选项、正确答案、解析和年份。报名表和成绩表再分别关联用户与院校/真题。下面给张简化后的建表 SQL你导入数据库后对照源码里的 entity 类能更快理解。-- 用户表 CREATE TABLE tb_user ( id INT NOT NULL AUTO_INCREMENT, openid VARCHAR(128) NOT NULL COMMENT 微信openid唯一标识, nickname VARCHAR(64) DEFAULT NULL, avatar VARCHAR(255) DEFAULT NULL, target_school VARCHAR(64) DEFAULT NULL COMMENT 目标院校, target_major VARCHAR(64) DEFAULT NULL COMMENT 目标专业, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_openid (openid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用户表; -- 真题表 CREATE TABLE tb_question ( id INT NOT NULL AUTO_INCREMENT, subject_id INT NOT NULL COMMENT 所属科目, year INT DEFAULT NULL COMMENT 真题年份, content TEXT NOT NULL COMMENT 题目内容, option_a VARCHAR(255) DEFAULT NULL, option_b VARCHAR(255) DEFAULT NULL, option_c VARCHAR(255) DEFAULT NULL, option_d VARCHAR(255) DEFAULT NULL, answer CHAR(1) DEFAULT NULL COMMENT 正确答案如 A, analysis TEXT COMMENT 答案解析, PRIMARY KEY (id), KEY idx_subject (subject_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT考研真题表;这里有两个值得留意的细节。第一个是字符集我强烈建议全部用 utf8mb4 而不是 utf8不然存储 emoji 和部分生僻字会报 Incorrect string value 错误这个坑很多人到答辩前才发现。第二个是索引查询真题列表时 where 条件通常是 subject_id 和 year所以给 subject_id 建普通索引就够了不用设计太复杂。源码里的 SQL 文件已经带数据你导入时注意不要重复执行否则会出现主键冲突。2.3 开发工具链的版本适配JDK 1.8、MySQL 5.7、HBuilder X 与微信开发者工具毕设源码最怕版本不一致这份源码要求的版本其实不算苛刻但你必须严格对齐。后端如果是 Java 线就装 JDK 1.8不是 11 或 17因为源码里没有处理新版本 module 导出问题如果是 PHP 线则不需要 JDK但要在本地装 PHP 8.0 以下环境。数据库统一用 MySQL 5.7 及以上我实测 8.0 也能跑但要注意驱动版本对时区参数更敏感。下面我列一张我在拆包时核对过的版本适配表帮助你少走弯路。组件建议版本必须确认的参数踩坑点JDK1.8 _202JAVA_HOME 环境变量版本大于 11 时反射和动态代理可能报错MySQL5.7.44端口 3306、字符集 utf8mb48.0 以上要改 UTC 时区参数后端框架Spring Boot 2.xserver.port8080不要直接升到 3.x核心代码会有变动HBuilder X3.x 最新稳定版项目类型选 uni-app首次打开会提示安装 uni-app 编译器插件微信开发者工具稳定版本地设置勾选不校验合法域名不勾选则本地请求会被拦工具链版本适配本质是让各组件之间的协议一致。JDK 1.8 对应 Spring Boot 2.x 的字节码版本MySQL 5.7 对应 5.7 默认认证插件HBuilder X 和微信开发者工具则要保证编译后的小程序基础库版本在 2.x 以上。你按这张表对一遍基本能避开八成环境问题。3. 从源码到跑起来数据库导入、后端启动、小程序编译的完整操作链3.1 先导入数据库用 Navicat 执行 SQL改两个默认参数拿到源码第一步不是打开代码而是先把数据库准备好。源码包里通常会有一个 xyks.sql 或类似命名的脚本也可能以 init.sql 出现在 project 目录下。我自己习惯先建一个名为 kaoyan_app 的数据库字符集选 utf8mb4然后在 Navicat 里右键该库选择运行 SQL 文件把脚本导进去。导入完成后重点检查 tb_user 表是否有数据没有的话后端登录接口在第一次请求时会创建用户这个行为是源码里写好的。在你第一次启动后端之前需要改两个参数。第一个是 MySQL 的 root 密码第二个是数据库连接配置里的时区。为什么是这两个因为源码里默认的数据库账号多半是 root密码是 123456如果你本机密码不一致后端启动时会在 HikariCP 连接池阶段直接报 Access denied时区问题则表现为插入时间慢八个小时或者启动时提示 The server time zone value is unrecognized。下面是后端 application.yml 里的核心配置我标注了需要修改的位置。server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/kaoyan_app?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 # 改为你自己的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver hikari: maximum-pool-size: 10 mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true wx: appid: 你的小程序AppID secret: 你的小程序AppSecret这里的 url 参数useUnicode 和 characterEncoding 是保证写库不乱码的老搭档serverTimezone 必须显式指定尤其 MySQL 8.0 默认时区是 UTC不写会差八小时。password 改成你本机真实密码同时保证 MySQL 服务已启动。改完后用 Navicat 测试连接确认能打开 kaoyan_app 再启动后端。3.2 后端启动Spring Boot 工程导入 IDEA三种启动失败的处理思路后端工程一般以 springboot 或 project 文件夹存在用 IDEA 打开时选择Open而不是Import Project因为源码通常已带 Maven 配置。打开后等待 Maven 自动下载依赖这个过程看你的网络情况可能持续几分钟。要注意 IDEA 里项目的 Maven 配置——JDK 版本必须指向 1.8否则依赖能下载但编译直接报错。启动后端的标准动作是找到主类类名一般是 KaoyanApplication 或 Application右键 Run。如果看到 Tomcat started on port 8080 且没有任何红色堆栈说明后端已经起来了。但多数情况不会一次成功我遇到过的三种启动失败和处理思路如下如果报 Access denied for user回到上一节改 MySQL 密码。如果报 Unknown database kaoyan_app说明数据库没建成功或名称不一致用 Navicat 建同名空库再导入。如果报 Failed to configure a DataSource则是 application.yml 里的路径或缩进问题yml 对空格极其敏感排查时优先看 url 和 password 是否对齐到同一层级。启动成功后再做一次快速验证在浏览器访问 http://127.0.0.1:8080/api/subject/list如果能返回 JSON 数据后端与数据库链路已经通了如果返回 404去检查 Controller 的 RequestMapping 路径是否包含 /api 前缀。3.3 小程序端编译原生与 uni-app 两套入口联调前别忘开不校验合法域名前端部分源码里有两种形态一种可以直接用微信开发者工具打开原生一种要用 HBuilder X 打开后编译到微信小程序uni-app。我建议第一次先用原生入口因为微信开发者工具对路径依赖和 app.json 的解析更直观等跑通后再去玩 uni-app 的跨端编译。用微信开发者工具导入时目录要选到包含 app.json 那一层不是外层 zip 解压的文件夹。导入后会出现两个高频问题一是工具提示无法解析 app.json通常因为目录层级不对二是请求 http 地址被拦截需要在工具右上角详情-本地设置里勾选不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书。这个开关是本地调试的后悔药不勾选的话所有 http 请求都会直接失败。// app.js - 小程序启动时的全局逻辑 App({ onLaunch() { const token wx.getStorageSync(token); if (!token) { // 跳转登录页 wx.reLaunch({ url: /pages/login/login }); } }, globalData: { userInfo: null, subjectList: [] } });这段 app.js 反映了启动时的全局状态处理先查本地 token没有就去登录。登录页拿到微信授权后调后端 /api/login 接口后端返回 token 和用户信息再写回缓存。联调时要注意 BASE_URL 的地址模拟器可以用 127.0.0.1真机必须用电脑局域网 IP并且后端启动的主机要关闭防火墙或放行 8080 端口。跑通登录后再进首页、科目列表和真题练习就说明前后端闭环都通了。4. 核心功能实现逻辑真题练习、模拟考试、成绩分析的落地方式4.1 真题练习从随机取题到提交判分的接口路径考研小程序的核心使用场景是刷真题。源码里真题模块的路径一般是 pages/subject 进去后选科目再进入 pages/exam 答题。后端接口围绕两个一个是拉取题目列表一个是提交答案。拉取题目时前端会传 subjectId 和 pageSize后端按科目从 tb_question 表随机抽取既保证每次练习不重样又避免一次加载太多题目卡页面。下面给出一个典型的后端接口实现思路用 Java 伪代码加注释说明关键点。RestController RequestMapping(/api/question) public class QuestionController { Autowired private QuestionService questionService; GetMapping(/list) public Result list(RequestParam Integer subjectId, RequestParam(defaultValue 10) Integer limit) { // 随机取题ORDER BY RAND() 在数据量大时性能一般毕设规模够用 ListQuestion list questionService.getRandomQuestions(subjectId, limit); return Result.success(list.stream().map(q - { q.setAnalysis(null); // 列表页先不返回答案解析防止提前暴露 return q; }).collect(Collectors.toList())); } PostMapping(/submit) public Result submit(RequestBody SubmitRequest req) { // 前端传来 questionId 数组和用户所选答案数组 int score questionService.markAnswers(req.getQuestionIds(), req.getAnswers()); questionService.saveUserRecord(req.getUserId(), req.getQuestionIds(), score); return Result.success(score); } }这段代码里有三个容易被忽略的细节。第一个是 ORDER BY RAND()它是随机取题的最简方案但真题数据量到几十万条时会导致全表扫描毕设完全够用如果你想扩展可以改成先查 id 集合再随机取 id。第二个是列表页屏蔽解析字段这是产品上的讲究避免用户还没答就看了答案。第三个是 submit 接口同时完成判分和存档把成绩写进用户答题记录表这也是下一节成绩分析的数据来源。4.2 模拟考试计时、交卷、自动评分的状态机设计模拟考试比真题练习复杂在状态管理上。一次考试有未开始、答题中、已交卷三种状态前端需要做倒计时后端需要防止重复交卷。源码里常见做法是用一张 exam_session 表记录考试会话字段包含用户 id、科目 id、开始时间、结束时间、最终得分。每次进入模拟考先创建会话拿到 sessionId交卷时带上 sessionId 和答题明细。// pages/exam/exam.js - 模拟考试页面的关键逻辑 Page({ data: { sessionId: , questions: [], userAnswers: {}, remainTime: 0, timer: null }, onLoad(options) { const subjectId options.subjectId; // 1. 创建考试会话后端返回考试时长和题目列表 request(/exam/start, POST, { subjectId }).then(res { this.setData({ sessionId: res.data.sessionId, questions: res.data.questions, remainTime: res.data.duration * 60 }); this.startTimer(); }); }, startTimer() { this.data.timer setInterval(() { const remainTime this.data.remainTime - 1; this.setData({ remainTime }); if (remainTime 0) { this.submitExam(); // 倒计时结束自动交卷 } }, 1000); }, submitExam() { clearInterval(this.data.timer); request(/exam/submit, POST, { sessionId: this.data.sessionId, answers: this.data.userAnswers }).then(res { wx.redirectTo({ url: /pages/score/score?sessionId${this.data.sessionId} }); }); } });这段代码体现了计时和交卷的联动。startTimer 每秒递减 remainTime归零时自动调到 submitExam用户点交卷按钮时也会进入同样的提交逻辑这样避免手动交卷和倒计时交卷两套代码不一致。onLoad 里先创建会话后端返回 duration 分钟数前端乘以 60 变成秒。这里要特别注意 setInterval 的清理——页面卸载 onUnload 时必须 clearInterval否则用户切到其他页面时计时器还在跑下次进入会同时存在多个 interval导致倒计时加速。我在源码里就见过这个翻车场景典型的“多一个 timer 就少一分钟考试时间”。4.3 成绩分析把答题记录聚合成分数曲线和弱项标签做完交卷下一个模块是成绩分析。源码里在个人中心有一个成绩展示区包含最近几次模考分数、平均分、最高分以及按科目维度的正确率。后端实现这些统计并不复杂核心是两步查用户所有答卷记录再做内存聚合。我给出一个简化的 SQL 统计思路。-- 统计某用户最近五次的得分 SELECT session_id, score, create_time FROM tb_exam_session WHERE user_id #{userId} ORDER BY create_time DESC LIMIT 5; -- 按科目统计正确率 SELECT q.subject_id, COUNT(*) AS total_cnt, SUM(CASE WHEN ua.is_correct 1 THEN 1 ELSE 0 END) AS correct_cnt FROM tb_user_answer ua JOIN tb_question q ON ua.question_id q.id WHERE ua.user_id #{userId} GROUP BY q.subject_id;第一条语句拿最近五次分数前端用 Canvas 或者 ECharts 画折线图第二条语句按科目聚合正确题数和总数再算正确率。这样成绩分析页面就能显示“政治正确率 72%英语 58%数学 41%”提示用户薄弱科目。这里有个性能边界如果用户历史答题记录超过十万条统计接口会变慢常见做法是加一张用户科目统计表每次交卷后增量更新而不是实时聚合。毕设阶段用上面的 SQL 完全够到了上线前再考虑加缓存。5. 避坑 / 常见问题拆这份考研小程序源码时我踩过的五个坑5.1 后端接口一直 404小程序页面白屏无数据现象小程序页面打开后列表区域一片空白后端控制台也没有任何请求日志。 原因最常见的是 BASE_URL 拼接错误。源码里 utils/request.js 的 BASE_URL 默认是 127.0.0.1:8080而 Controller 的 RequestMapping 带 /api 前缀如果前端请求路径拼成 /api/api/subject/list就会出现 404。 解决在 request.js 里打印完整 url和后端 Mapper 层 SQL 中实际路径对比。我一般会在后端 Controller 里临时加一组 log观察请求是否到达如果到达说明路径对没到达说明前端拼错或域名配置不对。修改后重启小程序确认网络请求落到正确 URL。这个坑的本质是前后端路径规范没有对齐建议把后端所有接口统一放在 /api 下小程序端 BASE_URL 不重复带 /api两边约定好后续扩展功能就不会再犯。5.2 数据库中文乱码查询结果全是问号现象第一次登录成功后用户名和学校名称存进去再从数据库查出来全是 ???。 原因数据库表默认字符集不是 utf8mb4。源码里的 SQL 脚本可能带了 DROP TABLE 和 CREATE TABLE但建库时用的是默认 latin1导致中文插入时被截断。 解决用 Navicat 把整库字符集改成 utf8mb4再执行 ALTER TABLE tb_user CONVERT TO CHARACTER SET utf8mb4; 最好在建库阶段就把库、表、列全部设置成 utf8mb4。从那以后我每次导入 SQL 前都会先看一眼 CREATE TABLE 语句里的 DEFAULT CHARSET没写的坚决手动补上毕竟字符集翻车比代码逻辑翻车更难排查。5.3 HBuilder X 编译 uniapp 报错提示找不到 vue 文件现象用 HBuilder X 打开 uni-app 版本运行时提示编译失败错误信息指向 pages/index/index.vue 不存在或路径错误。 原因HBuilder X 需要安装 uni-app 编译器插件且项目运行时目录要选到 manifest.json 所在层。如果你把整个 zip 解压后直接拖进 HBuilder X它可能把内层 project 目录当成了工程根目录导致 pages 路径全部偏移。 解决在 HBuilder X 里重新导入工程路径选到包含 manifest.json 的文件夹然后点击工具栏的“运行→运行到小程序模拟器→微信开发者工具”。打开前确认微信开发者工具已开启服务端口否则编译完无法自动拉起。这个问题的另一个常见变体是 HBuilder X 版本太旧找不到 uni-app 编译器插件建议直接升级到 3.x 最新稳定版并用 HBuilder X 自带的插件市场安装依赖。5.4 登录成功后 token 校验失败每次请求都跳回登录页现象登录接口返回 token但跳转到首页后再次请求数据时后端口返回 401前端又强制 reLaunch 到登录页形成死循环。 原因登录接口返回的数据结构可能不是统一的 Resulttoken 字段名在登录响应里是 data.token但 request.js 里读的是 res.token也可能是后端拦截器对白名单判断失误把所有 /api/** 请求都拦截了。 解决先看登录接口的返回 JSON确认 token 字段路径再到后端拦截器里检查白名单配置把 /api/login 和 /api/register 配置为放行。我踩这个坑最终的解决方法是统一后端 Result 结构所有接口都放 code、data、msg 三个字段前端解析时只用 res.data这之后类似的字段错位问题再没出现过。小程序端缓存 token 时也要注意setStorageSync 和 getStorageSync 的键名必须一致大小写都不能错。5.5 真机预览时图片和 banner 加载不出来现象模拟器里首页轮播图正常但预览到手机后图片全空白报错域名不合法。 原因图片地址是 http 协议微信小程序在真机环境下默认不允许访问非合规域名特别是 IP 地址加端口的形式即便本地设置已勾选不校验域名真机预览仍会拦截。 解决临时做法是把图片换成 base64 或者用云存储链接正式做法是为后端配置 HTTPS 域名同时在小程序后台把该域名加入 downloadFile 合法域名。毕设演示如果只想在真机上看效果可以用微信开发者工具的“预览”二维码在工具里勾选“不校验合法域名”再编译通常能绕过部分限制但对于 IP 直连仍可能失败所以我的建议是准备一套线上图片链接避免答辩现场翻车。这类问题在源码里比较普遍因为本地开发用的图片资源基本都是本地路径没有专门为真机环境做适配。6. 进阶玩法把毕设源码改成你的课设或上线作品的三步实操6.1 快速换皮改全局配置、导航栏和主题色换皮的核心不在页面里而在 app.json 和 app.wxss。app.json 里的 window 配置控制导航栏背景色和标题文字tabBar 配置底部菜单app.wxss 里通常定义了全局主题色变量。把这两个文件里的颜色替换成你的主题色再改 pages 下对应页面的后缀标题整个项目的观感就变了。注意 tabBar 涉及图标如果你没有设计资源可以直接沿用原图或者用 iconfont 字体图标替换注意图标要匹配 selectedColor 和 color。6.2 给真题模块加一个“收藏错题”功能这个功能适合作为课设的加分项。实现思路新增 tb_favorite 表字段为 id、user_id、question_id、create_time。在真题练习页里加一个“加入错题本”按钮点击时调用 /api/favorite/add传 questionId个人中心加一个错题列表页复用真题列表组件只展示收藏的题目。要注意错题本里的题目需要展示解析所以 add 接口只需要存 idlist 接口查出来时带上 analysis 字段这部分跟 4.1 节列表屏蔽解析的设计相反实现时不要搞混。6.3 把本地 MySQL 迁到云数据库顺便解决时区问题如果你想把项目部署到服务器常见做法是把本地 SQL 导出在云数据库新建库后执行。迁移后修改 application.yml 里的连接 URL把 127.0.0.1 换成云数据库内网地址并在控制台放行 3306 访问。这里有一个我反复遇到的细节云数据库默认时区是 UTC需要在 URL 参数里强制 serverTimezoneAsia/Shanghai否则所有时间字段都慢八小时。另外把配置里的 root 密码替换成云数据库密码时务必确认账号具有 DDL 权限否则首次启动时自动建表会失败。这套源码完整包含前后端、SQL 和说明文档只要按第二章到第三章的路径去装环境、跑通登录你基本就能掌控整个项目。我自己后来在给学生改课设时每次接手别人的工程都会强制走一遍“先导入数据库再改配置再跑登录”的流程这套习惯救过我很多次避免了一上来就在代码里瞎找方向的尴尬。希望帮到你。本文还有配套的精品资源点击获取
