简介这套源码包是一份基于Spring Boot和uniapp的公考学习平台项目后端以Java实现数据层采用MySQL适合高校学生、Java开发者用于学习前后端分离开发或毕业设计参考。资源压缩包共收纳1347个文件大小约27.92MB类型覆盖257个vue页面、144个java后端代码、160个js脚本、161个svg图标还有微信小程序专用的wxml与wxss文件同时包含sql初始化脚本、yml配置、md说明文档以及bat辅助脚本各模块层次清晰便于定位前端页面、接口实现与数据表结构。当前已有53人学习下载项目虽不算热门但功能完整涵盖用户在线做题、学习资源浏览、管理员对题库和内容的管理等模块。通过源码整体阅读可以理解小程序端与后端API的交互方式、登录鉴权与数据流转逻辑压缩包内的数据库脚本能帮你快速还原环境在此基础上二次开发效率较高。1. 基于Spring Boot和uniapp的公考学习平台拿到源码不等于拿到系统刚解压这套基于Spring Boot和uniapp的公考学习平台源码时你大概率看到的是两个并列文件夹一个后端工程、一个前端工程外加一个数据库脚本不会再多了。很多第一次接触这类项目的人第一反应是“双击启动”结果被Maven、Redis、小程序AppID挨个打击了一遍。其实它解决的问题很清楚给备考用户提供题库练习、模考、错题记录与学习轨迹给机构或讲师提供可二次开发的管理后台。适合谁呢适合有一定Java基础、想把一套前后端分离项目完整跑通再改成自己能交付产品的开发者。接下来就从解压开始一直走到题库替换把每一步命令、配置和踩坑都摆在明面。2. 源码目录与核心架构先看懂Spring Boot后端与uniapp前端各自的主线拿到源码先别急着启动先花二十分钟把目录摊开搞清楚哪些是代码、哪些是配置、哪些是打包产物。这类公考学习平台通常不是一个小demo后端会拆成多个模块前端要同时兼容微信小程序、App和H5胡乱改文件很容易把编译链路搞坏。2.1 后端Spring Boot工程怎么拆从启动类到controller/service/mapper用IDEA打开后端工程后第一眼先找带SpringBootApplication注解的启动类通常放在com.xxx.exam这类包下的ExamApplication.java。它旁边一般是controller、service、mapper、entity四个包这是最标准的Spring Boot分包方式控制器接请求、服务层写业务、Mapper操作数据库、实体类映射表。你不需要记复杂术语只要记住一条调用线页面请求进来先找ControllerController调ServiceService调Mapper结果反向返回。# 用tree命令快速看后端工程结构-L 3只显示三层避免被target目录淹没 tree -L 3 -d backend/src/main/java # 通常你会得到类似下面的目录骨架 # com.xxx.exam # ├── controller # 接收前端请求校验参数 # ├── service # 业务逻辑考试计时、答题判分、错题统计 # │ └── impl # Service接口的实现类 # ├── mapper # MyBatis的Mapper接口对应XML或注解SQL # └── entity # 数据库表的实体类字段与列名一一对应这棵目录树不是某个固定项目的绝对结构但绝大多数公考学习平台后端都长这样。看源码时还要额外注意两个隐藏目录config和common。config里放跨域配置、拦截器配置、Redis序列化配置common里放统一返回结果类、JWT工具类和全局异常处理器。这些东西最容易被新人当成“和业务无关”跳过其实它们决定登录态和接口返回格式改了会影响全站接口。这种工程为什么选Spring Boot MyBatis组合因为公考平台的业务核心是题库和试卷属于典型的“单表查询多、事务中等、报表少”场景。MyBatis能直接用XML写复杂SQL比如多条件筛选题目、连表查答题记录比JPA那种Hibernate风格更直观。Spring Boot的自动配置让你不用碰一堆XML配置文件一个application.yml就能把数据源、Redis、端口都管起来。再配合Spring Boot Admin这类监控组件上线后看内存、线程池和接口QPS都很方便。理解了这一点你再看源码就容易抓住重点那些带着RestController、Service、Mapper注解的类才是题库、考试、用户三条主线的核心。看后端时我一般会顺手打开pom.xml确认用了哪些依赖。常见依赖无非是mybatis-spring-boot-starter、spring-boot-starter-data-redis、jjwt、lombok。如果某个版本特别老比如Spring Boot 1.x趁早升级或换方案否则后面调试会非常痛苦。另一个要留意的点是登录机制。公考平台通常用JWT拦截器会拦下所有/api/**接口只有登录和验证码接口放行。这个逻辑在config包的WebMvcConfigurer实现里。你理解它之后就能解释为什么前端请求要带Authorization头也就能定位“登录成功但拉不到数据”这类问题。2.2 前端uniapp的目录与多端编译逻辑pages/static/uni_modules怎么对应小程序、App和H5后端看完了切到前端。uniapp工程打开后第一眼可能看到sitemap.json这类小程序专用文件别被它们绊住。核心目录是pages、static、uni_modules外加三个必须认识的配置pages.json、manifest.json、App.vue。pages.json是路由字典声明哪些页面存在以及底部的tabBarmanifest.json是打包配置应用名称、小程序AppID都在这App.vue是全局生命周期登录态检查和全局样式通常写在这。# 前端工程主干目录同样用tree只看三层 tree -L 3 -d app # pages/ # 页面按业务分成 exam、user、course、question 等子目录 # static/ # 静态资源图片、图标、启动图 # uni_modules/ # uni-app插件下拉刷新、图表等组件都装在这里 # common/ # 公共工具request.js 封装了uni.request # 关键配置不在这棵树下而在根目录的 pages.json 和 manifest.json这里最关键的是理解uniapp的“多端编译”不是黑匣子。它编译成微信小程序时会去掉浏览器专用API保留uni.request、uni.navigateTo这种封装好的跨端API编译成App时又能通过plus.*调用原生能力跑在H5时则走正常浏览器网络栈。所以你在源码里看到类似#ifdef MP-WEIXIN的注释时这不是普通注释而是条件编译表示只有微信小程序才会编译这段代码。比如考试页面可能长这样// #ifdef MP-WEIXIN uni.showToast({ title: 交卷成功, icon: none }) // #endif // #ifdef H5 console.log(交卷成功) // #endif这种代码解决同一业务在不同端的差异。碰到这种写法不要手贱删掉“看着没用”的几行否则小程序端可能弹不出提示或者H5端直接报错。理解前端时始终记住一条主线所有页面都在pages下每个页面由一个.vue文件承载公共请求封装在common/request.js里里面用的是uni.request页面跳转、分享、支付这些能力优先用源码里现成的uni.*封装不要自己另起炉灶写原生API。后面打包遇到问题追查顺序也按这条主线来页面问题看pages.json接口问题看request.js端能力问题看manifest.json。如果你发现static目录下有一堆压缩包别解压到工程里打包时会把它们也带进去徒增体积。这个习惯在公考平台这种图表资源多的项目里特别重要。3. 把Spring Boot后端跑起来从数据库初始化到接口验证这一章进入首次启动。后端跑不起来前端全部白搭。很多下载过源码的人卡在“数据库连不上”“Redis没装”“启动类找不到”其实只要按顺序做完三件事建库导表、改配置、启动验证。顺便说一句这套流程对大多数Spring Boot uniapp项目都通用不只是公考平台。3.1 数据库初始化与配置文件修改把application.yml里的连接信息换成自己的公考学习平台一般用MySQL存业务数据用Redis存验证码、Session或微信Token。解压包里如果带了sql目录里面通常是exam_platform.sql这样的初始化脚本。别用记事本打开看直接用命令行导入。先确保本地MySQL和Redis已经启动。MySQL正常版本5.7以上都行Redis随意一个稳定版即可但要注意这两个服务必须在启动后端之前就在线。# 假设你的MySQL账号是root密码是123456先登录创建数据库 mysql -uroot -p123456 # 在MySQL控制台里执行 CREATE DATABASE exam_platform DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 然后退出控制台用mysql命令导入SQL脚本 mysql -uroot -p123456 exam_platform backend/src/main/resources/sql/exam_platform.sql导入完成后打开backend/src/main/resources/application.yml。这里要改的地方集中在spring.datasource和spring.redis两段。常见配置类似下面这样spring: datasource: url: jdbc:mysql://localhost:3306/exam_platform?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379 password: database: 0 mybatis: mapper-locations: classpath*:mapper/*.xml type-aliases-package: com.xxx.exam.entity server: port: 8080参数说明serverTimezoneAsia/Shanghai是为了避免MySQL时区报错必须加useSSLfalse是本地环境去掉SSL握手mapper-locations告诉MyBatis去哪找XML里的SQL。如果这里路径写错启动时不报错但一查接口就会说“Invalid bound statement”。密码建议放到环境变量比如${DB_PASSWORD:123456}这样代码仓库里不暴露明文。如果工程里没给你sql文件也可以让Spring Boot启动时用schema.sql初始化但生产不建议这样干。3.2 启动后端用Maven命令和IDEA把8080端口跑起来配置改好后启动就两条路。只用命令行的话在backend目录下执行Maven命令。国内下载依赖慢可以先配好阿里云Mirror否则卡在download会让你怀疑人生。IDEA用户更简单打开项目后等右下角Maven索引跑完直接运行ExamApplication里的main方法。# 后端工程根目录下执行先打包跳过测试再启动 cd backend mvn clean package -DskipTests java -jar target/exam-platform-0.0.1-SNAPSHOT.jar # 如果只是想快速起服务也可以直接 mvn spring-boot:run -DskipTests启动成功的标志不是控制台刷了一堆日志而是看到类似“Started ExamApplication in 14.32 seconds”的一行。如果工程里配了spring-boot-starter-actuator还可以访问/actuator/health看到{status:UP}。很多公考平台还集成了Spring Boot Admin这时你会多看到一个/admin监控页能看每个接口的调用次数和线程池状态。第一次跑通后别急着高兴先做接口验证。# 换个终端用curl调一个不需要登录的公开接口比如图形验证码 curl -v http://localhost:8080/api/system/captcha # 期望返回JSON比如 {code:200,msg:ok,data:{captchaKey:xxx,image:data:image/png;base64,...}} # 如果返回404先看Controller类上的RequestMapping前缀是不是 /apicurl的-v参数能看到完整请求响应头排查404特别有用。接口路径对不对去看Controller类上有没有类级RequestMapping(/api/system)这个类级前缀经常被忽略。登录接口通常要求POST且参数在RequestBody里直接用curl要带-H Content-Type: application/json和-d {mobile:13800138000,password:123456}。3.3 启动后的验证与监控看日志、Swagger和Spring Boot Admin后端启动成功只能算“活过来了”还要确认业务闭环是通的。最简单的方式是看项目里有没有集成Swagger或knife4j。如果有访问http://localhost:8080/doc.html就能看到所有接口文档这就是项目的自测入口。没有Swagger的话就靠日志把application.yml里的日志级别调成DEBUG看SQL执行情况。logging: level: com.xxx.exam.mapper: debug # 打印MyBatis的SQL和参数 org.springframework.data.redis: info这里的com.xxx.exam.mapper要替换成你自己项目的Mapper包名。开了DEBUG后每次请求数据库都会在控制台打印预编译SQL和传入参数定位“查不到数据”和“SQL写错”非常有用。上线前记得调回INFO否则日志量会大到磁盘报警。验证完登录接口能返回Token后端部分就算真正跑通了。Token一般是一串JWT前端之后每次请求都要在请求头带Authorization: Bearer token这个逻辑在config里的拦截器类能看得一清二楚。4. 前端uniapp跑起来并打包成微信小程序从HBuilderX到开发者工具后端通了前端才能联调。这章的目标是把uniapp工程跑进微信开发者工具并且能用真实接口登录、答题。常见做法是用HBuilderX做编译再用微信开发者工具打开产物目录。别用VS Code强行编译uniapp除非你已经非常熟悉CLI工程。4.1 用HBuilderX导入uniapp工程并理解编译目标首先安装HBuilderX菜单里选“文件 - 导入 - 从本地目录导入”选择前端工程根目录。导入成功后左边资源管理器能看到pages.json、manifest.json这些文件。先别点运行先检查manifest.json里有没有有效的小程序AppID。没有的话填测试号但测试号无法调用真机上的登录和支付能力。// manifest.json 里与微信小程序相关的片段 { mp-weixin: { appid: 你的小程序AppID, setting: { urlCheck: false, // 本地调试时关掉域名校验 es6: true, // ES6转ES5低版本微信基础库需要 minified: true // 压缩代码 }, usingComponents: true } }urlCheck这个开关要记住。本地联调后端是http://localhost:8080如果不关掉它微信开发者工具会拦截请求并提示“不在以下合法域名列表中”。等到上线再把这个开关改回true并在小程序管理后台把正式HTTPS域名加白。运行阶段HBuilderX里选择“运行 - 运行到小程序模拟器 - 微信开发者工具”它会在后台生成dist/dev/mp-weixin目录并自动拉起开发者工具。4.2 联调后端把request的baseUrl指到本地接口跑起来后前端页面里的数据全是空的因为所有请求还在往生产地址或默认的localhost:8080打。找到common/request.js里面通常有一个BASE_URL常量或baseUrl变量。这里就是前后端联调的枢纽。// common/request.js 中常见的baseUrl配置 const BASE_URL http://localhost:8080/api export function request(options) { return new Promise((resolve, reject) { uni.request({ url: BASE_URL options.url, method: options.method || GET, data: options.data || {}, header: { Content-Type: application/json, Authorization: uni.getStorageSync(token) ? Bearer uni.getStorageSync(token) : }, success: (res) { if (res.statusCode 200) { resolve(res.data) } else { uni.showToast({ title: 请求失败, icon: none }) reject(res) } }, fail: (err) reject(err) }) }) }这里有两个参数容易看漏。第一个是/api前缀如果后端Controller类级前缀已经是/api那这里的BASE_URL写http://localhost:8080就可以否则会出现双/api/api第二个是Authorization头是从uni.getStorageSync(token)里取值的说明登录成功后必须把Token存进Storage这个操作通常在登录页或App.vue的全局登录回调里完成。改完baseUrlHBuilderX里重新编译页面应该能拿到真实数据了。如果页面还是空先在浏览器开发者工具里看当前请求是不是打到了localhost:8080再去追Controller路径。4.3 打包微信小程序manifest配置、AppID和开发者工具导入本地运行只是开发态真正要交付或测试还得走一遍“发行”流程。HBuilderX菜单“发行 - 小程序-微信”会生成dist/build/mp-weixin目录。此时再用微信开发者工具“导入项目”目录选这个产物目录AppID填正式AppID就能看到打包后的效果。# 打包产物常见位置 dist/build/mp-weixin # ├── app.js # ├── app.json # 页面路由和窗口配置编译时由pages.json生成 # ├── app.wxss # ├── pages/exam/index.js # ├── pages/exam/index.wxml # └── static/ # 静态资源这里要注意不要在微信开发者工具里直接改产物代码改完下次发行会被覆盖。源码改了之后在HBuilderX重新发行。上线前最后一步是把manifest.json里的urlCheck设为true小程序后台配置request合法域名且域名必须备案并支持HTTPS。如果只是为了本地验收用“测试号”跑通业务已经足够不需要真的申请AppID。发行时如果报“source size 2612kb exceed max limit 2mb”那是包体超限处理办法写在第5章先别慌。5. 公考学习平台高频问题排查四个真实踩过的坑这一章写四个我实际处理过的高频问题每一条都按“现象 - 原因 - 解决”来写。你照着源码走一遍大概率会遇到其中两三个尤其第一次做小程序交付的人几乎都会撞上包体超限。5.1 现象uniapp真机调试console.log不打印你在微信开发者工具里看到Console日志很正常一拿到真机用“真机调试”就什么都看不见甚至怀疑代码没执行。这不是代码没执行而是日志根本没输出。很多uniapp工程会在构建时通过环境变量把日志关掉另一个常见原因是HBuilderX的调试基座版本和工具版本不一致。原因工程使用了生产环境过滤日志的机制或者真机模式与开发者工具模式的构建产物不同HBuilderX真机调试基座与当前版本不匹配时日志通道会断掉。解决不要裸用console.log自己封装一个带开关的日志函数用条件编译区分环境。// utils/logger.js 替代裸奔的console.log const isDebug true // 本地调试开true正式包改false export function log(message, data) { if (!isDebug) return // #ifdef H5 console.log([公考平台], message, data) // #endif // #ifdef MP-WEIXIN console.log([公考平台], message, data) // #endif }参数说明isDebug在本地调试时设true正式包改成false或从process.env里读。不要只包一层而不区分端因为某些端对console.log多参数的处理不同。真机调试时优先选择“自定义调试基座”并保持HBuilderX版本一致日志消失这种玄学问题基本就能解决。5.2 现象小程序报 source size 2612kb exceed max limit 2mb发行微信小程序时最经典的红色报错是“main package source size 2612kb exceed max limit 2mb”。公考平台上题目资源多稍微放几张高清封面图就会超。这里要理解微信小程序的限制主包加分包有总限制但最容易卡的还是单包2MB。原因图片、题库JSON、字体文件被当静态资源塞进了主包uni_modules里引入了很大的组件库页面里只用了一两个没开分包。解决先删后分。删掉static里不再使用的图片把大图换成对象存储或图床链接。然后按页面加subPackages把考试答题相关页面放到分包里首页和登录留在主包。// pages.json 中配置分包示例只放exam相关页面 { pages: [ pages/index/index, pages/login/login, pages/user/user ], subPackages: [ { root: pages/exam, pages: [ list/index, detail/index, answer/index ] } ] }配置分包后HBuilderX会自动把pages/exam下的代码和它独享的static资源拆到分包主包体积立刻可以降下去。注意分包之间不能互相引用分包根目录外页面跨包跳转要写/pages/exam/list/index这种绝对路径。替换完要清一下缓存再重新发行体积统计偶尔会因旧产物残留而虚高。删文件前记得用Git或备份让你的“后悔药”备好。5.3 现象登录接口返回404或者“参数格式错误”前端页面一切正常点登录按钮后端日志也没打状态码404。排查时发现BASE_URL和Controller路径都对但接口就是404。这种问题八成不在路径而在请求头或请求方式。原因后端接口用RequestBody接收对象前端却把参数拼成了form格式Content-Type还是application/x-www-form-urlencoded后端接口要求POST前端传了GET有的公考平台把接口前缀统一放在server.servlet.context-path前端忘了拼。解决先看开发者工具里Network面板的实际请求URL、Method和Payload再改前端请求封装。// request.js 中统一强制JSON格式 header: { Content-Type: application/json } // 调用时使用 request({ url: /auth/login, method: POST, data: { mobile: 13800138000, password: 123456 } })如果后端接口是RequestBody前端数据体必须是JSONuni.request传对象时会自动序列化问题不大。如果你把data写成json字符串反而出错。另外注意很多平台登录接口返回的code字段不是HTTP状态码业务层返回code5000表示密码错误可HTTP却是200。这时候看res.data.code别只看状态码200就以为成功了。5.4 现象考试倒计时一会慢一会快交卷后时间对不上在线模考里最影响体验的是倒计时。前端写个setInterval每秒减1一开始挺准过了几分钟就慢了或者手机锁屏再打开时时间直接多扣了两分钟。这不是题目有问题是移动端计时器在后台被系统挂起了。原因setInterval在后台会被系统挂起切回来时不会补执行而是一下子跳变本地时间与服务器时间有偏差交卷判分时后端按服务器时间计算两端不一致。解决开始答题时从后端获取一次服务器时间作为考试开始时间基准前端只计算“剩余时间 考试截止时间 - 当前时间”不本地累加。每次切回前台时重新校准一次。// 假设后端返回考试开始时间戳 startTime 和考试时长 durationMinutes function getRemainTime(startTime, durationMinutes) { const endTime startTime durationMinutes * 60 * 1000 const now Date.now() const remain endTime - now return remain 0 ? Math.ceil(remain / 1000) : 0 } // 切回页面时触发onShow重新取时间 onShow() { this.remainTime getRemainTime(this.examStartTime, this.examDuration) }如果你想让倒计时更平滑也可以在每次setInterval执行时都重新计算下一个整秒应显示什么。公考平台对交卷时间一致性有硬要求成绩要以服务器落库时间为准。前端只做展示真正交卷时后端要校验当前时间是否超过截止时间。倒计时显示不准会让答题卡统计和判分产生偏差这条一定要在正式上线前修掉。6. 把题库换成自己的从Excel导入到在线模考的数据链路公考平台的核心资产是题库页面和框架只是壳。拿到源码后先别急着改页面把题目数据摸清楚比什么都重要。题目表一般至少要有type、content、option_a到option_d、answer、analysis和category_id这些字段。先看表结构再对照着整理你自己的Excel。6.1 从Excel到SQL题库导入脚本把Excel转成SQL是替换题库的第一步。常见做法是用Python脚本生成INSERT语句再执行到MySQL。下面这段脚本只处理最简单的单选、多选但字段映射逻辑是通用的。import pandas as pd # 读取Excel题库列名需要与数据库表字段对应 df pd.read_excel(questions.xlsx) values , .join([ f({row[type]}, {row[content].replace(chr(39), chr(39)*2)}, f{row[a]}, {row[b]}, {row[c]}, {row[d]}, f{row[answer]}, {row[analysis]}) for _, row in df.iterrows() ]) sql fINSERT INTO t_question (type, content, option_a, option_b, option_c, option_d, answer, analysis) VALUES {values}; with open(import.sql, w, encodingutf8) as f: f.write(sql)参数说明内容里有单引号时必须翻倍转义否则导入必炸Excel中涉及图片路径的用相对路径放到static下或者直接存URL。导入后执行SELECT COUNT(*) FROM t_question确认行数没丢。6.2 验证一条完整答题链路导入不是终点要验证“答题 - 交卷 - 判分 - 错题本”整条链路。用管理员账号登录后台新建一套模拟卷并把题目挂上去然后小程序端选卷、开始答题、交卷最后看成绩是否正确。重点检查选项顺序是否错位、答案字段大小写是否匹配、题目分类是否有空值。我自己换题库时有过一次翻车Excel里某一行选项D为空前端渲染出来只有三个选项用户点不了答案。后来养成习惯导入后先批量查一遍空字段。这套源码值不值得投入其实就看你能不能把题库换掉并稳定跑过一轮模考能就说明你已经掌握了它的数据链路和部署方式后续加课程、加资讯都只是换汤不换药。希望帮到你。本文还有配套的精品资源点击获取