SSM与微信小程序健身预约系统：从源码跑通到答辩避坑全指南

简介：基于SSM与微信小程序的健身管理毕业设计项目，面向计算机专业毕业生及需要完整项目范例的开发者，覆盖健身课程、教练预约、订单管理等典型业务，可直接用于毕业设计或课程设计参考。压缩包共970个文件，包含142个Java后端类、113个Vue页面、129个JS脚本、34个WXML与35个WXSS小程序页面，以及2个SQL数据库脚本、PPT答辩稿、开题报告、使用文档、演示视频等，整体约58.76MB，目录按前后端、数据库、文档划分清晰，便于快速定位。目前已有153人学习/下载。项目为导师认可的高分优秀毕设，答辩评审97分，在Windows10/11环境严格调试通过，附带部署教程，下载即可运行；演示视频辅助理解功能串联，PPT与开题报告可直接复用，代码结构规范，是学习SSM+小程序全栈开发的扎实样例。

1. 拿到“SSM+微信小程序健身毕设”压缩包之后，先别急着解压

一个标着“高分优秀项目”的压缩包，真正值钱的是“能跑通、能讲清、能通过答辩”这三件事。标题里的 SSM 指 Spring、SpringMVC、MyBatis 三件套，微信小程序负责前端，数据库脚本帮你把表结构一次建好，PPT、开题报告、使用文档、演示视频是配套材料。它适合两类人：没定题、想拿现成方向起步的毕业生；已经下载源码却不知道怎么跑、答辩不知道怎么讲的同学。能帮你把一周时间花在刀刃上。但先泼盆冷水：源码不等于能跑，能跑不等于能答，能答不等于能过。这篇就按“跑通、改业务、避坑、答辩验证”的顺序拆给你。

2. 先把技术栈立住：SSM 与微信小程序的分工和选型理由

SSM 和微信小程序不是两个孤立的东西，它们是同一个业务的前后两端。后端给小程序提供 JSON 接口，小程序负责页面和交互。这一章先把“为什么这么搭、数据表怎么设计”讲清楚，因为这些问题答不上来，后面代码读得再多也只是照抄，答辩一问就穿帮。

2.1 为什么是 SSM 而不是 Spring Boot：毕设选题的“稳妥”逻辑

SSM 是 Spring、SpringMVC、MyBatis 的整合写法。Spring 管对象依赖，SpringMVC 管请求分发，MyBatis 管 Java 方法和 SQL 的映射。它有三份显式配置文件：web.xml 负责应用启动和全局监听器，spring-mvc.xml 负责 Controller 和请求路由，spring-mybatis.xml 负责数据源与 Mapper 扫描。对毕业设计来说，这种显式配置反而是优点——老师每问一层，你都能打开对应文件给他看，而不是干讲概念。

生产环境里 Spring Boot 确实更主流，java 面试题里高频出现的也多半是 Spring Boot 那一套。但毕设场景不完全一样：题目指定 SSM，评分表一般按“分层使用”来打分，SSM 把 Controller、Service、Mapper 三层摆得明明白白，比 Spring Boot 的自动配置更容易支撑你讲满整个答辩。我自己看过的毕设里，用 Spring Boot 的同学反而说不清请求进来以后发生了什么，因为太多东西被“约定优于配置”藏起来了。

版本搭配建议写在前面：JDK 8 配 Spring 4.x 或 5.x，Maven 3.6.x，Tomcat 8.5 或 9，MySQL 5.7。不要用 JDK 17 跑老工程，Spring 的 CGLIB 字节码增强在高版本 JDK 下经常会抛异常；也不要装 MySQL 8 还沿用旧的驱动类名，启动时直接报找不到驱动。这套组合不见得最新，但它是经过大量毕设验证、踩坑案例最多、网上答案最齐全的一套。

2.2 微信小程序端为什么适合做健身业务：课程、打卡、预约三类场景

健身业务最核心的词是“预约”：团操课有固定课表，私教要提前约教练，场地要卡时间段。这类操作天然适合放在微信小程序里，用户不用下载 App，扫码就能进，课程列表、预约确认、我的预约三个页面就把主流程覆盖了。对毕设来说，小程序原生开发的工程量适中，不需要像 App 那样适配 Android 和 iOS 两套，微信开发者工具里写 WXML 和 JavaScript 就行。

这里有个常见选型问题：用原生小程序还是 uniapp？如果标题明确写的是“微信小程序”，就按原生开发走。uniapp 打包微信小程序确实能跨端，但它多一层编译转换，真机调试时样式错位、组件不兼容的问题排查起来很费时间，对毕设这种“快速跑通优先”的场景不划算。课程列表、预约确认这类页面用原生组件已经绰绰有余，没必要引入额外工具链。

