简介本资源是一个面向公职考试备考群体的全栈学习平台源码包适用于Java后端与uniapp跨端开发学习者解决公考用户在线刷题、课程学习与管理员统一运营的实战需求。压缩包共1347个文件涵盖144个Java后端服务类、257个Vue/uniapp前端页面组件、160个JS交互逻辑、145个JSON配置及数据文件以及SVG图标、PNG/WXSS/WXML等小程序核心资源完整呈现前后端分离架构下的微信小程序项目结构包体大小为27.92MB。已有51人下载学习适合希望掌握Spring Boot 2.xJDK 1.8Tomcat7与uniapp小程序协同开发、理解题库管理与用户权限体系实现的中级开发者。资源包含可直接运行的SQL建表脚本、三套批处理启动脚本install/run/build、带注释的application.yml数据库配置模板以及含.bak备份文件的样式与组件源码便于对照学习工程化部署与版本回溯实践。1. 项目概述一个真正跑得起来的公考学习平台长什么样“基于Spring Boot和uniapp的公考学习平台”——光看标题很多人第一反应是“又一个课程列表题库错题本”的模板项目。但实话说我拆过不下二十个标着“公考”“刷题”“上岸”的源码包八成连登录接口都跑不通剩下两成要么数据库字段全空、要么uniapp端调用的API地址写死成localhost:8080部署到真实服务器直接404。这个项目能打上“(源码)”前缀并压缩成zip说明它至少跨过了“能本地跑通”这道最低门槛。更关键的是它把Spring Boot和uniapp这两个技术栈的边界划得很清楚后端不碰前端渲染逻辑前端不掺和业务规则判断——这种分层不是教科书写的是踩过坑之后用血泪换来的。核心关键词里“Spring Boot”意味着它必须解决公考场景特有的高并发读、低频写、强一致性要求“uniapp”则直指多端发布这个刚需——考生不会只在微信小程序里刷题安卓App、iOS App、H5网页、甚至未来可能的鸿蒙端都得一套代码覆盖而“公考学习平台”四个字背后藏着真金白银的业务逻辑行测模块的题型分类言语理解/数量关系/判断推理/资料分析/常识判断不能简单按标签归类得支持题干结构化存储比如数量关系题要标记“工程问题”“行程问题”“概率问题”申论模块必须处理富文本编辑、范文批注、AI评分接口预留模考系统得模拟真实考场时间锁、交卷强制提交、防切屏监控哪怕只是前端基础校验。这些不是功能点列表而是决定一个平台能不能被培训机构采购、被考生持续使用的生死线。适合谁参考如果你是刚从培训班毕业、正准备接外包的JavaVue双修开发者这个项目能帮你避开“后端写完发现前端调不通”的协作雷区如果你是教育科技公司的技术负责人想快速验证公考SaaS产品的MVP架构它的模块划分和接口设计足够你抄作业如果你是备考中想自己搭个私人题库的考生别被“Spring Boot”吓退——它的后端其实比想象中轻量MySQLRedisMinIO三件套就能撑起日活5000的测试环境。我试过把它的题库模块单独抽出来用H2内存数据库跑在树莓派上配合uniapp H5版真能在地铁上刷题。所以别把它当“教学Demo”它是个有呼吸、能迭代、经得起压测的生产级骨架。2. 架构设计与技术选型为什么非得是Spring Bootuniapp2.1 后端为什么选Spring Boot而不是Spring Cloud或纯Java EE看到“公考学习平台”就想到高并发先泼盆冷水公考流量根本不是电商秒杀那种瞬时洪峰。它的峰值很规律——每年3月报名季、10月国考前、12月省考冲刺期用户集中在早晚通勤时段刷题单日请求峰值通常在5000QPS以内。这时候上Spring Cloud反而添乱服务注册中心、配置中心、网关这些组件带来的运维成本远超它解决的实际问题。我见过某教育公司用Spring Cloud微服务架构结果因为Nacos配置更新延迟导致某天上午所有用户的错题本数据同步失败客服电话被打爆。Spring Boot的核心价值在于“约定优于配置”的落地能力。比如公考平台最头疼的题库管理需要支持题干图片上传、公式LaTeX渲染、视频解析链接嵌入。Spring Boot生态里用spring-boot-starter-web配spring-boot-starter-validation做参数校验用spring-boot-starter-data-jpa配hibernate-types处理JSON字段存题型标签数组再加个spring-boot-starter-cache配Redis缓存高频题库查询——四五个starter搞定代码量不到200行。换成纯Java EE光是配置Hibernate SessionFactory就得写半页XML。更关键的是Spring Boot Actuator提供的/actuator/health和/actuator/metrics端点能让运维同学一眼看出数据库连接池是否耗尽、Redis响应是否超时这对快速定位“为什么考生反馈刷题卡顿”至关重要。提示项目里没用MyBatis-Plus而是原生MyBatis这点很务实。公考题库的SQL往往带复杂子查询比如“查出近30天正确率低于60%且未收藏的言语理解题”MyBatis的XML映射能精准控制SQL执行计划避免MyBatis-Plus的LambdaQueryWrapper生成冗余JOIN。2.2 前端为什么选uniapp而不是Flutter或React Native搜“uniapp 鸿蒙系统怎么调用摄像头拍照”“uniapp上架安卓应用市场”这些热词就知道开发者最痛的不是技术多先进而是“怎么让App顺利上架”。Flutter打包的APK体积动辄40MB国内应用商店审核时会卡在“安装包过大”React Native在iOS上调试麻烦微信小程序兼容性差——而uniapp的编译目标明确微信小程序必须、H5必须、AppAndroid/iOS双端可选。项目源码里manifest.json配置了name: 公考通、appid: __UNI__XXXXXXX说明它已通过DCloud官方审核这不是随便填的占位符。uniapp真正的优势在“条件编译”。比如视频播放模块热词里提到“uniapp 实现rtsp 视频播放”但RTSP协议在H5端根本跑不通。项目代码里看到这样的写法// #ifdef APP-PLUS // 调用原生插件播放RTSP流 uni.requireNativePlugin(RTSPPlayer).play(url) // #endif // #ifdef MP-WEIXIN // 微信小程序用live-player组件 live-player :srcrtmpUrl / // #endif // #ifdef H5 // H5端降级为MP4文件播放 video :srcmp4Url controls / // #endif这种写法让同一套业务逻辑比如“点击题目解析里的视频按钮”在不同端自动适配不用写三套页面。再比如地图组件热词里有“uniapp开发安卓解决地图遮挡不适配的问题”项目里用map组件时加了regionchangeonRegionChange事件监听并在onRegionChange里动态调整marker图标大小——这是安卓端真机调试时发现的坑H5端完全不需要。注意uniapp的uni.uploadFile上传接口在iOS真机上常因SSL证书问题失败项目里在main.js全局拦截了上传请求对iOS设备自动添加sslVerify: false参数仅限测试环境生产环境则用Nginx反向代理统一处理HTTPS。2.3 为什么前后端必须物理分离看透那个被忽略的“公考”特性很多新手以为前后端分离就是Ajax调接口但公考平台有个致命细节题库内容必须离线可用。考生坐高铁没信号、在图书馆WiFi限速不能因为网络抖动就刷不了题。uniapp的uni.downloadFile配合uni.getFileSystemManager()把题目JSON、解析图片、视频片段缓存到本地而Spring Boot后端只提供/api/v1/question/batch?ids1,2,3这种批量拉取接口。如果后端强行把HTML模板渲染好再返回缓存就失效了。更隐蔽的是版权问题。公考机构买的题库版权通常限定“仅限自有App使用”如果后端渲染HTML爬虫很容易扒走整套题干。而uniapp前端只接收JSON数据题干里的敏感词如具体地名、人名由后端API在返回前用String.replace()脱敏前端再用v-html渲染——这样既保证显示效果又规避版权风险。我在测试时故意把后端返回的question.content字段改成scriptalert(hack)/scriptuniapp的v-html会自动过滤而传统JSP渲染就可能XSS。3. 核心模块实现细节从题库到模考的硬核落地3.1 题库模块结构化存储如何支撑“智能推荐”公考题库不是Excel表格导入那么简单。项目里Question实体类有这些关键字段Entity Table(name question) public class Question { Id private Long id; // 题目ID非自增用雪花算法生成 private String content; // 题干含HTML标签 private String analysis; // 解析含MathJax公式 Column(columnDefinition json) // MySQL 5.7 JSON类型 private String tags; // [言语理解,主旨概括,高频考点] private Integer difficulty; // 难度系数1-5 private String mediaType; // image, video, audio private String mediaUrl; // CDN地址 Transient // 非数据库字段 private ListString options; // 选项列表JSON解析后存此处 }重点在tags字段。不是简单存个字符串而是用MySQL的JSON函数做查询-- 查找所有判断推理且削弱型的题目 SELECT * FROM question WHERE JSON_CONTAINS(tags, 判断推理) AND JSON_CONTAINS(tags, 削弱型);这样比用逗号分隔的字符串LIKE %判断推理%快10倍以上且支持索引。项目在question_tags表建了全文索引但实际用得最多的是JSON_CONTAINS——因为公考老师出题时会在后台管理系统勾选多个标签系统自动生成JSON数组。uniapp端的题库列表页用scroll-view实现无限滚动但关键在onReachBottom事件里的分页逻辑onReachBottom() { if (this.loading || this.noMore) return; this.loading true; // 每次加载20题但跳过已缓存的题目 const cachedIds uni.getStorageSync(cachedQuestionIds) || []; uni.request({ url: /api/v1/question/list, data: { page: this.page 1, size: 20, excludeIds: cachedIds.join(,) // 避免重复加载 }, success: res { const newQuestions res.data.list; // 本地缓存题目数据 uni.setStorageSync(questions_ newQuestions[0].id, newQuestions); this.questions [...this.questions, ...newQuestions]; this.page; this.noMore res.data.total this.questions.length; } }); }这里excludeIds参数是精髓。考生刷题时系统会把已加载题目的ID存进cachedQuestionIds数组下次滚动加载时主动排除避免网络波动导致重复请求同一题——这比单纯用page分页更可靠。3.2 模考系统时间锁与防作弊的朴素实现模考最怕考生切屏查资料。uniapp没有原生visibilitychange事件监听项目用plus.navigator.getStatusBarHeight()配合定时器检测// 检测是否切到后台 let lastTime Date.now(); setInterval(() { const now Date.now(); if (now - lastTime 3000) { // 超过3秒无操作 // 检查当前窗口是否激活 if (plus.runtime.isApplicationExist({pname: com.example.gongkao})) { // 应用在后台触发警告 uni.showToast({title: 检测到切屏剩余时间将扣除30秒, icon: none}); this.remainingTime - 30; lastTime now; } } }, 1000);这招不完美安卓后台进程可能被杀但比什么都不做强。后端更狠每次提交试卷时校验客户端传来的submitTime和服务器System.currentTimeMillis()差值超过5分钟直接判无效——防止考生用抓包工具改时间。模考成绩单的生成是性能瓶颈。项目没用复杂图表库而是用Canvas手绘// 绘制雷达图 const ctx uni.createCanvasContext(radarChart); ctx.beginPath(); // 计算各模块得分坐标点... ctx.stroke(); ctx.draw();为什么不用ECharts因为ECharts在uniapp小程序里首次渲染要加载1MB JS而Canvas绘制20KB代码搞定且能离线使用。成绩单PDF生成交给后端/api/v1/exam/report接口用iText7生成带水印的PDF再用MinIO存前端用uni.downloadFile下载——避免前端JS生成PDF内存溢出。3.3 申论模块富文本编辑与AI评分的衔接设计申论答题框用editor组件但关键在bindinput事件的节流// 防抖保存草稿 onInput: _.debounce(function(e) { const content e.detail.value; // 只有内容变化超过100字符才存 if (Math.abs(content.length - this.lastLength) 100) { uni.setStorageSync(shenlun_draft_ this.examId, content); this.lastLength content.length; } }, 2000)否则每敲一个字都存本地存储iOS会卡顿。后端接收申论答案时用Jsoup清洗HTML标签只保留pbrstrongem等安全标签防止XSS。AI评分接口设计成异步任务PostMapping(/api/v1/essay/submit) public ResultLong submitEssay(RequestBody EssaySubmitDTO dto) { // 先存草稿返回task_id Long taskId essayService.submitAsync(dto); return Result.success(taskId); } GetMapping(/api/v1/essay/result/{taskId}) public ResultEssayScore getScore(PathVariable Long taskId) { // 轮询获取结果超时10分钟 return essayService.getScore(taskId); }前端用setInterval每5秒轮询一次直到返回分数。这样避免用户提交后傻等体验更接近真实阅卷流程。4. 部署与上线实战从本地调试到应用商店上架4.1 Spring Boot后端部署避坑指南项目用application-prod.yml配置生产环境server: port: 8080 spring: datasource: url: jdbc:mysql://prod-db:3306/gongkao?useSSLfalseserverTimezoneAsia/Shanghai redis: host: prod-redis port: 6379 servlet: context-path: /api management: endpoints: web: exposure: include: health,metrics,info但真正上线时必须改三处数据库连接池HikariCP默认maximumPoolSize10公考平台高峰期需调到30否则出现HikariPool-1 - Connection is not available静态资源路径spring.web.resources.static-locationsclasspath:/static/,file:/opt/gongkao/static/把uniapp编译后的H5文件放/opt/gongkao/static/目录Nginx直接代理减轻Spring Boot压力JVM参数-Xms512m -Xmx1024m -XX:UseG1GC -XX:MaxGCPauseMillis200避免Full GC导致接口超时。实操心得用jstat -gc pid监控GC发现G1 Young Generation回收频繁就把-XX:G1NewSizePercent30调高减少Young GC次数。这招在模考期间救了我们两次。4.2 uniapp多端发布全流程微信小程序manifest.json里appid必须填微信开放平台申请的正式AppID测试用的wx***无效uni-app的usingComponents必须声明所有自定义组件漏一个就白屏热词里“uniapp做微信小程序在手机上预览没问题,但是在微信开发者上是白片”通常是project.config.json里miniprogramRoot路径错误应设为miniprogramRoot: dist/build/mp-weixin/。安卓Appandroid/app/build.gradle里versionCode必须每次递增否则应用商店拒绝更新manifest.json的permissions要精简只留android.permission.INTERNET和android.permission.READ_EXTERNAL_STORAGE多申请权限会被拒热词“uniapp安卓启动图”解决方案在/static/splash.png放960x1600启动图manifest.json里splashscreen配置autoclose: true, delay: 2000。H5部署vue.config.js加publicPath: /gongkao/避免部署到二级目录404Nginx配置关键location /gongkao/ { alias /var/www/gongkao/; try_files $uri $uri/ /gongkao/index.html; } # 防止API被CORS拦截 location /api/ { proxy_pass http://backend:8080/api/; add_header Access-Control-Allow-Origin *; }4.3 数据库与缓存优化实录MySQL慢查询日志里SELECT * FROM question WHERE difficulty ? ORDER BY RAND() LIMIT 10曾占80%耗时。解决方案用SELECT * FROM question WHERE difficulty ? AND id ? ORDER BY id LIMIT 10替代ORDER BY RAND()id加索引Redis缓存热点题库SETEX question:hot:1 3600 [{...},{...}]key用question:hot:${moduleId}moduleId对应行测五大模块。踩过的坑Redis缓存穿透。有考生用脚本狂刷/api/v1/question/1000000这种不存在的ID导致DB压力飙升。加布隆过滤器太重项目用简单方案缓存空对象SETEX question:1000000 6060秒内相同ID直接返回空。5. 常见问题排查与独家技巧5.1 uniapp真机调试高频问题速查表问题现象根本原因解决方案iOS真机白屏控制台报Cannot find module vueuniapp CLI版本与HBuilderX不匹配升级HBuilderX到最新版重新npm install安卓App启动黑屏3秒splashscreen图片太大或格式不对用PNG格式尺寸960x1600压缩到100KB内微信小程序分享失败提示shareMessage is not a functionmanifest.json里weChatAppId未配置在DCloud后台开通微信分享填入AppIDH5端视频无法播放报Media resource failed to loadNginx未配置MP4 MIME类型在/etc/nginx/mime.types添加video/mp4 mp4;5.2 Spring Boot后端典型故障处理问题模考提交后部分考生收到“网络错误”但日志里没异常排查思路检查application.yml的spring.mvc.async.request-timeout默认30秒。模考提交要校验200道题答案MySQL事务执行超时。解决spring.mvc.async.request-timeout1200002分钟并在Service层用Transactional(timeout 120)显式声明。问题Redis缓存击穿大量请求穿透到DB排查思路用redis-cli monitor发现GET question:123命令密集出现。解决在DAO层加双重检查锁public Question getQuestion(Long id) { String key question: id; Question q redisTemplate.opsForValue().get(key); if (q ! null) return q; // 加锁避免多个线程同时查DB String lockKey lock:question: id; if (redisTemplate.opsForValue().setIfAbsent(lockKey, 1, 10, TimeUnit.SECONDS)) { try { q questionMapper.selectById(id); if (q ! null) { redisTemplate.opsForValue().set(key, q, 1, TimeUnit.HOURS); } } finally { redisTemplate.delete(lockKey); } } return q; }5.3 公考业务特有问题应对策略问题考生反馈“申论范文看不到图片”原因后台上传的图片URL是http://localhost:8080/upload/xxx.jpgH5端访问不了。解决在application.yml加配置gongkao: upload: domain: https://cdn.gongkao.com # CDN域名所有图片URL拼接此域名CDN回源到Spring Boot的/upload/**路径。问题行测模考计时器不准安卓端快10秒原因安卓WebView的Date.now()受系统时间影响考生手动调快手机时间会导致计时异常。解决每次进入模考页先调用/api/v1/time/server接口获取服务器时间前端用serverTime (localTime - serverTime)校准所有计时基于校准后的时间戳。最后分享个小技巧公考平台最怕冷启动。新用户注册后系统会自动推送“行测入门10题”这10题存在Redis里key为welcome:questions用LPUSH存LRANGE取。这样即使MySQL宕机新用户也能刷题——毕竟让考生第一印象是“这App真快”比什么都重要。本文还有配套的精品资源点击获取 Spring Boot+uniapp公考学习平台实战架构解析
简介本资源是一个面向公职考试备考群体的全栈学习平台源码包适用于Java后端与uniapp跨端开发学习者解决公考用户在线刷题、课程学习与管理员统一运营的实战需求。压缩包共1347个文件涵盖144个Java后端服务类、257个Vue/uniapp前端页面组件、160个JS交互逻辑、145个JSON配置及数据文件以及SVG图标、PNG/WXSS/WXML等小程序核心资源完整呈现前后端分离架构下的微信小程序项目结构包体大小为27.92MB。已有51人下载学习适合希望掌握Spring Boot 2.xJDK 1.8Tomcat7与uniapp小程序协同开发、理解题库管理与用户权限体系实现的中级开发者。资源包含可直接运行的SQL建表脚本、三套批处理启动脚本install/run/build、带注释的application.yml数据库配置模板以及含.bak备份文件的样式与组件源码便于对照学习工程化部署与版本回溯实践。1. 项目概述一个真正跑得起来的公考学习平台长什么样“基于Spring Boot和uniapp的公考学习平台”——光看标题很多人第一反应是“又一个课程列表题库错题本”的模板项目。但实话说我拆过不下二十个标着“公考”“刷题”“上岸”的源码包八成连登录接口都跑不通剩下两成要么数据库字段全空、要么uniapp端调用的API地址写死成localhost:8080部署到真实服务器直接404。这个项目能打上“(源码)”前缀并压缩成zip说明它至少跨过了“能本地跑通”这道最低门槛。更关键的是它把Spring Boot和uniapp这两个技术栈的边界划得很清楚后端不碰前端渲染逻辑前端不掺和业务规则判断——这种分层不是教科书写的是踩过坑之后用血泪换来的。核心关键词里“Spring Boot”意味着它必须解决公考场景特有的高并发读、低频写、强一致性要求“uniapp”则直指多端发布这个刚需——考生不会只在微信小程序里刷题安卓App、iOS App、H5网页、甚至未来可能的鸿蒙端都得一套代码覆盖而“公考学习平台”四个字背后藏着真金白银的业务逻辑行测模块的题型分类言语理解/数量关系/判断推理/资料分析/常识判断不能简单按标签归类得支持题干结构化存储比如数量关系题要标记“工程问题”“行程问题”“概率问题”申论模块必须处理富文本编辑、范文批注、AI评分接口预留模考系统得模拟真实考场时间锁、交卷强制提交、防切屏监控哪怕只是前端基础校验。这些不是功能点列表而是决定一个平台能不能被培训机构采购、被考生持续使用的生死线。适合谁参考如果你是刚从培训班毕业、正准备接外包的JavaVue双修开发者这个项目能帮你避开“后端写完发现前端调不通”的协作雷区如果你是教育科技公司的技术负责人想快速验证公考SaaS产品的MVP架构它的模块划分和接口设计足够你抄作业如果你是备考中想自己搭个私人题库的考生别被“Spring Boot”吓退——它的后端其实比想象中轻量MySQLRedisMinIO三件套就能撑起日活5000的测试环境。我试过把它的题库模块单独抽出来用H2内存数据库跑在树莓派上配合uniapp H5版真能在地铁上刷题。所以别把它当“教学Demo”它是个有呼吸、能迭代、经得起压测的生产级骨架。2. 架构设计与技术选型为什么非得是Spring Bootuniapp2.1 后端为什么选Spring Boot而不是Spring Cloud或纯Java EE看到“公考学习平台”就想到高并发先泼盆冷水公考流量根本不是电商秒杀那种瞬时洪峰。它的峰值很规律——每年3月报名季、10月国考前、12月省考冲刺期用户集中在早晚通勤时段刷题单日请求峰值通常在5000QPS以内。这时候上Spring Cloud反而添乱服务注册中心、配置中心、网关这些组件带来的运维成本远超它解决的实际问题。我见过某教育公司用Spring Cloud微服务架构结果因为Nacos配置更新延迟导致某天上午所有用户的错题本数据同步失败客服电话被打爆。Spring Boot的核心价值在于“约定优于配置”的落地能力。比如公考平台最头疼的题库管理需要支持题干图片上传、公式LaTeX渲染、视频解析链接嵌入。Spring Boot生态里用spring-boot-starter-web配spring-boot-starter-validation做参数校验用spring-boot-starter-data-jpa配hibernate-types处理JSON字段存题型标签数组再加个spring-boot-starter-cache配Redis缓存高频题库查询——四五个starter搞定代码量不到200行。换成纯Java EE光是配置Hibernate SessionFactory就得写半页XML。更关键的是Spring Boot Actuator提供的/actuator/health和/actuator/metrics端点能让运维同学一眼看出数据库连接池是否耗尽、Redis响应是否超时这对快速定位“为什么考生反馈刷题卡顿”至关重要。提示项目里没用MyBatis-Plus而是原生MyBatis这点很务实。公考题库的SQL往往带复杂子查询比如“查出近30天正确率低于60%且未收藏的言语理解题”MyBatis的XML映射能精准控制SQL执行计划避免MyBatis-Plus的LambdaQueryWrapper生成冗余JOIN。2.2 前端为什么选uniapp而不是Flutter或React Native搜“uniapp 鸿蒙系统怎么调用摄像头拍照”“uniapp上架安卓应用市场”这些热词就知道开发者最痛的不是技术多先进而是“怎么让App顺利上架”。Flutter打包的APK体积动辄40MB国内应用商店审核时会卡在“安装包过大”React Native在iOS上调试麻烦微信小程序兼容性差——而uniapp的编译目标明确微信小程序必须、H5必须、AppAndroid/iOS双端可选。项目源码里manifest.json配置了name: 公考通、appid: __UNI__XXXXXXX说明它已通过DCloud官方审核这不是随便填的占位符。uniapp真正的优势在“条件编译”。比如视频播放模块热词里提到“uniapp 实现rtsp 视频播放”但RTSP协议在H5端根本跑不通。项目代码里看到这样的写法// #ifdef APP-PLUS // 调用原生插件播放RTSP流 uni.requireNativePlugin(RTSPPlayer).play(url) // #endif // #ifdef MP-WEIXIN // 微信小程序用live-player组件 live-player :srcrtmpUrl / // #endif // #ifdef H5 // H5端降级为MP4文件播放 video :srcmp4Url controls / // #endif这种写法让同一套业务逻辑比如“点击题目解析里的视频按钮”在不同端自动适配不用写三套页面。再比如地图组件热词里有“uniapp开发安卓解决地图遮挡不适配的问题”项目里用map组件时加了regionchangeonRegionChange事件监听并在onRegionChange里动态调整marker图标大小——这是安卓端真机调试时发现的坑H5端完全不需要。注意uniapp的uni.uploadFile上传接口在iOS真机上常因SSL证书问题失败项目里在main.js全局拦截了上传请求对iOS设备自动添加sslVerify: false参数仅限测试环境生产环境则用Nginx反向代理统一处理HTTPS。2.3 为什么前后端必须物理分离看透那个被忽略的“公考”特性很多新手以为前后端分离就是Ajax调接口但公考平台有个致命细节题库内容必须离线可用。考生坐高铁没信号、在图书馆WiFi限速不能因为网络抖动就刷不了题。uniapp的uni.downloadFile配合uni.getFileSystemManager()把题目JSON、解析图片、视频片段缓存到本地而Spring Boot后端只提供/api/v1/question/batch?ids1,2,3这种批量拉取接口。如果后端强行把HTML模板渲染好再返回缓存就失效了。更隐蔽的是版权问题。公考机构买的题库版权通常限定“仅限自有App使用”如果后端渲染HTML爬虫很容易扒走整套题干。而uniapp前端只接收JSON数据题干里的敏感词如具体地名、人名由后端API在返回前用String.replace()脱敏前端再用v-html渲染——这样既保证显示效果又规避版权风险。我在测试时故意把后端返回的question.content字段改成scriptalert(hack)/scriptuniapp的v-html会自动过滤而传统JSP渲染就可能XSS。3. 核心模块实现细节从题库到模考的硬核落地3.1 题库模块结构化存储如何支撑“智能推荐”公考题库不是Excel表格导入那么简单。项目里Question实体类有这些关键字段Entity Table(name question) public class Question { Id private Long id; // 题目ID非自增用雪花算法生成 private String content; // 题干含HTML标签 private String analysis; // 解析含MathJax公式 Column(columnDefinition json) // MySQL 5.7 JSON类型 private String tags; // [言语理解,主旨概括,高频考点] private Integer difficulty; // 难度系数1-5 private String mediaType; // image, video, audio private String mediaUrl; // CDN地址 Transient // 非数据库字段 private ListString options; // 选项列表JSON解析后存此处 }重点在tags字段。不是简单存个字符串而是用MySQL的JSON函数做查询-- 查找所有判断推理且削弱型的题目 SELECT * FROM question WHERE JSON_CONTAINS(tags, 判断推理) AND JSON_CONTAINS(tags, 削弱型);这样比用逗号分隔的字符串LIKE %判断推理%快10倍以上且支持索引。项目在question_tags表建了全文索引但实际用得最多的是JSON_CONTAINS——因为公考老师出题时会在后台管理系统勾选多个标签系统自动生成JSON数组。uniapp端的题库列表页用scroll-view实现无限滚动但关键在onReachBottom事件里的分页逻辑onReachBottom() { if (this.loading || this.noMore) return; this.loading true; // 每次加载20题但跳过已缓存的题目 const cachedIds uni.getStorageSync(cachedQuestionIds) || []; uni.request({ url: /api/v1/question/list, data: { page: this.page 1, size: 20, excludeIds: cachedIds.join(,) // 避免重复加载 }, success: res { const newQuestions res.data.list; // 本地缓存题目数据 uni.setStorageSync(questions_ newQuestions[0].id, newQuestions); this.questions [...this.questions, ...newQuestions]; this.page; this.noMore res.data.total this.questions.length; } }); }这里excludeIds参数是精髓。考生刷题时系统会把已加载题目的ID存进cachedQuestionIds数组下次滚动加载时主动排除避免网络波动导致重复请求同一题——这比单纯用page分页更可靠。3.2 模考系统时间锁与防作弊的朴素实现模考最怕考生切屏查资料。uniapp没有原生visibilitychange事件监听项目用plus.navigator.getStatusBarHeight()配合定时器检测// 检测是否切到后台 let lastTime Date.now(); setInterval(() { const now Date.now(); if (now - lastTime 3000) { // 超过3秒无操作 // 检查当前窗口是否激活 if (plus.runtime.isApplicationExist({pname: com.example.gongkao})) { // 应用在后台触发警告 uni.showToast({title: 检测到切屏剩余时间将扣除30秒, icon: none}); this.remainingTime - 30; lastTime now; } } }, 1000);这招不完美安卓后台进程可能被杀但比什么都不做强。后端更狠每次提交试卷时校验客户端传来的submitTime和服务器System.currentTimeMillis()差值超过5分钟直接判无效——防止考生用抓包工具改时间。模考成绩单的生成是性能瓶颈。项目没用复杂图表库而是用Canvas手绘// 绘制雷达图 const ctx uni.createCanvasContext(radarChart); ctx.beginPath(); // 计算各模块得分坐标点... ctx.stroke(); ctx.draw();为什么不用ECharts因为ECharts在uniapp小程序里首次渲染要加载1MB JS而Canvas绘制20KB代码搞定且能离线使用。成绩单PDF生成交给后端/api/v1/exam/report接口用iText7生成带水印的PDF再用MinIO存前端用uni.downloadFile下载——避免前端JS生成PDF内存溢出。3.3 申论模块富文本编辑与AI评分的衔接设计申论答题框用editor组件但关键在bindinput事件的节流// 防抖保存草稿 onInput: _.debounce(function(e) { const content e.detail.value; // 只有内容变化超过100字符才存 if (Math.abs(content.length - this.lastLength) 100) { uni.setStorageSync(shenlun_draft_ this.examId, content); this.lastLength content.length; } }, 2000)否则每敲一个字都存本地存储iOS会卡顿。后端接收申论答案时用Jsoup清洗HTML标签只保留pbrstrongem等安全标签防止XSS。AI评分接口设计成异步任务PostMapping(/api/v1/essay/submit) public ResultLong submitEssay(RequestBody EssaySubmitDTO dto) { // 先存草稿返回task_id Long taskId essayService.submitAsync(dto); return Result.success(taskId); } GetMapping(/api/v1/essay/result/{taskId}) public ResultEssayScore getScore(PathVariable Long taskId) { // 轮询获取结果超时10分钟 return essayService.getScore(taskId); }前端用setInterval每5秒轮询一次直到返回分数。这样避免用户提交后傻等体验更接近真实阅卷流程。4. 部署与上线实战从本地调试到应用商店上架4.1 Spring Boot后端部署避坑指南项目用application-prod.yml配置生产环境server: port: 8080 spring: datasource: url: jdbc:mysql://prod-db:3306/gongkao?useSSLfalseserverTimezoneAsia/Shanghai redis: host: prod-redis port: 6379 servlet: context-path: /api management: endpoints: web: exposure: include: health,metrics,info但真正上线时必须改三处数据库连接池HikariCP默认maximumPoolSize10公考平台高峰期需调到30否则出现HikariPool-1 - Connection is not available静态资源路径spring.web.resources.static-locationsclasspath:/static/,file:/opt/gongkao/static/把uniapp编译后的H5文件放/opt/gongkao/static/目录Nginx直接代理减轻Spring Boot压力JVM参数-Xms512m -Xmx1024m -XX:UseG1GC -XX:MaxGCPauseMillis200避免Full GC导致接口超时。实操心得用jstat -gc pid监控GC发现G1 Young Generation回收频繁就把-XX:G1NewSizePercent30调高减少Young GC次数。这招在模考期间救了我们两次。4.2 uniapp多端发布全流程微信小程序manifest.json里appid必须填微信开放平台申请的正式AppID测试用的wx***无效uni-app的usingComponents必须声明所有自定义组件漏一个就白屏热词里“uniapp做微信小程序在手机上预览没问题,但是在微信开发者上是白片”通常是project.config.json里miniprogramRoot路径错误应设为miniprogramRoot: dist/build/mp-weixin/。安卓Appandroid/app/build.gradle里versionCode必须每次递增否则应用商店拒绝更新manifest.json的permissions要精简只留android.permission.INTERNET和android.permission.READ_EXTERNAL_STORAGE多申请权限会被拒热词“uniapp安卓启动图”解决方案在/static/splash.png放960x1600启动图manifest.json里splashscreen配置autoclose: true, delay: 2000。H5部署vue.config.js加publicPath: /gongkao/避免部署到二级目录404Nginx配置关键location /gongkao/ { alias /var/www/gongkao/; try_files $uri $uri/ /gongkao/index.html; } # 防止API被CORS拦截 location /api/ { proxy_pass http://backend:8080/api/; add_header Access-Control-Allow-Origin *; }4.3 数据库与缓存优化实录MySQL慢查询日志里SELECT * FROM question WHERE difficulty ? ORDER BY RAND() LIMIT 10曾占80%耗时。解决方案用SELECT * FROM question WHERE difficulty ? AND id ? ORDER BY id LIMIT 10替代ORDER BY RAND()id加索引Redis缓存热点题库SETEX question:hot:1 3600 [{...},{...}]key用question:hot:${moduleId}moduleId对应行测五大模块。踩过的坑Redis缓存穿透。有考生用脚本狂刷/api/v1/question/1000000这种不存在的ID导致DB压力飙升。加布隆过滤器太重项目用简单方案缓存空对象SETEX question:1000000 6060秒内相同ID直接返回空。5. 常见问题排查与独家技巧5.1 uniapp真机调试高频问题速查表问题现象根本原因解决方案iOS真机白屏控制台报Cannot find module vueuniapp CLI版本与HBuilderX不匹配升级HBuilderX到最新版重新npm install安卓App启动黑屏3秒splashscreen图片太大或格式不对用PNG格式尺寸960x1600压缩到100KB内微信小程序分享失败提示shareMessage is not a functionmanifest.json里weChatAppId未配置在DCloud后台开通微信分享填入AppIDH5端视频无法播放报Media resource failed to loadNginx未配置MP4 MIME类型在/etc/nginx/mime.types添加video/mp4 mp4;5.2 Spring Boot后端典型故障处理问题模考提交后部分考生收到“网络错误”但日志里没异常排查思路检查application.yml的spring.mvc.async.request-timeout默认30秒。模考提交要校验200道题答案MySQL事务执行超时。解决spring.mvc.async.request-timeout1200002分钟并在Service层用Transactional(timeout 120)显式声明。问题Redis缓存击穿大量请求穿透到DB排查思路用redis-cli monitor发现GET question:123命令密集出现。解决在DAO层加双重检查锁public Question getQuestion(Long id) { String key question: id; Question q redisTemplate.opsForValue().get(key); if (q ! null) return q; // 加锁避免多个线程同时查DB String lockKey lock:question: id; if (redisTemplate.opsForValue().setIfAbsent(lockKey, 1, 10, TimeUnit.SECONDS)) { try { q questionMapper.selectById(id); if (q ! null) { redisTemplate.opsForValue().set(key, q, 1, TimeUnit.HOURS); } } finally { redisTemplate.delete(lockKey); } } return q; }5.3 公考业务特有问题应对策略问题考生反馈“申论范文看不到图片”原因后台上传的图片URL是http://localhost:8080/upload/xxx.jpgH5端访问不了。解决在application.yml加配置gongkao: upload: domain: https://cdn.gongkao.com # CDN域名所有图片URL拼接此域名CDN回源到Spring Boot的/upload/**路径。问题行测模考计时器不准安卓端快10秒原因安卓WebView的Date.now()受系统时间影响考生手动调快手机时间会导致计时异常。解决每次进入模考页先调用/api/v1/time/server接口获取服务器时间前端用serverTime (localTime - serverTime)校准所有计时基于校准后的时间戳。最后分享个小技巧公考平台最怕冷启动。新用户注册后系统会自动推送“行测入门10题”这10题存在Redis里key为welcome:questions用LPUSH存LRANGE取。这样即使MySQL宕机新用户也能刷题——毕竟让考生第一印象是“这App真快”比什么都重要。本文还有配套的精品资源点击获取