简介这份资源是面向高校计算机相关专业学生与Java初学者的一套微信小程序毕业设计完整项目主题为健身管理系统及会员服务适合用作毕业设计、课程设计或小程序全栈练手参考。项目采用微信小程序开发工具搭配Java后端、MySQL数据库与B/S架构实现了用户管理、健身类型管理、健身教练管理、健身课程管理、课程预约管理及系统管理等模块用户可通过小程序完成个人信息维护、浏览教练与课程、在线预约及收藏等操作。压缩包共1351个文件约29.36MB包含285个png与40个jpg图片素材、198个js与124个vue前端脚本、111个wxml与114个wxss小程序页面样式、103个java后端源码以及2个sql数据库脚本和2个mp4演示视频另附说明文档与项目配置相关文件。目前已有122人学习下载读者可据此获得一套结构完整、前后端齐全的赛题级方案便于快速理解业务逻辑、复用代码并完成二次开发。1. 从一份 .rar 说起这套健身管理小程序到底能跑通什么如果你正在为计算机毕业设计选题发愁或者需要一个能直接跑起来、带数据库和演示视频的微信小程序项目这份「健身管理系统及会员」的压缩包值得先看一眼。它不是那种只有几个静态页面的壳子而是把用户管理、健身类型、教练、课程、预约、收藏、系统管理这一整条业务链都串了起来。技术栈是微信小程序开发工具做前端Java 做后端MySQL 存数据B/S 架构典型的课程设计和毕业设计组合。我拿到包之后第一件事不是急着导入而是先看目录结构。里面除了常规的源码文件夹还混着一批.bak备份文件比如main.css.bak、update-password.vue.bak、IndexAsideStatic.vue.bak、BreadCrumbs.vue.bak、IndexHeader.vue.bak以及1-install.bat、2-run.bat两个批处理脚本还有 Eclipse 工程特有的.classpath、org.eclipse.wst.common.component、org.eclipse.wst.jsdt.ui.superType.container。这些文件说明项目原本是在 Eclipse 或类似的 Java IDE 里开发的前端部分用了 Vue 的写法但最终跑在微信小程序环境里。适合谁用三类人一是需要快速搭出毕业设计原型、不想从零写登录注册和增删改查的二是想研究小程序端如何与 Java 后端做数据交互的三是需要一份带数据库脚本和说明文档的完整参考。不适合谁想直接拿来做商业级高并发健身 SaaS 的这套代码的架构和权限设计撑不住后面会讲边界。2. 拆包先看骨架目录结构、技术栈与运行前置条件2.1 从文件后缀反推项目真实结构压缩包解压后第一层通常能看到源码目录、数据库文件、说明文档和演示视频。但真正决定你能不能跑起来的是那几个容易被忽略的工程配置文件。.classpath和org.eclipse.wst.common.component是 Eclipse 的 Web 工程描述文件它们决定了 Java 源码编译后输出到哪个目录、依赖哪些库。如果你用 IntelliJ IDEA 直接打开这些文件不会被识别需要手动转成 Maven 或 Gradle 结构或者干脆继续用 Eclipse 导入。1-install.bat和2-run.bat是 Windows 下的快捷脚本。常见做法是1-install.bat里执行mvn install或npm install2-run.bat里启动后端服务或小程序构建。但很多毕业设计包的 bat 文件写的是硬编码路径比如D:\java\jdk1.8\bin\java你机器上没有这个路径就会一闪而过。我一般会先用文本编辑器打开这两个 bat把里面的 JDK 路径、项目路径改成自己机器上的实际路径再执行。前端部分出现了.vue.bak文件说明原始项目可能用 Vue 写过管理后台或者小程序端用了 uni-app 之类的跨端框架。但摘要里明确写的是「微信小程序开发工具」所以最终运行入口应该还是微信开发者工具导入小程序源码目录。这里有个坑如果小程序源码目录里混了 Vue 的.vue文件微信开发者工具是不认的需要确认真正的小程序页面文件是.wxml、.wxss、.js、.json四件套。2.2 运行前置条件清单在动手之前先把环境对齐。下面这张表是我根据这类 Java 小程序毕业设计包的通用情况整理的具体版本号以包内说明文档为准如果说明文档没写按这个范围配基本不会翻车。组件常见要求检查方式JDK1.8 或 11java -versionMySQL5.7 或 8.0mysql --versionMaven3.6mvn -v微信开发者工具稳定版能登录并创建项目IDEEclipse 或 IDEA能导入 Java Web 工程浏览器Chrome调试管理后台数据库连接池这块Java 后端常见的是 Druid 或 C3P0。如果你在application.yml或db.properties里看到initialSize、maxActive、validationQuery这些参数那就是连接池配置。validationQuery一般写SELECT 1用来检测连接是否有效。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver写错了会报ClassNotFoundException这是血泪经验里排第一位的翻车点。提示先别急着改代码把 JDK、MySQL、Maven 三个版本确认一遍再去看 bat 文件里的路径。环境不对后面所有步骤都是白费。3. 数据库先落地建库、导表与连接配置的实操顺序3.1 建库导表的完整命令与参数说明拿到.sql文件后不要直接双击用图形化工具导入先看一眼文件头有没有CREATE DATABASE和USE语句。很多毕业设计的 sql 文件只包含CREATE TABLE需要你手动建库。我一般会先建一个字符集为utf8mb4的库避免中文乱码。# 登录 MySQL输入密码后进入命令行 mysql -u root -p # 创建数据库字符集用 utf8mb4排序规则用通用型 CREATE DATABASE fitness_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该数据库 USE fitness_db; # 导入表结构和数据注意路径用正斜杠或双反斜杠 source D:/graduation/fitness_db.sql;utf8mb4比utf8多支持 emoji 和部分生僻字健身课程名称里如果出现特殊符号不会报错。source命令后面的路径不要用单反斜杠Windows 下要么用D:/graduation/fitness_db.sql要么用D:\\graduation\\fitness_db.sql否则 MySQL 会把\g当成转义字符。导入完成后用SHOW TABLES;确认表数量。这类系统通常有user、coach、course、appointment、favorite、admin等表。如果表数量明显少于功能模块数说明 sql 文件不完整需要找包内其他 sql 文件或说明文档。3.2 后端数据库连接配置怎么改Java 后端的数据库配置一般在src/main/resources下的application.yml、application.properties或db.properties里。以application.yml为例常见结构如下spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/fitness_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_passwordserverTimezoneAsia/Shanghai必须加否则 MySQL 8.0 会报时区错误。useSSLfalse在本地开发时加上避免证书警告。characterEncodingutf8配合数据库的utf8mb4使用能覆盖绝大多数中文场景。如果你用的是 MySQL 5.7驱动类名改成com.mysql.jdbc.Driver并且不需要serverTimezone参数。改完配置后不要急着启动整个项目。先写一个最简单的 JDBC 测试类或者用 Maven 的test命令跑一下单元测试确认能拿到数据库连接。这一步能帮你把「数据库连不上」和「业务代码报错」两类问题分开省去后面大量排查时间。注意如果包内提供了db.properties而不是application.yml参数名可能是jdbc.driver、jdbc.url、jdbc.username、jdbc.password含义一样只是写法不同。4. 后端跑起来Java 工程导入、依赖修复与接口自测4.1 Eclipse 工程导入与常见编译错误处理如果包内是 Eclipse 工程用 Eclipse 的Import - Existing Projects into Workspace导入。导入后先看Problems视图常见错误有三类一是 JDK 版本不匹配项目右键Properties - Java Build Path - Libraries把 JRE 改成你本地的 1.8 或 11二是 Maven 依赖没下载右键项目Maven - Update Project勾选Force Update三是.classpath里引用了不存在的 jar 包需要手动删掉或替换。如果导入后src目录上有个红叉但代码本身没报错多半是Java Build Path里的Source选项卡路径不对。常见做法是删掉原来的 source folder重新添加src/main/java。这一步做完红叉一般会消失。对于用 IDEA 的读者直接Open项目根目录IDEA 会自动识别 Maven 结构。如果识别不了就手动Add Maven Project选中pom.xml。IDEA 对 Eclipse 的.classpath支持不好所以更推荐用 Maven 方式导入。4.2 启动后端与接口自测后端启动类通常叫Application.java或XxxApplication.java带SpringBootApplication注解。右键Run As - Java Application或Spring Boot App。启动日志里看到Started XxxApplication in x.xxx seconds就算成功。如果卡在Initializing Spring root WebApplicationContext然后报错九成是数据库连接问题回到第 3 章检查配置。启动成功后先别急着开小程序。用 Postman 或浏览器直接访问几个关键接口确认后端能返回数据。常见接口路径可以从 Controller 类的RequestMapping注解里找。比如用户列表接口可能是http://localhost:8080/user/list课程列表可能是http://localhost:8080/course/list。# 用 curl 测试用户列表接口-i 显示响应头-s 静默模式 curl -i -s http://localhost:8080/user/list # 如果返回 401 或 403说明接口需要登录态先调登录接口拿 token curl -X POST http://localhost:8080/login -H Content-Type: application/json -d {\username\:\admin\,\password\:\123456\}登录接口返回的 token 一般放在响应体的data.token或token字段里。拿到 token 后后续请求在 Header 里加Authorization: Bearer token或token: token具体看后端拦截器的实现。这一步做完后端就算真正跑通了小程序端连不上时也能快速判断是前端问题还是后端问题。5. 小程序端联调请求封装、页面跳转与数据渲染排查5.1 小程序请求域名与本地调试设置微信开发者工具导入小程序源码目录后第一件事是看app.js或config.js里的baseUrl指向哪里。常见写法是http://localhost:8080或http://127.0.0.1:8080。但微信开发者工具默认要求 HTTPS 域名本地调试需要勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。具体位置在开发者工具右上角详情 - 本地设置 - 不校验合法域名...。勾上之后http://localhost的请求才能发出去。如果没勾控制台会报request:fail url not in domain list这是新手最容易卡住的地方。另外小程序端请求封装通常在utils/request.js或api/index.js里。常见做法是用wx.request包一层 Promise统一处理 token 和错误码。如果你看到header里带了token但后端返回 401先检查 token 是不是过期了或者后端拦截器读取的 header key 和小程序端设置的不一致。5.2 页面跳转与数据渲染的排查顺序小程序页面跳转分wx.navigateTo、wx.redirectTo、wx.switchTab三种。navigateTo保留当前页redirectTo关闭当前页switchTab只能跳 tabBar 页面。如果点击按钮没反应先看app.json里pages数组有没有注册目标页面路径没注册的页面跳转会静默失败。数据渲染问题一般出在setData上。小程序不像 Vue 那样自动响应必须显式调用this.setData({ key: value })。如果列表渲染不出来在onLoad或onShow里打印接口返回的数据确认res.data的结构和wxml里wx:for的字段名对得上。常见错误是接口返回{ code: 200, data: { list: [...] } }但wx:for写的是{{list}}而不是{{data.list}}。// 在页面的 onLoad 里请求课程列表 onLoad: function () { const that this; wx.request({ url: that.data.baseUrl /course/list, method: GET, header: { token: wx.getStorageSync(token) }, success: function (res) { // 打印完整响应确认数据结构 console.log(课程列表响应:, res.data); // 根据实际结构取 list 字段 that.setData({ courseList: res.data.data.list }); }, fail: function (err) { console.error(请求失败:, err); } }); }console.log打印完整响应是排查数据渲染问题的第一步。很多教程只写res.data但实际后端可能包了一层data不看日志根本猜不到。wx.getStorageSync(token)从本地缓存取登录态如果取不到说明登录页面没存进去或者存的时候 key 写错了。6. 避坑与排查这套包最容易翻车的五个地方6.1 数据库导入报错Unknown character set: utf8mb4现象执行 sql 文件时提示未知字符集。原因MySQL 版本低于 5.5.3不支持utf8mb4。解决升级 MySQL 到 5.7 或 8.0或者把 sql 文件里的utf8mb4全部替换成utf8但中文生僻字可能丢失。6.2 后端启动报Access denied for user rootlocalhost现象Spring Boot 启动时数据库连接被拒绝。原因application.yml里的密码和本地 MySQL 密码不一致或者 MySQL 8.0 的caching_sha2_password认证插件导致旧驱动连不上。解决确认密码正确如果驱动是 5.x 版本在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;后刷新权限。6.3 小程序请求返回request:fail url not in domain list现象小程序端所有接口请求失败控制台报域名不合法。原因微信开发者工具默认校验 HTTPS 域名本地http://localhost不在白名单。解决详情 - 本地设置 - 勾选「不校验合法域名、web-view、TLS 版本以及 HTTPS 证书」。如果真机调试需要在微信公众平台配置服务器域名或者用内网穿透工具把本地服务映射到一个 HTTPS 域名。6.4 页面白屏但控制台无报错现象点击进入某个页面页面空白控制台没有红色错误。原因app.json里pages数组没有注册该页面路径或者页面.json文件里usingComponents引用了不存在的组件。解决检查app.json的pages列表确认目标页面路径已注册检查页面.json里的组件引用路径是否正确。6.5 演示视频能播但源码跑不起来现象包内演示视频里功能正常自己导入后各种报错。原因演示视频可能是用另一套环境录制的包内源码和视频不是同一版本或者视频里的数据库数据比 sql 文件里的多。解决以源码和 sql 文件为准视频只作功能参考。如果源码缺失关键文件优先看.bak文件是不是原始文件的备份把.bak去掉后缀试试。7. 进阶用法把课程预约做成可验证的闭环这套系统里最值得深挖的是课程预约模块因为它涉及用户、课程、教练、时间四个维度的数据一致性。我一般会先在后端把预约接口的校验逻辑理清楚再回到小程序端做联调。下面是一个预约接口的伪代码逻辑你可以对照包内实际代码看它有没有做这些校验。// 预约课程的核心校验逻辑 public Result appointCourse(Integer userId, Integer courseId) { // 1. 查课程是否存在且未满员 Course course courseMapper.selectById(courseId); if (course null) { return Result.error(课程不存在); } if (course.getCurrentNum() course.getMaxNum()) { return Result.error(课程已满); } // 2. 查用户是否已预约过该课程 Appointment exist appointmentMapper.selectByUserAndCourse(userId, courseId); if (exist ! null) { return Result.error(请勿重复预约); } // 3. 插入预约记录同时更新课程当前人数 Appointment appointment new Appointment(); appointment.setUserId(userId); appointment.setCourseId(courseId); appointment.setStatus(1); // 1 表示已预约 appointmentMapper.insert(appointment); course.setCurrentNum(course.getCurrentNum() 1); courseMapper.updateById(course); return Result.success(预约成功); }这段逻辑里currentNum和maxNum的比较是防止超卖的关键。如果包内代码没有做这个校验你可以自己补上。selectByUserAndCourse是防重复预约的查询如果没做用户连点两次按钮就会生成两条记录。status字段用 1 表示已预约、2 表示已取消方便后续做取消预约功能。验证方法用两个不同的用户账号同时预约同一门只剩一个名额的课程。如果两个都成功说明没有做并发控制如果只有一个成功说明校验生效。更严谨的做法是在数据库层给user_id course_id加唯一索引从根上防止重复数据。从那以后我每次拿到这类毕业设计包都会先跑一遍「注册 - 登录 - 预约 - 取消预约」的完整闭环确认核心业务链路是通的再去看其他管理功能。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源是面向高校计算机相关专业学生与Java初学者的一套微信小程序毕业设计完整项目主题为健身管理系统及会员服务适合用作毕业设计、课程设计或小程序全栈练手参考。项目采用微信小程序开发工具搭配Java后端、MySQL数据库与B/S架构实现了用户管理、健身类型管理、健身教练管理、健身课程管理、课程预约管理及系统管理等模块用户可通过小程序完成个人信息维护、浏览教练与课程、在线预约及收藏等操作。压缩包共1351个文件约29.36MB包含285个png与40个jpg图片素材、198个js与124个vue前端脚本、111个wxml与114个wxss小程序页面样式、103个java后端源码以及2个sql数据库脚本和2个mp4演示视频另附说明文档与项目配置相关文件。目前已有122人学习下载读者可据此获得一套结构完整、前后端齐全的赛题级方案便于快速理解业务逻辑、复用代码并完成二次开发。1. 从一份 .rar 说起这套健身管理小程序到底能跑通什么如果你正在为计算机毕业设计选题发愁或者需要一个能直接跑起来、带数据库和演示视频的微信小程序项目这份「健身管理系统及会员」的压缩包值得先看一眼。它不是那种只有几个静态页面的壳子而是把用户管理、健身类型、教练、课程、预约、收藏、系统管理这一整条业务链都串了起来。技术栈是微信小程序开发工具做前端Java 做后端MySQL 存数据B/S 架构典型的课程设计和毕业设计组合。我拿到包之后第一件事不是急着导入而是先看目录结构。里面除了常规的源码文件夹还混着一批.bak备份文件比如main.css.bak、update-password.vue.bak、IndexAsideStatic.vue.bak、BreadCrumbs.vue.bak、IndexHeader.vue.bak以及1-install.bat、2-run.bat两个批处理脚本还有 Eclipse 工程特有的.classpath、org.eclipse.wst.common.component、org.eclipse.wst.jsdt.ui.superType.container。这些文件说明项目原本是在 Eclipse 或类似的 Java IDE 里开发的前端部分用了 Vue 的写法但最终跑在微信小程序环境里。适合谁用三类人一是需要快速搭出毕业设计原型、不想从零写登录注册和增删改查的二是想研究小程序端如何与 Java 后端做数据交互的三是需要一份带数据库脚本和说明文档的完整参考。不适合谁想直接拿来做商业级高并发健身 SaaS 的这套代码的架构和权限设计撑不住后面会讲边界。2. 拆包先看骨架目录结构、技术栈与运行前置条件2.1 从文件后缀反推项目真实结构压缩包解压后第一层通常能看到源码目录、数据库文件、说明文档和演示视频。但真正决定你能不能跑起来的是那几个容易被忽略的工程配置文件。.classpath和org.eclipse.wst.common.component是 Eclipse 的 Web 工程描述文件它们决定了 Java 源码编译后输出到哪个目录、依赖哪些库。如果你用 IntelliJ IDEA 直接打开这些文件不会被识别需要手动转成 Maven 或 Gradle 结构或者干脆继续用 Eclipse 导入。1-install.bat和2-run.bat是 Windows 下的快捷脚本。常见做法是1-install.bat里执行mvn install或npm install2-run.bat里启动后端服务或小程序构建。但很多毕业设计包的 bat 文件写的是硬编码路径比如D:\java\jdk1.8\bin\java你机器上没有这个路径就会一闪而过。我一般会先用文本编辑器打开这两个 bat把里面的 JDK 路径、项目路径改成自己机器上的实际路径再执行。前端部分出现了.vue.bak文件说明原始项目可能用 Vue 写过管理后台或者小程序端用了 uni-app 之类的跨端框架。但摘要里明确写的是「微信小程序开发工具」所以最终运行入口应该还是微信开发者工具导入小程序源码目录。这里有个坑如果小程序源码目录里混了 Vue 的.vue文件微信开发者工具是不认的需要确认真正的小程序页面文件是.wxml、.wxss、.js、.json四件套。2.2 运行前置条件清单在动手之前先把环境对齐。下面这张表是我根据这类 Java 小程序毕业设计包的通用情况整理的具体版本号以包内说明文档为准如果说明文档没写按这个范围配基本不会翻车。组件常见要求检查方式JDK1.8 或 11java -versionMySQL5.7 或 8.0mysql --versionMaven3.6mvn -v微信开发者工具稳定版能登录并创建项目IDEEclipse 或 IDEA能导入 Java Web 工程浏览器Chrome调试管理后台数据库连接池这块Java 后端常见的是 Druid 或 C3P0。如果你在application.yml或db.properties里看到initialSize、maxActive、validationQuery这些参数那就是连接池配置。validationQuery一般写SELECT 1用来检测连接是否有效。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver写错了会报ClassNotFoundException这是血泪经验里排第一位的翻车点。提示先别急着改代码把 JDK、MySQL、Maven 三个版本确认一遍再去看 bat 文件里的路径。环境不对后面所有步骤都是白费。3. 数据库先落地建库、导表与连接配置的实操顺序3.1 建库导表的完整命令与参数说明拿到.sql文件后不要直接双击用图形化工具导入先看一眼文件头有没有CREATE DATABASE和USE语句。很多毕业设计的 sql 文件只包含CREATE TABLE需要你手动建库。我一般会先建一个字符集为utf8mb4的库避免中文乱码。# 登录 MySQL输入密码后进入命令行 mysql -u root -p # 创建数据库字符集用 utf8mb4排序规则用通用型 CREATE DATABASE fitness_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 切换到该数据库 USE fitness_db; # 导入表结构和数据注意路径用正斜杠或双反斜杠 source D:/graduation/fitness_db.sql;utf8mb4比utf8多支持 emoji 和部分生僻字健身课程名称里如果出现特殊符号不会报错。source命令后面的路径不要用单反斜杠Windows 下要么用D:/graduation/fitness_db.sql要么用D:\\graduation\\fitness_db.sql否则 MySQL 会把\g当成转义字符。导入完成后用SHOW TABLES;确认表数量。这类系统通常有user、coach、course、appointment、favorite、admin等表。如果表数量明显少于功能模块数说明 sql 文件不完整需要找包内其他 sql 文件或说明文档。3.2 后端数据库连接配置怎么改Java 后端的数据库配置一般在src/main/resources下的application.yml、application.properties或db.properties里。以application.yml为例常见结构如下spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/fitness_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_passwordserverTimezoneAsia/Shanghai必须加否则 MySQL 8.0 会报时区错误。useSSLfalse在本地开发时加上避免证书警告。characterEncodingutf8配合数据库的utf8mb4使用能覆盖绝大多数中文场景。如果你用的是 MySQL 5.7驱动类名改成com.mysql.jdbc.Driver并且不需要serverTimezone参数。改完配置后不要急着启动整个项目。先写一个最简单的 JDBC 测试类或者用 Maven 的test命令跑一下单元测试确认能拿到数据库连接。这一步能帮你把「数据库连不上」和「业务代码报错」两类问题分开省去后面大量排查时间。注意如果包内提供了db.properties而不是application.yml参数名可能是jdbc.driver、jdbc.url、jdbc.username、jdbc.password含义一样只是写法不同。4. 后端跑起来Java 工程导入、依赖修复与接口自测4.1 Eclipse 工程导入与常见编译错误处理如果包内是 Eclipse 工程用 Eclipse 的Import - Existing Projects into Workspace导入。导入后先看Problems视图常见错误有三类一是 JDK 版本不匹配项目右键Properties - Java Build Path - Libraries把 JRE 改成你本地的 1.8 或 11二是 Maven 依赖没下载右键项目Maven - Update Project勾选Force Update三是.classpath里引用了不存在的 jar 包需要手动删掉或替换。如果导入后src目录上有个红叉但代码本身没报错多半是Java Build Path里的Source选项卡路径不对。常见做法是删掉原来的 source folder重新添加src/main/java。这一步做完红叉一般会消失。对于用 IDEA 的读者直接Open项目根目录IDEA 会自动识别 Maven 结构。如果识别不了就手动Add Maven Project选中pom.xml。IDEA 对 Eclipse 的.classpath支持不好所以更推荐用 Maven 方式导入。4.2 启动后端与接口自测后端启动类通常叫Application.java或XxxApplication.java带SpringBootApplication注解。右键Run As - Java Application或Spring Boot App。启动日志里看到Started XxxApplication in x.xxx seconds就算成功。如果卡在Initializing Spring root WebApplicationContext然后报错九成是数据库连接问题回到第 3 章检查配置。启动成功后先别急着开小程序。用 Postman 或浏览器直接访问几个关键接口确认后端能返回数据。常见接口路径可以从 Controller 类的RequestMapping注解里找。比如用户列表接口可能是http://localhost:8080/user/list课程列表可能是http://localhost:8080/course/list。# 用 curl 测试用户列表接口-i 显示响应头-s 静默模式 curl -i -s http://localhost:8080/user/list # 如果返回 401 或 403说明接口需要登录态先调登录接口拿 token curl -X POST http://localhost:8080/login -H Content-Type: application/json -d {\username\:\admin\,\password\:\123456\}登录接口返回的 token 一般放在响应体的data.token或token字段里。拿到 token 后后续请求在 Header 里加Authorization: Bearer token或token: token具体看后端拦截器的实现。这一步做完后端就算真正跑通了小程序端连不上时也能快速判断是前端问题还是后端问题。5. 小程序端联调请求封装、页面跳转与数据渲染排查5.1 小程序请求域名与本地调试设置微信开发者工具导入小程序源码目录后第一件事是看app.js或config.js里的baseUrl指向哪里。常见写法是http://localhost:8080或http://127.0.0.1:8080。但微信开发者工具默认要求 HTTPS 域名本地调试需要勾选「不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书」。具体位置在开发者工具右上角详情 - 本地设置 - 不校验合法域名...。勾上之后http://localhost的请求才能发出去。如果没勾控制台会报request:fail url not in domain list这是新手最容易卡住的地方。另外小程序端请求封装通常在utils/request.js或api/index.js里。常见做法是用wx.request包一层 Promise统一处理 token 和错误码。如果你看到header里带了token但后端返回 401先检查 token 是不是过期了或者后端拦截器读取的 header key 和小程序端设置的不一致。5.2 页面跳转与数据渲染的排查顺序小程序页面跳转分wx.navigateTo、wx.redirectTo、wx.switchTab三种。navigateTo保留当前页redirectTo关闭当前页switchTab只能跳 tabBar 页面。如果点击按钮没反应先看app.json里pages数组有没有注册目标页面路径没注册的页面跳转会静默失败。数据渲染问题一般出在setData上。小程序不像 Vue 那样自动响应必须显式调用this.setData({ key: value })。如果列表渲染不出来在onLoad或onShow里打印接口返回的数据确认res.data的结构和wxml里wx:for的字段名对得上。常见错误是接口返回{ code: 200, data: { list: [...] } }但wx:for写的是{{list}}而不是{{data.list}}。// 在页面的 onLoad 里请求课程列表 onLoad: function () { const that this; wx.request({ url: that.data.baseUrl /course/list, method: GET, header: { token: wx.getStorageSync(token) }, success: function (res) { // 打印完整响应确认数据结构 console.log(课程列表响应:, res.data); // 根据实际结构取 list 字段 that.setData({ courseList: res.data.data.list }); }, fail: function (err) { console.error(请求失败:, err); } }); }console.log打印完整响应是排查数据渲染问题的第一步。很多教程只写res.data但实际后端可能包了一层data不看日志根本猜不到。wx.getStorageSync(token)从本地缓存取登录态如果取不到说明登录页面没存进去或者存的时候 key 写错了。6. 避坑与排查这套包最容易翻车的五个地方6.1 数据库导入报错Unknown character set: utf8mb4现象执行 sql 文件时提示未知字符集。原因MySQL 版本低于 5.5.3不支持utf8mb4。解决升级 MySQL 到 5.7 或 8.0或者把 sql 文件里的utf8mb4全部替换成utf8但中文生僻字可能丢失。6.2 后端启动报Access denied for user rootlocalhost现象Spring Boot 启动时数据库连接被拒绝。原因application.yml里的密码和本地 MySQL 密码不一致或者 MySQL 8.0 的caching_sha2_password认证插件导致旧驱动连不上。解决确认密码正确如果驱动是 5.x 版本在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 新密码;后刷新权限。6.3 小程序请求返回request:fail url not in domain list现象小程序端所有接口请求失败控制台报域名不合法。原因微信开发者工具默认校验 HTTPS 域名本地http://localhost不在白名单。解决详情 - 本地设置 - 勾选「不校验合法域名、web-view、TLS 版本以及 HTTPS 证书」。如果真机调试需要在微信公众平台配置服务器域名或者用内网穿透工具把本地服务映射到一个 HTTPS 域名。6.4 页面白屏但控制台无报错现象点击进入某个页面页面空白控制台没有红色错误。原因app.json里pages数组没有注册该页面路径或者页面.json文件里usingComponents引用了不存在的组件。解决检查app.json的pages列表确认目标页面路径已注册检查页面.json里的组件引用路径是否正确。6.5 演示视频能播但源码跑不起来现象包内演示视频里功能正常自己导入后各种报错。原因演示视频可能是用另一套环境录制的包内源码和视频不是同一版本或者视频里的数据库数据比 sql 文件里的多。解决以源码和 sql 文件为准视频只作功能参考。如果源码缺失关键文件优先看.bak文件是不是原始文件的备份把.bak去掉后缀试试。7. 进阶用法把课程预约做成可验证的闭环这套系统里最值得深挖的是课程预约模块因为它涉及用户、课程、教练、时间四个维度的数据一致性。我一般会先在后端把预约接口的校验逻辑理清楚再回到小程序端做联调。下面是一个预约接口的伪代码逻辑你可以对照包内实际代码看它有没有做这些校验。// 预约课程的核心校验逻辑 public Result appointCourse(Integer userId, Integer courseId) { // 1. 查课程是否存在且未满员 Course course courseMapper.selectById(courseId); if (course null) { return Result.error(课程不存在); } if (course.getCurrentNum() course.getMaxNum()) { return Result.error(课程已满); } // 2. 查用户是否已预约过该课程 Appointment exist appointmentMapper.selectByUserAndCourse(userId, courseId); if (exist ! null) { return Result.error(请勿重复预约); } // 3. 插入预约记录同时更新课程当前人数 Appointment appointment new Appointment(); appointment.setUserId(userId); appointment.setCourseId(courseId); appointment.setStatus(1); // 1 表示已预约 appointmentMapper.insert(appointment); course.setCurrentNum(course.getCurrentNum() 1); courseMapper.updateById(course); return Result.success(预约成功); }这段逻辑里currentNum和maxNum的比较是防止超卖的关键。如果包内代码没有做这个校验你可以自己补上。selectByUserAndCourse是防重复预约的查询如果没做用户连点两次按钮就会生成两条记录。status字段用 1 表示已预约、2 表示已取消方便后续做取消预约功能。验证方法用两个不同的用户账号同时预约同一门只剩一个名额的课程。如果两个都成功说明没有做并发控制如果只有一个成功说明校验生效。更严谨的做法是在数据库层给user_id course_id加唯一索引从根上防止重复数据。从那以后我每次拿到这类毕业设计包都会先跑一遍「注册 - 登录 - 预约 - 取消预约」的完整闭环确认核心业务链路是通的再去看其他管理功能。希望帮到你。本文还有配套的精品资源点击获取