功能范围建议收在三条线上：课程浏览、提交预约、我的预约。为什么这样设计？因为这三条线正好把数据库的增删改查全覆盖：课程列表是查，提交预约是增，取消预约是改，预约表维护用户与课程的关系。答辩老师最常问的就是“你的项目做了哪些增删改查”，这个闭环能直接回答。至于手机号获取，新版小程序要求企业主体认证，个人主体毕设建议用 wx.login 拿 openid 代替，省掉审批流程，也避免当场演示授权失败。

2.3 数据库设计的前 30 分钟：先画表关系再写 SQL

拿到 SQL 脚本别急着导入，先画一张表关系图。健身预约最经典的模型是三张表：user、course、appointment，user 和 course 通过 appointment 形成多对多。画完再打开 .sql 文件对照，你会发现大多数源码包的结构都大同小异，这一步也能让你快速判断这套代码值不值得继续投入。

用户表除了常规的 id、nickname、avatar，要预留一个 openid 字段，它承担微信登录和自增 userId 之间的映射。课程表去掉花哨字段，核心就是课程名、教练、开始结束时间、容量 capacity、已约数 booked_count、价格。预约表是业务核心，用 status 字段表达状态，0 表示待上课、1 表示已完成、2 表示已取消。状态字段建议用 tinyint 而不是 varchar，数据库增删改查和 MyBatis 映射都更顺手，后端的 Integer 判断也简洁。

三个状态字段的约束关系是答辩高频点：用户只能取消“待上课”的预约，已完成或已取消的预约不能再操作，取消后课程表 booked_count 要减回去。这些规则不复杂，但你必须在代码里找到对应实现，而不是只在数据库注释里写。下面两个建表语句可以作为对照模板：

CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, coach VARCHAR(30), start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, capacity INT NOT NULL DEFAULT 10, booked_count INT NOT NULL DEFAULT 0, price DECIMAL(8,2), cover VARCHAR(200), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE appointment ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, course_id INT NOT NULL, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user_course (user_id, course_id) );

说明：appointment 表末尾的 uk_user_course 是唯一索引，防止同一用户对同一节课重复预约。很多人漏掉这个索引，导致业务层还要额外写一次查询来判重，而判重逻辑在并发下并不可靠。把唯一索引加上，再在代码里捕获重复键异常，才是把判重交给数据库。抢课、秒杀这类高并发场景用的是同一套思路，面试聊到也不跑题。

还有一个设计取舍：用户表记录不建议做物理删除，保留历史预约数据反而能统计课程热度。你可以在答辩时主动说“我保留了预约历史用于分析热门课程”，这比空谈数据安全有说服力。

3. 从零跑通源码：环境准备、导入工程与数据库初始化

源码包不是双击就能跑的，九成启动失败发生在环境阶段。这一章从版本搭配、数据库导入到后端联调走一遍最小路径，每一步都有明确结果，你照着做就能在半小时内看到第一个真实接口返回 JSON。

3.1 JDK / Maven / Tomcat / 微信开发者工具的四件套版本搭配

作为要快速落地的毕设，环境统一优先级最高。后端建议 JDK 8 + Maven 3.6.x + Tomcat 8.5/9 + MySQL 5.7，前端用微信开发者工具稳定版。这套组合不是最新的，但跟 SSM 老工程磨合得最久，问题也最容易查到答案。

检查环境的命令：

java -version mvn -v

正常输出应该是 java 1.8.0_xxx 和 Apache Maven 3.6.x。如果看到 java 17 或更高，先装 JDK 8 并把 JAVA_HOME 指过去再继续，这是后续所有步骤的基石。Maven 依赖下载慢的问题，在 settings.xml 里配阿里云镜像即可，不要反复删本地仓库重下，那是浪费时间。

注意：微信开发者工具打开项目时，选的是包含 app.json 的那个前端目录，不是整个压缩包解压后的顶层目录。很多人把整个文件夹拖进去，然后疑惑编辑器为什么报错。

3.2 数据库脚本导入与连接配置：别让 db.properties 成为第一道坎

解压后先找 .sql 文件，文件名通常是 fitness.sql 或 db_fitness.sql。导入推荐用命令行而不是可视化工具，因为出错信息更直观：

mysql -u root -p --default-character-set=utf8mb4 < fitness.sql

