拓冰网站定制 
简介这是一套基于SpringBoot与uni-app开发的驾考类答题软件完整毕设源码面向计算机、自动化等专业学生及初/中级全栈开发者用于课程设计、大作业或毕业设计参考。项目功能完备涵盖用户注册登录支持短信模拟验证、题库管理、随机组卷、在线答题、成绩统计与后台管理等核心模块后端采用Java 1.8SpringBootMyBatisMySQLRedisJWT前端适配H5与App双端使用uni-appColorUI框架。压缩包共2000个文件含65个Java后端逻辑文件、101个Vue页面组件、357个JPG与229个PNG资源图、177个JS交互脚本及77个JSON配置整体122.89MB结构清晰、注释规范附带SQL建库脚本与详细项目说明文档。已有813人学习下载评审分达95分提供可直接运行的完整环境后台账号admin/mryin并内置调试提示与验证码绕过方案便于快速上手与二次开发。1. 这不是另一个“驾考题库App”它是一套可跑通、可调试、可交付的SpringBootuni-app全栈毕设闭环你搜“驾考宝典源码”刷出来的大多是截图堆砌、无数据库结构、uni-app前端连登录都报404的“演示包”。而这份资源我上周在实验室帮学生部署时从解压到真机扫码登录、刷题、提交、查成绩——全程没改一行后端SQL没碰uni-app的manifest.json更没去翻GitHub找缺失的node_modules。它不是玩具是按真实驾校考试逻辑建模的科目一/四题型分离、错题自动归集、模拟考试倒计时强制交卷、后台管理员可动态增删题库含图片题。适合两类人一是大三下刚开题、被导师卡在“前后端联调不通”的同学——它把SpringBoot的RestController怎么接uni-app的uni.request、MySQL的tinyint(1)怎么映射成uni-app的布尔值、甚至application.yml里server.port和H5端request.url的协议/端口一致性都踩过坑二是想快速验证“uni-app跨端SpringBoot微服务”技术组合落地成本的工程师——它没用Nacos、没上Redis缓存、没做JWT刷新但所有接口都带Swagger文档数据库脚本含INSERT INTO question的2000条真题数据连exam_record表的start_time和end_time字段精度都设成了datetime(3)。别被“毕设项目”四个字劝退——它的分层足够干净controller → service → mapper → entity连MyBatis的SelectProvider动态SQL都写了注释。2. 搭建前必读环境版本锁死清单与三处关键配置对齐2.1 SpringBoot后端环境硬性要求非建议是必须这份源码基于SpringBoot 2.7.18非3.x构建原因很现实uni-app的uni.uploadFile在H5端对SpringBoot 3.x的RequestPart解析存在兼容性问题且项目中spring-boot-starter-thymeleaf用于后台管理页渲染而Thymeleaf 3.1.x不支持SpringBoot 3.x的WebMvcConfigurer新签名。JDK必须为JDK 8u291注意不是JDK 17因为pom.xml里maven-compiler-plugin的source和target明确设为1.8且mysql-connector-java依赖版本是8.0.26——这个版本在JDK 17下会触发java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter。提示不要试图升级SpringBoot版本我试过升到2.7.18以上QuestionController.java里Valid RequestBody QuestionDTO校验会失效原因是spring-boot-starter-validation的依赖传递链被破坏最终导致“添加题目”接口返回500而非400错误。2.2 uni-app前端编译目标与运行时约束前端工程根目录下的vue.config.js明确指定了outputDir: dist/build这意味着H5端必须部署在同域的SpringBoot静态资源路径下即src/main/resources/static/否则uni.request会因CORS被拦截微信小程序端需将static目录下的config.js中BASE_URL改为SpringBoot的http://localhost:8080/api开发时上线时替换为正式域名App端Android/iOS使用uni-app原生渲染但manifest.json中name字段值为驾考宝典打包时需确保appid已申请否则云打包失败。2.3 数据库初始化不只是执行SQL而是理解表关联逻辑解压包里的database.sql不是简单建表语句它包含三层设计意图题库隔离question表有subject_type TINYINT(1) NOT NULL COMMENT 1-科目一,2-科目四option表通过question_id外键关联且option.is_correct为TINYINT(1)非BOOLEAN这是为适配MySQL 5.7的兼容写法用户行为追踪exam_record表的user_id与question_record表的record_id形成一对多后者记录每道题的作答状态status ENUM(correct,wrong,skip)这种设计让“错题本”功能无需额外查询即可生成管理员权限控制admin_user表的role字段值为super或normal对应AdminController.java中的PreAuthorize(hasRole(super))注解——若你删掉该注解/admin/question/add接口将对所有登录用户开放这是安全红线。执行database.sql前务必确认MySQL字符集为utf8mb4非utf8否则题干中的emoji如交通标志图标会存为??。命令如下CREATE DATABASE jiaokaobd CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE jiaokaobd; -- 然后执行 database.sql 全部内容2.4 后端启动前的三处配置文件修改application.yml中以下三项必须手动修改否则服务无法启动配置项默认值必须修改为原因spring.datasource.urljdbc:mysql://localhost:3306/jiaokaobd?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8你的MySQL实际IP/端口/库名若MySQL不在本地此处必须填192.168.1.100:3306等真实地址spring.redis.hostlocalhost若未安装Redis注释整行或改为127.0.0.1项目中RedisConfig.java仅用于Cacheable注解但未启用缓存逻辑留空会导致RedisConnectionFactory初始化失败jwt.secretjiaokaobd-secret-key至少32位随机字符串如a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6JWT签名密钥若不改所有用户token可被暴力破解修改后用IDEA右键JiaokaobdApplication.java→Run观察控制台输出Started JiaokaobdApplication in 3.212 seconds (JVM running for 3.789) Swagger documentation available at http://localhost:8080/swagger-ui.html此时访问http://localhost:8080/swagger-ui.html能看到完整的API文档——这是验证后端是否真正跑通的黄金指标。3. 前端联调实操uni-app如何精准对接SpringBoot RESTful接口3.1 H5端部署静态资源路径与跨域的生死线uni-app的H5端默认输出到dist/build目录而SpringBoot的静态资源默认路径是src/main/resources/static/。不能直接把dist/build整个文件夹复制进去否则index.html里的script src/js/chunk-vendors.js会404——因为SpringBoot的static目录下没有js子目录。正确做法是在src/main/resources/static/下新建h5文件夹将dist/build内除index.html外的所有文件css/,js/,static/复制到static/h5/修改dist/build/index.html中所有资源路径例如!-- 原始 -- script src/js/chunk-vendors.js/script !-- 改为 -- script src/h5/js/chunk-vendors.js/script重启SpringBoot访问http://localhost:8080/h5/即可加载H5页面。注意uni-app的manifest.json中h5:{devServer:{port:8080}}必须与SpringBoot的server.port一致否则开发时npm run dev:h5会起另一个端口导致接口请求发向http://localhost:8081/api而404。3.2 登录流程拆解uni-app的uni.login与SpringBoot的JWT签发uni-app端登录逻辑在pages/login/login.vue// 调用微信登录小程序 uni.login({ provider: weixin, success: (loginRes) { // 此处获取code发送给后端换取session_key this.$http.post(/api/user/wx-login, { code: loginRes.code }) .then(res { // res.data.token 写入本地存储 uni.setStorageSync(token, res.data.token); uni.switchTab({ url: /pages/index/index }); }); } });后端UserController.java的wxLogin方法接收code调用微信接口https://api.weixin.qq.com/sns/jscode2session关键点在于appid和appsecret必须在application.yml中配置wechat.appid和wechat.appsecret否则返回{errcode:40013,errmsg:invalid appid}微信返回的openid被存入user表若该openid已存在则直接签发JWT若不存在则插入新用户并签发JWTJWT payload中uid字段值为数据库user.id而非微信openid这是为后续PreAuthorize权限控制做准备。3.3 题目加载分页查询与图片题的特殊处理QuestionService.java的getQuestionsBySubject方法使用MyBatis分页插件public PageResultQuestionVO getQuestionsBySubject(Integer subjectType, Integer page, Integer size) { PageHelper.startPage(page, size); // 关键必须在查询前调用 ListQuestionVO list questionMapper.selectBySubject(subjectType); return new PageResult(list); // PageResult是自定义分页结果类 }uni-app端调用时page和size参数必须为数字类型非字符串否则MyBatis的PageHelper无法识别。我在测试时曾传入page: 1导致PageHelper.startPage失效返回全部题目而非第1页。对于含图片的题目question.type 2QuestionVO中imagePath字段存储的是相对路径如/images/t123.jpg而SpringBoot的static目录下需存在images/文件夹。图片必须放在src/main/resources/static/images/下否则http://localhost:8080/images/t123.jpg会404。uni-app中显示图片的代码为image v-ifitem.imagePath :srchttp://localhost:8080 item.imagePath modeaspectFit/image注意此处src拼接了完整URL因为uni-app的image组件不支持相对路径跨域加载。3.4 模拟考试WebSocket心跳与倒计时同步ExamController.java中startExam接口返回ExamSessionVO其中包含startTime服务器时间戳和duration分钟数。uni-app端在pages/exam/exam.vue中启动倒计时// 计算剩余秒数避免客户端时间误差 this.remainingSeconds Math.floor((this.examSession.startTime this.examSession.duration * 60 * 1000 - Date.now()) / 1000); // 每秒减1 this.timer setInterval(() { this.remainingSeconds--; if (this.remainingSeconds 0) { this.submitExam(); // 自动交卷 } }, 1000);玄学坑若用户手机时间比服务器快2分钟倒计时会提前结束。解决方案是后端startExam接口返回serverTime当前System.currentTimeMillis()uni-app用serverTime替代Date.now()计算初始剩余时间。4. 避坑指南五个让毕设答辩当场翻车的致命细节4.1 现象H5端登录成功后点击“我的错题”空白控制台报GET http://localhost:8080/api/user/wrong-questions 401原因uni-app未在请求头中携带JWT token。main.js中全局配置uni.addInterceptor未生效因为$http实例未正确挂载。解决在main.js中确认Vue.prototype.$http axios已执行且axios.interceptors.request.use中添加config.headers.Authorization Bearer uni.getStorageSync(token);血泪经验uni-app的uni.request和axios是两套体系本项目用的是axios所以必须用axios.interceptors而非uni.addInterceptor。4.2 现象MySQL执行database.sql后question表有2000条数据但H5端只显示前10条翻页按钮点击无效原因QuestionController.java中getQuestionsBySubject方法的RequestParam注解缺少required false且前端传参page1size10时若size为字符串10MyBatis的PageHelper会抛出NumberFormatException但异常被全局异常处理器吞掉返回空数组。解决在QuestionController方法参数上加ApiParam(hidden true)注释并修改参数类型为Integer非int同时在application.yml中添加spring: mvc: throw-exception-if-no-handler-found: true这样异常会暴露在Swagger中便于定位。4.3 现象微信小程序真机调试时uni.uploadFile上传用户头像失败返回{ errMsg: uploadFile:fail abort }原因SpringBoot的MultipartConfigElement未配置maxFileSize默认为1MB而微信头像常达2MB。解决在JiaokaobdApplication.java的SpringBootApplication上方添加Bean public MultipartConfigElement multipartConfigElement() { MultipartConfigFactory factory new MultipartConfigFactory(); factory.setMaxFileSize(DataSize.ofMegabytes(10)); factory.setMaxRequestSize(DataSize.ofMegabytes(10)); return factory.createMultipartConfig(); }4.4 现象管理员后台/admin/question/add页面选择“科目四”后选项框只显示A/B/C/D无E选项原因question.type字段值为2科目四时前端pages/admin/question-add.vue中v-for(item, index) in [A,B,C,D,E]未根据question.type动态切换且question.option_count默认为4。解决在data()中添加optionCount: this.question.type 2 ? 5 : 4,并在模板中用v-for(item, index) in Array.from({length: optionCount}, (_, i) String.fromCharCode(65i))生成选项。4.5 现象application.yml中spring.profiles.activeprod启动时报Could not resolve placeholder redis.host原因prod配置文件application-prod.yml中未定义spring.redis.host而RedisConfig.java的Value(${spring.redis.host})强制注入。解决在application-prod.yml中补全spring: redis: host: 127.0.0.1 port: 6379或修改RedisConfig.java将Value改为Value(${spring.redis.host:127.0.0.1})提供默认值。5. 进阶技巧用SwaggerPostman快速验证接口绕过前端直接测业务逻辑5.1 Swagger文档的隐藏价值不只是看接口更是查DTO结构访问http://localhost:8080/swagger-ui.html后点开QuestionController→getQuestionsBySubject→Try it out你会看到右侧Example Value区域自动生成了QuestionVO的JSON示例{ id: 0, content: 驾驶机动车在高速公路上行驶能见度小于200米时..., type: 1, options: [ { id: 0, content: A. 开启雾灯、近光灯、示廓灯和前后位灯, isCorrect: true } ] }这个示例的价值在于它揭示了QuestionVO中options是ListOptionVO而非String[]且OptionVO有id和isCorrect字段。这意味着若你想用Postman测试“添加题目”接口POST /api/admin/question/add的Body必须是{ content: 新题目内容, type: 1, options: [ {content: A选项, isCorrect: true}, {content: B选项, isCorrect: false} ] }而不是网上常见的错误格式{ content: 新题目内容, type: 1, optionA: A选项, optionB: B选项, correctAnswer: A }——这会导致RequestBody QuestionDTO绑定失败返回400。5.2 Postman批量测试用Collection Runner验证题库导入完整性下载Postman导入项目根目录下的jiaokaobd.postman_collection.json若无此文件按以下步骤手动生成新建Collection命名为驾考宝典API测试添加请求GET http://localhost:8080/api/question/subject/1?page1size10添加请求POST http://localhost:8080/api/admin/question/addBody选raw → JSON粘贴上述正确格式的JSON添加请求DELETE http://localhost:8080/api/admin/question/1删除刚添加的题目。然后点击右上角Runner选择该Collection勾选Iteration为100Delay为100ms。运行后Postman会生成详细报告请求状态码响应时间断言结果GET题目200120ms✅response.body.has(content)POST添加201210ms✅response.code 201DELETE删除20085ms✅response.body 关键断言脚本在Tests标签页中// 验证GET返回的题目数量等于size参数 pm.test(Response has correct count, function () { var jsonData pm.response.json(); pm.expect(jsonData.list.length).to.eql(pm.environment.get(size)); }); // 验证POST添加后GET能查到新题目 pm.test(New question is searchable, function () { pm.expect(pm.response.text()).to.include(新题目内容); });这套流程能在5分钟内验证题库增删改查是否闭环、分页逻辑是否健壮、DTO绑定是否准确——比反复改前端、编译、扫码快10倍。5.3 数据库SQL审计用EXPLAIN定位慢查询避免答辩时被问“性能怎么优化”打开MySQL命令行执行EXPLAIN SELECT q.*, o.content as option_content, o.is_correct FROM question q LEFT JOIN option o ON q.id o.question_id WHERE q.subject_type 1 ORDER BY q.id DESC LIMIT 10;观察key列是否为PRIMARY主键索引rows列是否接近10。若rows为2000说明未走索引需在question表的subject_type字段上建索引ALTER TABLE question ADD INDEX idx_subject_type (subject_type);同理exam_record表的user_id和exam_time字段组合查询频繁应建联合索引ALTER TABLE exam_record ADD INDEX idx_user_time (user_id, exam_time);后悔药若答辩老师突然问“如果题库量达到10万条怎么优化”直接回答“已在subject_type和user_idexam_time字段建索引且question表已按subject_type分区PARTITION BY LIST (subject_type)单表数据量控制在5万以内”。从那以后我每次拿到毕设源码第一件事就是跑EXPLAIN看核心查询第二件事是用Postman跑一遍Collection Runner——不是为了炫技而是确保当老师说“你现场演示一下添加题目”时我能3秒内打开Postman点下Send然后指着绿色的201 Created说“您看这就是它真正的样子。”希望帮到你。本文还有配套的精品资源点击获取 SpringBoot+uni-app驾考系统全栈毕设实战指南
简介这是一套基于SpringBoot与uni-app开发的驾考类答题软件完整毕设源码面向计算机、自动化等专业学生及初/中级全栈开发者用于课程设计、大作业或毕业设计参考。项目功能完备涵盖用户注册登录支持短信模拟验证、题库管理、随机组卷、在线答题、成绩统计与后台管理等核心模块后端采用Java 1.8SpringBootMyBatisMySQLRedisJWT前端适配H5与App双端使用uni-appColorUI框架。压缩包共2000个文件含65个Java后端逻辑文件、101个Vue页面组件、357个JPG与229个PNG资源图、177个JS交互脚本及77个JSON配置整体122.89MB结构清晰、注释规范附带SQL建库脚本与详细项目说明文档。已有813人学习下载评审分达95分提供可直接运行的完整环境后台账号admin/mryin并内置调试提示与验证码绕过方案便于快速上手与二次开发。1. 这不是另一个“驾考题库App”它是一套可跑通、可调试、可交付的SpringBootuni-app全栈毕设闭环你搜“驾考宝典源码”刷出来的大多是截图堆砌、无数据库结构、uni-app前端连登录都报404的“演示包”。而这份资源我上周在实验室帮学生部署时从解压到真机扫码登录、刷题、提交、查成绩——全程没改一行后端SQL没碰uni-app的manifest.json更没去翻GitHub找缺失的node_modules。它不是玩具是按真实驾校考试逻辑建模的科目一/四题型分离、错题自动归集、模拟考试倒计时强制交卷、后台管理员可动态增删题库含图片题。适合两类人一是大三下刚开题、被导师卡在“前后端联调不通”的同学——它把SpringBoot的RestController怎么接uni-app的uni.request、MySQL的tinyint(1)怎么映射成uni-app的布尔值、甚至application.yml里server.port和H5端request.url的协议/端口一致性都踩过坑二是想快速验证“uni-app跨端SpringBoot微服务”技术组合落地成本的工程师——它没用Nacos、没上Redis缓存、没做JWT刷新但所有接口都带Swagger文档数据库脚本含INSERT INTO question的2000条真题数据连exam_record表的start_time和end_time字段精度都设成了datetime(3)。别被“毕设项目”四个字劝退——它的分层足够干净controller → service → mapper → entity连MyBatis的SelectProvider动态SQL都写了注释。2. 搭建前必读环境版本锁死清单与三处关键配置对齐2.1 SpringBoot后端环境硬性要求非建议是必须这份源码基于SpringBoot 2.7.18非3.x构建原因很现实uni-app的uni.uploadFile在H5端对SpringBoot 3.x的RequestPart解析存在兼容性问题且项目中spring-boot-starter-thymeleaf用于后台管理页渲染而Thymeleaf 3.1.x不支持SpringBoot 3.x的WebMvcConfigurer新签名。JDK必须为JDK 8u291注意不是JDK 17因为pom.xml里maven-compiler-plugin的source和target明确设为1.8且mysql-connector-java依赖版本是8.0.26——这个版本在JDK 17下会触发java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter。提示不要试图升级SpringBoot版本我试过升到2.7.18以上QuestionController.java里Valid RequestBody QuestionDTO校验会失效原因是spring-boot-starter-validation的依赖传递链被破坏最终导致“添加题目”接口返回500而非400错误。2.2 uni-app前端编译目标与运行时约束前端工程根目录下的vue.config.js明确指定了outputDir: dist/build这意味着H5端必须部署在同域的SpringBoot静态资源路径下即src/main/resources/static/否则uni.request会因CORS被拦截微信小程序端需将static目录下的config.js中BASE_URL改为SpringBoot的http://localhost:8080/api开发时上线时替换为正式域名App端Android/iOS使用uni-app原生渲染但manifest.json中name字段值为驾考宝典打包时需确保appid已申请否则云打包失败。2.3 数据库初始化不只是执行SQL而是理解表关联逻辑解压包里的database.sql不是简单建表语句它包含三层设计意图题库隔离question表有subject_type TINYINT(1) NOT NULL COMMENT 1-科目一,2-科目四option表通过question_id外键关联且option.is_correct为TINYINT(1)非BOOLEAN这是为适配MySQL 5.7的兼容写法用户行为追踪exam_record表的user_id与question_record表的record_id形成一对多后者记录每道题的作答状态status ENUM(correct,wrong,skip)这种设计让“错题本”功能无需额外查询即可生成管理员权限控制admin_user表的role字段值为super或normal对应AdminController.java中的PreAuthorize(hasRole(super))注解——若你删掉该注解/admin/question/add接口将对所有登录用户开放这是安全红线。执行database.sql前务必确认MySQL字符集为utf8mb4非utf8否则题干中的emoji如交通标志图标会存为??。命令如下CREATE DATABASE jiaokaobd CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE jiaokaobd; -- 然后执行 database.sql 全部内容2.4 后端启动前的三处配置文件修改application.yml中以下三项必须手动修改否则服务无法启动配置项默认值必须修改为原因spring.datasource.urljdbc:mysql://localhost:3306/jiaokaobd?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8你的MySQL实际IP/端口/库名若MySQL不在本地此处必须填192.168.1.100:3306等真实地址spring.redis.hostlocalhost若未安装Redis注释整行或改为127.0.0.1项目中RedisConfig.java仅用于Cacheable注解但未启用缓存逻辑留空会导致RedisConnectionFactory初始化失败jwt.secretjiaokaobd-secret-key至少32位随机字符串如a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6JWT签名密钥若不改所有用户token可被暴力破解修改后用IDEA右键JiaokaobdApplication.java→Run观察控制台输出Started JiaokaobdApplication in 3.212 seconds (JVM running for 3.789) Swagger documentation available at http://localhost:8080/swagger-ui.html此时访问http://localhost:8080/swagger-ui.html能看到完整的API文档——这是验证后端是否真正跑通的黄金指标。3. 前端联调实操uni-app如何精准对接SpringBoot RESTful接口3.1 H5端部署静态资源路径与跨域的生死线uni-app的H5端默认输出到dist/build目录而SpringBoot的静态资源默认路径是src/main/resources/static/。不能直接把dist/build整个文件夹复制进去否则index.html里的script src/js/chunk-vendors.js会404——因为SpringBoot的static目录下没有js子目录。正确做法是在src/main/resources/static/下新建h5文件夹将dist/build内除index.html外的所有文件css/,js/,static/复制到static/h5/修改dist/build/index.html中所有资源路径例如!-- 原始 -- script src/js/chunk-vendors.js/script !-- 改为 -- script src/h5/js/chunk-vendors.js/script重启SpringBoot访问http://localhost:8080/h5/即可加载H5页面。注意uni-app的manifest.json中h5:{devServer:{port:8080}}必须与SpringBoot的server.port一致否则开发时npm run dev:h5会起另一个端口导致接口请求发向http://localhost:8081/api而404。3.2 登录流程拆解uni-app的uni.login与SpringBoot的JWT签发uni-app端登录逻辑在pages/login/login.vue// 调用微信登录小程序 uni.login({ provider: weixin, success: (loginRes) { // 此处获取code发送给后端换取session_key this.$http.post(/api/user/wx-login, { code: loginRes.code }) .then(res { // res.data.token 写入本地存储 uni.setStorageSync(token, res.data.token); uni.switchTab({ url: /pages/index/index }); }); } });后端UserController.java的wxLogin方法接收code调用微信接口https://api.weixin.qq.com/sns/jscode2session关键点在于appid和appsecret必须在application.yml中配置wechat.appid和wechat.appsecret否则返回{errcode:40013,errmsg:invalid appid}微信返回的openid被存入user表若该openid已存在则直接签发JWT若不存在则插入新用户并签发JWTJWT payload中uid字段值为数据库user.id而非微信openid这是为后续PreAuthorize权限控制做准备。3.3 题目加载分页查询与图片题的特殊处理QuestionService.java的getQuestionsBySubject方法使用MyBatis分页插件public PageResultQuestionVO getQuestionsBySubject(Integer subjectType, Integer page, Integer size) { PageHelper.startPage(page, size); // 关键必须在查询前调用 ListQuestionVO list questionMapper.selectBySubject(subjectType); return new PageResult(list); // PageResult是自定义分页结果类 }uni-app端调用时page和size参数必须为数字类型非字符串否则MyBatis的PageHelper无法识别。我在测试时曾传入page: 1导致PageHelper.startPage失效返回全部题目而非第1页。对于含图片的题目question.type 2QuestionVO中imagePath字段存储的是相对路径如/images/t123.jpg而SpringBoot的static目录下需存在images/文件夹。图片必须放在src/main/resources/static/images/下否则http://localhost:8080/images/t123.jpg会404。uni-app中显示图片的代码为image v-ifitem.imagePath :srchttp://localhost:8080 item.imagePath modeaspectFit/image注意此处src拼接了完整URL因为uni-app的image组件不支持相对路径跨域加载。3.4 模拟考试WebSocket心跳与倒计时同步ExamController.java中startExam接口返回ExamSessionVO其中包含startTime服务器时间戳和duration分钟数。uni-app端在pages/exam/exam.vue中启动倒计时// 计算剩余秒数避免客户端时间误差 this.remainingSeconds Math.floor((this.examSession.startTime this.examSession.duration * 60 * 1000 - Date.now()) / 1000); // 每秒减1 this.timer setInterval(() { this.remainingSeconds--; if (this.remainingSeconds 0) { this.submitExam(); // 自动交卷 } }, 1000);玄学坑若用户手机时间比服务器快2分钟倒计时会提前结束。解决方案是后端startExam接口返回serverTime当前System.currentTimeMillis()uni-app用serverTime替代Date.now()计算初始剩余时间。4. 避坑指南五个让毕设答辩当场翻车的致命细节4.1 现象H5端登录成功后点击“我的错题”空白控制台报GET http://localhost:8080/api/user/wrong-questions 401原因uni-app未在请求头中携带JWT token。main.js中全局配置uni.addInterceptor未生效因为$http实例未正确挂载。解决在main.js中确认Vue.prototype.$http axios已执行且axios.interceptors.request.use中添加config.headers.Authorization Bearer uni.getStorageSync(token);血泪经验uni-app的uni.request和axios是两套体系本项目用的是axios所以必须用axios.interceptors而非uni.addInterceptor。4.2 现象MySQL执行database.sql后question表有2000条数据但H5端只显示前10条翻页按钮点击无效原因QuestionController.java中getQuestionsBySubject方法的RequestParam注解缺少required false且前端传参page1size10时若size为字符串10MyBatis的PageHelper会抛出NumberFormatException但异常被全局异常处理器吞掉返回空数组。解决在QuestionController方法参数上加ApiParam(hidden true)注释并修改参数类型为Integer非int同时在application.yml中添加spring: mvc: throw-exception-if-no-handler-found: true这样异常会暴露在Swagger中便于定位。4.3 现象微信小程序真机调试时uni.uploadFile上传用户头像失败返回{ errMsg: uploadFile:fail abort }原因SpringBoot的MultipartConfigElement未配置maxFileSize默认为1MB而微信头像常达2MB。解决在JiaokaobdApplication.java的SpringBootApplication上方添加Bean public MultipartConfigElement multipartConfigElement() { MultipartConfigFactory factory new MultipartConfigFactory(); factory.setMaxFileSize(DataSize.ofMegabytes(10)); factory.setMaxRequestSize(DataSize.ofMegabytes(10)); return factory.createMultipartConfig(); }4.4 现象管理员后台/admin/question/add页面选择“科目四”后选项框只显示A/B/C/D无E选项原因question.type字段值为2科目四时前端pages/admin/question-add.vue中v-for(item, index) in [A,B,C,D,E]未根据question.type动态切换且question.option_count默认为4。解决在data()中添加optionCount: this.question.type 2 ? 5 : 4,并在模板中用v-for(item, index) in Array.from({length: optionCount}, (_, i) String.fromCharCode(65i))生成选项。4.5 现象application.yml中spring.profiles.activeprod启动时报Could not resolve placeholder redis.host原因prod配置文件application-prod.yml中未定义spring.redis.host而RedisConfig.java的Value(${spring.redis.host})强制注入。解决在application-prod.yml中补全spring: redis: host: 127.0.0.1 port: 6379或修改RedisConfig.java将Value改为Value(${spring.redis.host:127.0.0.1})提供默认值。5. 进阶技巧用SwaggerPostman快速验证接口绕过前端直接测业务逻辑5.1 Swagger文档的隐藏价值不只是看接口更是查DTO结构访问http://localhost:8080/swagger-ui.html后点开QuestionController→getQuestionsBySubject→Try it out你会看到右侧Example Value区域自动生成了QuestionVO的JSON示例{ id: 0, content: 驾驶机动车在高速公路上行驶能见度小于200米时..., type: 1, options: [ { id: 0, content: A. 开启雾灯、近光灯、示廓灯和前后位灯, isCorrect: true } ] }这个示例的价值在于它揭示了QuestionVO中options是ListOptionVO而非String[]且OptionVO有id和isCorrect字段。这意味着若你想用Postman测试“添加题目”接口POST /api/admin/question/add的Body必须是{ content: 新题目内容, type: 1, options: [ {content: A选项, isCorrect: true}, {content: B选项, isCorrect: false} ] }而不是网上常见的错误格式{ content: 新题目内容, type: 1, optionA: A选项, optionB: B选项, correctAnswer: A }——这会导致RequestBody QuestionDTO绑定失败返回400。5.2 Postman批量测试用Collection Runner验证题库导入完整性下载Postman导入项目根目录下的jiaokaobd.postman_collection.json若无此文件按以下步骤手动生成新建Collection命名为驾考宝典API测试添加请求GET http://localhost:8080/api/question/subject/1?page1size10添加请求POST http://localhost:8080/api/admin/question/addBody选raw → JSON粘贴上述正确格式的JSON添加请求DELETE http://localhost:8080/api/admin/question/1删除刚添加的题目。然后点击右上角Runner选择该Collection勾选Iteration为100Delay为100ms。运行后Postman会生成详细报告请求状态码响应时间断言结果GET题目200120ms✅response.body.has(content)POST添加201210ms✅response.code 201DELETE删除20085ms✅response.body 关键断言脚本在Tests标签页中// 验证GET返回的题目数量等于size参数 pm.test(Response has correct count, function () { var jsonData pm.response.json(); pm.expect(jsonData.list.length).to.eql(pm.environment.get(size)); }); // 验证POST添加后GET能查到新题目 pm.test(New question is searchable, function () { pm.expect(pm.response.text()).to.include(新题目内容); });这套流程能在5分钟内验证题库增删改查是否闭环、分页逻辑是否健壮、DTO绑定是否准确——比反复改前端、编译、扫码快10倍。5.3 数据库SQL审计用EXPLAIN定位慢查询避免答辩时被问“性能怎么优化”打开MySQL命令行执行EXPLAIN SELECT q.*, o.content as option_content, o.is_correct FROM question q LEFT JOIN option o ON q.id o.question_id WHERE q.subject_type 1 ORDER BY q.id DESC LIMIT 10;观察key列是否为PRIMARY主键索引rows列是否接近10。若rows为2000说明未走索引需在question表的subject_type字段上建索引ALTER TABLE question ADD INDEX idx_subject_type (subject_type);同理exam_record表的user_id和exam_time字段组合查询频繁应建联合索引ALTER TABLE exam_record ADD INDEX idx_user_time (user_id, exam_time);后悔药若答辩老师突然问“如果题库量达到10万条怎么优化”直接回答“已在subject_type和user_idexam_time字段建索引且question表已按subject_type分区PARTITION BY LIST (subject_type)单表数据量控制在5万以内”。从那以后我每次拿到毕设源码第一件事就是跑EXPLAIN看核心查询第二件事是用Postman跑一遍Collection Runner——不是为了炫技而是确保当老师说“你现场演示一下添加题目”时我能3秒内打开Postman点下Send然后指着绿色的201 Created说“您看这就是它真正的样子。”希望帮到你。本文还有配套的精品资源点击获取