参数说明：-u root 指定用户名，-p 提示输入密码，--default-character-set=utf8mb4 让脚本里的中文按 utf8mb4 写入。漏掉这个参数，表结构能建出来，但课程名等中文数据会变成问号，等到小程序端看到满屏“？？？”再回头排查，损失的是整个晚上的时间。如果你习惯用数据库同步软件或 Navicat 导入，也务必确认连接编码和脚本编码一致。

导入后确认三张核心表：

mysql -u root -p -e "USE fitness; SHOW TABLES;"

看到 user、course、appointment 三张表之后，去 src/main/resources 下找 db.properties，这是后端连数据库的唯一入口。常见内容如下：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/fitness?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=123456

参数说明要分清版本差异：MySQL 5.7 用 com.mysql.jdbc.Driver；MySQL 8.0 必须改成 com.mysql.cj.jdbc.Driver，并且 URL 里的 serverTimezone=Asia/Shanghai 要保留，否则时区报错。jdbc.username 和 jdbc.password 改成你本机真实账号密码，这是第一道坎，十个启动失败里有三个是死在没改这里。

3.3 后端启动与小程序端联调的最小验证路径

后端工程通常是 Maven 结构，IDEA 里 File -> Open 选择 pom.xml 所在目录即可。依赖拉完后，最简单的启动方式是打包成 war 放进 Tomcat：

mvn clean package -DskipTests

-DskipTests 跳过测试用例，能省时间也避免测试类依赖环境变量导致失败。构建成功后 target 目录下会出现 fitness.war，把它复制到 Tomcat 的 webapps 目录，再启动 Tomcat，控制台出现 "Deploying web application archive" 且无异常，说明部署成功。

后端是否可用，用一个请求验证：

curl http://localhost:8080/fitness/course/list

返回 JSON 数组，说明后端、数据库、连接配置三者已经打通。如果 404，先确认地址里的 fitness 是不是 war 包名字，上下文路径必须带项目名。如果 500，去 Tomcat logs/localhost.log 看异常栈，常见的是数据库连接失败或 Mapper 绑定错误。后端通了之后，小程序端只需要把 baseUrl 指到本机地址，就可以进入联调阶段。

4. 动手改业务：健身课程预约的实现逻辑与必调参数

环境跑通只是开始，毕设能不能拿高分，取决于你能不能把业务讲透，并且改出几处自己的东西。这一章讲预约功能从页面到数据库的完整链路，顺带说清三个必调参数和并发场景的兜底写法。

4.1 预约流程的核心表：课程表、用户表、预约表的三个状态字段

预约的核心是状态流转。appointment.status 用三个整数值表达：0 待上课、1 已完成、2 已取消。页面上的取消按钮，后端要先查这个字段是不是 0，是 0 才允许取消；是 1 就不能取消并提示“课程已结束”。这个判断看似基础，但决定了后面所有关联操作的前提。

真正容易漏的是状态变更后的连带更新：取消预约要同时把 course.booked_count 减一。不少源码只改了 appointment 状态，没动 course 表，演示多几次就会出现“课程显示已约满，但教室空着一片”的诡异现象，数据库和界面数据对不上。这个属于数据一致性问题，答辩老师非常爱追问。

配套的 Service 代码一般长这样：

@Transactional public Result cancel(Integer userId, Integer courseId) { Appointment apt = appointmentMapper.selectByUserAndCourse(userId, courseId); if (apt == null || apt.getStatus() != 0) { return Result.error("当前预约状态不可取消"); } appointmentMapper.updateStatus(userId, courseId, 2); courseMapper.decreaseBookedCount(courseId); return Result.ok(); }

逻辑说明：先查预约记录判断状态，通过后在一个事务里同时修改预约状态和课程已约数。@Transactional 保证两条 SQL 要么都成功要么都回滚，这是避免数据不一致的最小实现，也是现场能讲清楚的最短代码。

预约写入时，要用条件更新挡住超卖：

UPDATE course SET booked_count = booked_count + 1 WHERE id = #{courseId} AND booked_count < capacity;

受影响行数为 1 才执行预约插入，为 0 直接返回“已约满”。这个写法把并发校验交给数据库行锁，而不是先 select 再 insert。“先查再写”在并发下会拿到过期数据，条件更新是最稳妥的兜底方案。答辩时主动说出这个点，比“我封装了 Result 类”这类话有价值得多。

4.2 课程列表接口从 Controller 到 Mapper 的完整调用链

课程列表是理解 SSM 请求链路最好的入口。请求流程是：小程序 wx.request 发出 HTTP 请求，Tomcat 交给 DispatcherServlet，按 URL 匹配到 CourseController，Controller 调 CourseService，Service 调 CourseMapper 接口，MyBatis 根据 XML 里的 SQL 查数据库，结果逐层返回并封装成 JSON。

Controller 典型写法：

@RestController @RequestMapping("/course") public class CourseController { @Autowired private CourseService courseService; @GetMapping("/list") public Result list(@RequestParam(defaultValue = "1") int page, @RequestParam(defaultValue = "10") int size) { return Result.ok(courseService.list(page, size)); } }

参数说明：page 和 size 控制分页，defaultValue 保证前端不传参也能运行。@RestController 是 Spring 4 之后才有的写法，等价于 @Controller 加每个方法上的 @ResponseBody。如果源码里是旧写法，答辩时讲清一种即可，不要两套混着讲。

对应的 MyBatis 映射 XML：

<select id="list" resultType="com.example.entity.Course"> SELECT id, name, coach, start_time, capacity, booked_count, price, cover FROM course ORDER BY start_time ASC LIMIT #{offset}, #{size} </select>

参数说明：offset 是 (page - 1) * size 计算出来的偏移量，size 是每页条数。XML 的 namespace 必须等于 CourseMapper 接口全限定名，id 必须等于接口方法名。改包名后忘记同步这里，是 MyBatis 最常见的启动期报错，后面避坑章会再讲。

Service 层看起来只是透传，但事务边界要放在这里：

@Service public class CourseServiceImpl implements CourseService { @Autowired private CourseMapper courseMapper; @Autowired private AppointmentMapper appointmentMapper; public PageResult list(int page, int size) { int offset = (page - 1) * size; List<Course> courses = courseMapper.list(offset, size); int total = courseMapper.count(); return PageResult.of(total, courses); } }

注意这里并没有加 @Transactional，因为查询操作不需要事务，只读时开启事务反而增加无谓开销。哪些方法加事务、哪些不加，这也是答辩能聊出的细节。

4.3 小程序端 wx.request 的封装与登录态处理

小程序端最重要的改造是统一请求入口。源码里如果每个页面都直接裸写 wx.request，后面改 baseUrl 会改到怀疑人生。第一步新建 config.js：

module.exports = { baseUrl: 'http://localhost:8080/fitness' }

第二步封装 request：

const config = require('../config') function request(path, method, data) { return new Promise((resolve, reject) => { wx.request({ url: config.baseUrl + path, method: method || 'GET', data: data || {}, header: { 'Content-Type': 'application/json' }, success(res) { if (res.data.code === 200) { resolve(res.data.data) } else { wx.showToast({ title: res.data.msg, icon: 'none' }) reject(res.data) } }, fail(err) { wx.showToast({ title: '网络请求失败', icon: 'none' }) reject(err) } }) }) } module.exports = { request }

逻辑说明：所有后端接口统一返回 { code, msg, data }，code 为 200 时把 data 交给页面，其他情况弹 toast 并 reject。这样页面里可以用 async/await 写业务，不用在每个回调里处理错误，排查问题也只看这一个文件。

登录态不碰手机号，用 wx.login 拿 code，后端拿 code 换 openid，再映射成本地 userId 并返回 token。token 存到 wx.setStorageSync，后续请求在 header 里带 Authorization。预约页面里选场次用 radio-group，课程列表页实现 onPullDownRefresh 下拉刷新，顶部导航栏用默认导航即可，不用自定义，省去状态栏高度适配的额外代码。

5. 避开毕设答辩的五个坑：SSM + 小程序项目排查笔记

这一章是血泪经验汇总。每一条都是我在帮人排查毕设项目时遇到过的真实翻车点，按“现象、原因、解决”三段写，方便你对照排查。

5.1 Tomcat 启动 404：项目没部署上或访问路径少了项目名

现象：Tomcat 启动正常，浏览器访问 localhost:8080 能看到默认页，但访问接口一直 404。

原因：war 包没有被正确解压，或者 URL 里漏了项目名。Tomcat 会按 war 包名生成上下文路径，所以完整地址是 localhost:8080/fitness/course/list，不是 localhost:8080/course/list。

解决：先看 Tomcat 的 webapps 目录下有没有 fitness 目录，没有就重新拷贝 war 并重启。然后用带项目名的 curl 命令测一次，能区分是路径问题还是接口问题。这个坑几乎每个用外部 Tomcat 的人都会踩，查的时候先从 webapps 目录看起。

5.2 小程序真机预览白屏或请求失败：合法域名与调试开关

现象：开发者工具里页面正常，点预览后用手机扫码，课程列表一直转圈或直接白屏。

原因：微信要求 wx.request 的域名必须是 HTTPS，并且要在小程序后台配置 request 合法域名。毕设后端跑在本地 HTTP 服务上，真机环境默认会拦截这些请求。

解决：开发调试阶段，在微信开发者工具“详情 -> 本地设置”里勾选不校验合法域名，这样预览也能访问本地接口。注意这个开关只用于本地调试，正式上线或演示时必须换成 HTTPS 域名并在小程序后台配置合法域名。答辩被问到，如实说明这是调试阶段的临时做法，合规合理，老师不会深究。

5.3 数据库中文乱码：characterEncoding 与表字符集不一致

现象：小程序端课程名显示“?????”，数据库里直接 select 查出来也是问号。

原因：导入 SQL 时没有带 utf8mb4 字符集参数，或者 db.properties 的连接 URL 里缺 characterEncoding 参数。两个地方只要有一个不对，中文就会乱码。

解决：删库重导，命令务必带 --default-character-set=utf8mb4，同时把连接 URL 改成 useUnicode=true&characterEncoding=utf8。改完重启 Tomcat 再查一次数据。记住字符集要三层一致：数据库、数据表、连接串，缺一不可。

5.4 MyBatis 映射文件不生效：mapper 扫描路径与 XML 位置不一致

现象：Tomcat 启动不报错，但一调课程列表接口就抛 Invalid bound statement (not found): com.example.mapper.CourseMapper.list。

原因：spring-mybatis.xml 里配置的 mapperLocations 和 XML 文件实际位置不一致，或者改过 Java 包名但 XML 里的 namespace 没有同步更新。

解决：检查 MyBatis 配置：

<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.example.mapper"/> </bean> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean>

basePackage 是 Mapper 接口所在的包，mapperLocations 是 XML 资源的通配路径。排查顺序按三步走：XML 文件实际放在哪个目录，配置路径指向哪个目录，namespace 是否等于接口全限定名。绝大多数情况下，是有人把 XML 放在了 java 源码目录里，而 classpath 扫描找不到它，把 XML 挪到 resources/mapper 下就能解决。

5.5 演示视频和源码版本对不上

现象：演示视频里预约成功，自己操作同一流程却报“已约满”或“该课程不存在”。

原因：不少流传的毕设包经过多轮修改，SQL 脚本、后端代码、演示视频未必是同一次迭代的产物，交付物之间互相矛盾。

解决：以能跑通的源码为准，把业务完整走一遍，重新录一段演示视频。别拿旧视频救场，答辩现场老师让你重演一次就会穿帮。同理，开题报告和 PPT 里写的功能要与实际代码逐条对照，删除没实现的、补上你自己新增的。这份诚实比任何答辩技巧都重要，老师见过太多功能表与实际代码不符的项目，对不上号才是真的扣分点。

6. 答辩前一夜：用一条验证链把项目从“能跑”变“能讲”

最后一件事，也是最划算的一件事：把业务闭环在你自己手上完整过三遍。闭环是这样一条链路：进入小程序，登录，打开课程列表，选一节有余量的课，提交预约，在“我的预约”里看到记录，取消预约，再回到课程详情看到已约人数减一。每一步操作之后，回数据库对比 appointment 和 course 两张表的数据，亲眼确认状态位变化对应哪条 SQL。

这一步的关键不只是“能跑”，而是强迫你把每一层代码都讲一遍：登录对应后端哪个接口，预约对应哪段事务，取消对应哪条 update。答辩老师不一定按你的 PPT 顺序问，但十有八九会顺着业务问数据变化。你能脱口而出“这里我用唯一索引防止重复预约”，比反复背 PPT 管用得多。

验证数据一致性，可以直接跑这条 SQL：

SELECT c.id, c.name, c.booked_count, c.capacity, COUNT(a.id) AS appointment_count FROM course c LEFT JOIN appointment a ON c.id = a.course_id AND a.status IN (0, 1) GROUP BY c.id;

逻辑说明：这条查询把课程表的 booked_count 和预约表里待上课、已完成的数量做对比。如果两边对不上，说明取消预约时漏改了 course 表，或者某次操作没走事务。这个检查能暴露隐藏 bug，也是答辩现场最能“显专业”的验证方法。

我自己当年的习惯是准备三张纸：一张画请求链路，一张画三表关系，一张写下三条最可能被追问的“为什么”。为什么用 SSM、为什么状态字段用 tinyint、并发预约怎么防超卖。这三句话能答顺，项目就稳了。与其熬夜调一个根本不怎么用的炫酷页面，不如把这条验证链走到形成肌肉记忆。祝你的健身小程序跑得顺、答得稳，希望帮到你。

本文还有配套的精品资源，点击获取