当前位置：首页 > news >正文

Spring Boot健身房管理系统：从零构建Java Web项目实战

news 2026/7/21 11:58:41

在实际 Java 项目开发中，无论是课程设计还是毕业设计，选择一个贴近实际业务、技术栈清晰、文档齐全的项目作为实践蓝本，是快速提升工程能力的关键。一个完整的“健身房管理系统”恰好涵盖了从会员管理、课程预约、消费记录到后台统计等典型业务场景，非常适合用来串联 Java Web 开发的核心技术栈，如 Spring Boot、MyBatis、MySQL、Thymeleaf 等。本文将围绕如何从零开始理解、搭建并运行一个健身房管理系统展开，重点不在于直接提供源码，而在于剖析其核心模块、技术选型、实现细节以及开发过程中必然会遇到的典型问题，帮助你构建一个可运行、可调试、可扩展的项目原型，并掌握独立排查和解决开发问题的能力。

1. 项目核心需求与技术栈选型

一个健身房管理系统，其核心是围绕“会员”和“服务”进行数据流转与业务处理。在动手编码前，必须明确系统要解决哪些问题，以及选择哪些技术来实现。

1.1 核心业务模块拆解

典型的健身房管理系统至少包含以下模块：

会员管理：会员信息的增删改查，包括基本信息、会员卡类型（次卡、月卡、年卡）、开卡/到期时间、剩余次数等。
课程管理：健身课程（如瑜伽、动感单车、私教课）的创建、排期、教练分配。
预约与签到：会员预约课程，并在上课时进行签到核销。
消费与储值：记录会员的办卡、续费、购买私教课等消费流水，以及储值账户的变动。
统计分析：基于会员数据、课程出勤率、消费情况生成各类报表。

这些模块共同构成了系统的数据模型和业务逻辑基础。

1.2 技术栈决策与理由

对于 Java 课程设计或毕业设计级别的项目，技术栈应在成熟、主流、学习资源丰富之间取得平衡。以下是一个推荐的技术栈组合及其选型理由：

技术组件	推荐版本/选择	在项目中的角色与选型理由
后端框架	Spring Boot 2.7.x	提供快速启动、自动配置、内嵌Web服务器，极大简化了传统SSH/SSM的繁琐配置，让开发者聚焦业务。
数据持久层	MyBatis-Plus 3.5.x	在 MyBatis 基础上增强了单表CRUD操作，内置通用Mapper和分页插件，能显著减少样板代码。
数据库	MySQL 8.0 或 5.7	关系型数据库，开源且应用广泛，适合存储结构化的会员、课程、订单数据。
前端模板	Thymeleaf	服务器端Java模板引擎，能与Spring Boot无缝集成，适合后端渲染页面的课程设计项目，学习曲线平缓。
项目管理	Maven 3.6+	依赖管理和项目构建的标准工具，便于统一管理第三方库的版本。
Java版本	JDK 11 或 17	LTS（长期支持）版本，兼顾稳定性和新特性。避免使用过旧或非LTS版本。

注意：许多“源码+笔记”资料包中的项目可能使用了较旧的技术（如 JSP、Servlet、Struts2）。虽然可以运行，但作为学习项目，建议以当前主流技术栈为目标进行重构或理解，这对理解现代Java开发更有价值。

2. 开发环境准备与项目初始化

在开始编码前，确保你的本地开发环境就绪。这是后续一切工作的基础，环境配置错误是新手最常见的问题来源。

2.1 基础环境检查清单

请按顺序检查并安装以下软件：

JDK：从官网下载 JDK 11 或 17 的安装包。安装后，在命令行执行java -version和javac -version，确认版本号正确输出。
Maven：下载并解压 Maven，配置MAVEN_HOME环境变量，并将%MAVEN_HOME%\bin添加到系统PATH中。执行mvn -v验证。
MySQL：安装 MySQL 社区版。安装过程中记住设置的 root 密码。安装后，确保 MySQL 服务已启动，并能通过命令行mysql -u root -p登录。
IDE：推荐使用 IntelliJ IDEA（社区版或旗舰版）或 Eclipse。IDEA 对 Spring Boot 和 Maven 的支持更为友好。

2.2 使用 Spring Initializr 快速初始化项目

这是构建现代 Spring Boot 项目的标准起点，能避免手动配置的繁琐和错误。

访问 start.spring.io 。
填写项目元数据：
- Project: Maven Project
- Language: Java
- Spring Boot: 选择 2.7.x 版本（如 2.7.18）
在Dependencies中添加：Spring Web,Thymeleaf,MyBatis Framework,MySQL Driver。这将自动生成包含这些依赖的pom.xml。
点击Generate下载项目压缩包，解压后用 IDE 打开。

2.3 补充关键依赖与基础配置

Initializr 生成的依赖可能不全，需要手动在pom.xml中添加一些提高开发效率的库。

<!-- 在 pom.xml 的 <dependencies> 部分添加 --> <!-- MyBatis-Plus 增强工具 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <!-- Lombok 简化实体类编写 --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <!-- Hibernate Validator 用于参数校验 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency>

随后，配置application.yml（或application.properties）文件，这是 Spring Boot 的核心配置文件。

# src/main/resources/application.yml server: port: 8080 # 服务启动端口 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/gym_management?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai username: root # 替换为你的数据库用户名 password: your_password # 替换为你的数据库密码 thymeleaf: cache: false # 开发时关闭模板缓存，修改HTML后立即生效 # MyBatis-Plus 配置 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台打印SQL，便于调试 global-config: db-config: id-type: auto # 主键策略，数据库自增

注意：spring.datasource.url中的gym_management是数据库名，你需要先在 MySQL 中创建这个数据库：CREATE DATABASE gym_management CHARACTER SET utf8mb4;。serverTimezone参数对于避免时区导致的日期时间问题至关重要。

3. 数据库设计与实体类映射

数据库设计是系统的基石。一个糟糕的设计会导致后续业务代码极其复杂且难以维护。

3.1 核心表结构设计

以下是简化版的核心表设计，每张表都应包含逻辑删除标记（is_deleted）和审计字段（create_time,update_time），这是生产级项目的基本要求。

会员表 (member)

CREATE TABLE `member` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键', `member_number` varchar(20) NOT NULL COMMENT '会员卡号', `name` varchar(50) NOT NULL COMMENT '姓名', `phone` varchar(20) DEFAULT NULL COMMENT '手机号', `gender` tinyint DEFAULT NULL COMMENT '性别 (0:未知, 1:男, 2:女)', `birthday` date DEFAULT NULL COMMENT '生日', `card_type` tinyint NOT NULL COMMENT '卡类型 (1:次卡, 2:月卡, 3:季卡, 4:年卡)', `total_times` int DEFAULT 0 COMMENT '总次数（次卡有效）', `remaining_times` int DEFAULT 0 COMMENT '剩余次数', `valid_from` date NOT NULL COMMENT '有效期开始', `valid_to` date NOT NULL COMMENT '有效期截止', `status` tinyint DEFAULT 1 COMMENT '状态 (1:正常, 0:冻结)', `is_deleted` tinyint DEFAULT 0 COMMENT '逻辑删除 (0:未删, 1:已删)', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_member_number` (`member_number`), KEY `idx_phone` (`phone`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='会员表';

课程表 (course)

CREATE TABLE `course` ( `id` bigint NOT NULL AUTO_INCREMENT, `name` varchar(100) NOT NULL COMMENT '课程名称', `coach_id` bigint NOT NULL COMMENT '教练ID', `schedule_time` datetime NOT NULL COMMENT '排课时间', `duration` int DEFAULT 60 COMMENT '时长(分钟)', `capacity` int DEFAULT 20 COMMENT '课程容量', `booked_count` int DEFAULT 0 COMMENT '已预约人数', `is_deleted` tinyint DEFAULT 0, `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='课程表';

预约记录表 (booking)

CREATE TABLE `booking` ( `id` bigint NOT NULL AUTO_INCREMENT, `member_id` bigint NOT NULL COMMENT '会员ID', `course_id` bigint NOT NULL COMMENT '课程ID', `booking_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '预约时间', `status` tinyint DEFAULT 1 COMMENT '状态 (1:已预约, 2:已签到, 3:已取消)', `checkin_time` datetime DEFAULT NULL COMMENT '签到时间', `is_deleted` tinyint DEFAULT 0, `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_member_course` (`member_id`,`course_id`) COMMENT '防止重复预约' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='预约记录表';

还需要设计coach（教练）、consumption（消费记录）等表，逻辑类似。

3.2 使用 MyBatis-Plus 实现实体类与 Mapper

利用 MyBatis-Plus 的注解，可以快速将表映射为 Java 对象和数据库操作接口。

实体类 (Member.java)

package com.example.gym.entity; import com.baomidou.mybatisplus.annotation.*; import lombok.Data; import java.time.LocalDate; import java.time.LocalDateTime; @Data @TableName("member") // 指定对应表名 public class Member { @TableId(type = IdType.AUTO) // 主键自增 private Long id; private String memberNumber; private String name; private String phone; private Integer gender; // 使用包装类型，允许为null private LocalDate birthday; private Integer cardType; private Integer totalTimes; private Integer remainingTimes; private LocalDate validFrom; private LocalDate validTo; private Integer status; @TableLogic // 逻辑删除注解 private Integer isDeleted; @TableField(fill = FieldFill.INSERT) // 插入时自动填充 private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) // 插入和更新时自动填充 private LocalDateTime updateTime; }

Mapper 接口 (MemberMapper.java)

package com.example.gym.mapper; import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.example.gym.entity.Member; import org.apache.ibatis.annotations.Mapper; @Mapper // 关键注解，让Spring管理此接口 public interface MemberMapper extends BaseMapper<Member> { // 继承 BaseMapper 后，已具备单表基本的 CRUD 方法，无需编写 XML }

自动填充处理器 (MyMetaObjectHandler.java)为了自动填充create_time和update_time，需要配置一个元对象处理器。

package com.example.gym.handler; import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler; import org.apache.ibatis.reflection.MetaObject; import org.springframework.stereotype.Component; import java.time.LocalDateTime; @Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }

4. 业务逻辑实现：以会员管理为例

有了数据层基础，接下来实现业务逻辑层（Service）和控制层（Controller）。这是 MVC 模式的核心。

4.1 创建 Service 层与分页查询

Service 层负责具体的业务规则。例如，新增会员时需要生成唯一的会员卡号。

会员服务接口 (MemberService.java)

package com.example.gym.service; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.baomidou.mybatisplus.extension.service.IService; import com.example.gym.entity.Member; import com.example.gym.vo.MemberQueryVO; public interface MemberService extends IService<Member> { /** * 条件分页查询会员 * @param pageParam 分页参数 * @param queryVO 查询条件 * @return 分页结果 */ Page<Member> queryByPage(Page<Member> pageParam, MemberQueryVO queryVO); /** * 新增会员，并生成会员卡号 * @param member 会员信息 * @return 是否成功 */ boolean saveMember(Member member); }

查询参数封装对象 (MemberQueryVO.java)

package com.example.gym.vo; import lombok.Data; import java.time.LocalDate; @Data public class MemberQueryVO { private String name; // 按姓名模糊查询 private String phone; // 按手机号精确查询 private Integer cardType; // 按卡类型查询 private Integer status; // 按状态查询 private LocalDate validToStart; // 有效期截止查询范围-开始 private LocalDate validToEnd; // 有效期截止查询范围-结束 }

会员服务实现 (MemberServiceImpl.java)

package com.example.gym.service.impl; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; import com.example.gym.entity.Member; import com.example.gym.mapper.MemberMapper; import com.example.gym.service.MemberService; import com.example.gym.vo.MemberQueryVO; import org.apache.commons.lang3.StringUtils; import org.springframework.stereotype.Service; import java.time.LocalDate; import java.time.format.DateTimeFormatter; @Service public class MemberServiceImpl extends ServiceImpl<MemberMapper, Member> implements MemberService { private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd"); @Override public Page<Member> queryByPage(Page<Member> pageParam, MemberQueryVO queryVO) { LambdaQueryWrapper<Member> wrapper = new LambdaQueryWrapper<>(); // 构建动态查询条件 wrapper.like(StringUtils.isNotBlank(queryVO.getName()), Member::getName, queryVO.getName()); wrapper.eq(StringUtils.isNotBlank(queryVO.getPhone()), Member::getPhone, queryVO.getPhone()); wrapper.eq(queryVO.getCardType() != null, Member::getCardType, queryVO.getCardType()); wrapper.eq(queryVO.getStatus() != null, Member::getStatus, queryVO.getStatus()); // 有效期查询： valid_to BETWEEN ? AND ? if (queryVO.getValidToStart() != null && queryVO.getValidToEnd() != null) { wrapper.between(Member::getValidTo, queryVO.getValidToStart(), queryVO.getValidToEnd()); } // 按创建时间倒序排列 wrapper.orderByDesc(Member::getCreateTime); return baseMapper.selectPage(pageParam, wrapper); } @Override public boolean saveMember(Member member) { // 1. 生成会员卡号：规则为 GYM + 年月日 + 4位随机数 (示例) String dateStr = LocalDate.now().format(FORMATTER); int randomNum = (int)((Math.random() * 9 + 1) * 1000); // 1000-9999 member.setMemberNumber("GYM" + dateStr + randomNum); // 2. 设置默认状态 if (member.getStatus() == null) { member.setStatus(1); } // 3. 保存到数据库 return this.save(member); } }

4.2 创建 Controller 层与页面交互

Controller 层接收前端请求，调用 Service，并返回数据或视图。

会员控制器 (MemberController.java)

package com.example.gym.controller; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.example.gym.entity.Member; import com.example.gym.service.MemberService; import com.example.gym.vo.MemberQueryVO; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.*; @Controller @RequestMapping("/member") public class MemberController { @Autowired private MemberService memberService; /** * 分页查询会员列表页面 */ @GetMapping("/list") public String list(@RequestParam(defaultValue = "1") Long pageNum, @RequestParam(defaultValue = "10") Long pageSize, MemberQueryVO queryVO, Model model) { Page<Member> page = new Page<>(pageNum, pageSize); Page<Member> resultPage = memberService.queryByPage(page, queryVO); model.addAttribute("page", resultPage); model.addAttribute("queryVO", queryVO); // 回显查询条件 return "member/list"; // 对应 src/main/resources/templates/member/list.html } /** * 跳转到新增会员页面 */ @GetMapping("/add") public String toAddPage() { return "member/add"; } /** * 处理新增会员请求 */ @PostMapping("/add") public String addMember(Member member) { boolean success = memberService.saveMember(member); // 这里应该处理成功或失败的逻辑，例如返回提示信息 return "redirect:/member/list"; // 重定向到列表页 } /** * 处理删除请求（逻辑删除） */ @PostMapping("/delete/{id}") @ResponseBody // 返回JSON数据 public String delete(@PathVariable Long id) { boolean success = memberService.removeById(id); // MyBatis-Plus 逻辑删除 return success ? "success" : "fail"; } }

4.3 使用 Thymeleaf 渲染前端列表页

Thymeleaf 模板放在src/main/resources/templates/目录下。

会员列表页 (list.html)

<!DOCTYPE html> <html lang="zh" xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>会员管理</title> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css"> </head> <body> <div class="container mt-4"> <h2>会员列表</h2> <!-- 查询表单 --> <form class="row g-3 mb-3" th:action="@{/member/list}" method="get"> <div class="col-auto"> <input type="text" class="form-control" th:name="name" th:value="${queryVO.name}" placeholder="姓名"> </div> <div class="col-auto"> <input type="text" class="form-control" th:name="phone" th:value="${queryVO.phone}" placeholder="手机号"> </div> <div class="col-auto"> <button type="submit" class="btn btn-primary">查询</button> <a th:href="@{/member/add}" class="btn btn-success">新增会员</a> </div> </form> <!-- 会员表格 --> <table class="table table-striped"> <thead> <tr> <th>卡号</th> <th>姓名</th> <th>手机号</th> <th>卡类型</th> <th>剩余次数</th> <th>有效期至</th> <th>状态</th> <th>操作</th> </tr> </thead> <tbody> <!-- 使用Thymeleaf遍历分页数据 --> <tr th:each="member : ${page.records}"> <td th:text="${member.memberNumber}">GYM20240520001</td> <td th:text="${member.name}">张三</td> <td th:text="${member.phone}">13800138000</td> <td> <span th:switch="${member.cardType}"> <span th:case="1">次卡</span> <span th:case="2">月卡</span> <span th:case="3">季卡</span> <span th:case="4">年卡</span> </span> </td> <td th:text="${member.remainingTimes}">10</td> <td th:text="${#temporals.format(member.validTo, 'yyyy-MM-dd')}">2024-12-31</td> <td> <span th:if="${member.status == 1}" class="badge bg-success">正常</span> <span th:if="${member.status == 0}" class="badge bg-secondary">冻结</span> </td> <td> <a th:href="@{'/member/edit/' + ${member.id}}" class="btn btn-sm btn-outline-primary">编辑</a> <button class="btn btn-sm btn-outline-danger" onclick="deleteMember([[${member.id}]])">删除</button> </td> </tr> </tbody> </table> <!-- 分页组件 --> <nav> <ul class="pagination"> <li class="page-item" th:classappend="${page.current == 1} ? 'disabled' : ''"> <a class="page-link" th:href="@{/member/list(pageNum=${page.current}-1, pageSize=${page.size}, name=${queryVO.name}, phone=${queryVO.phone})}">上一页</a> </li> <!-- 简化分页显示，实际项目应做更多处理 --> <li class="page-item" th:each="i : ${#numbers.sequence(1, page.pages)}" th:classappend="${i == page.current} ? 'active' : ''"> <a class="page-link" th:href="@{/member/list(pageNum=${i}, pageSize=${page.size}, name=${queryVO.name}, phone=${queryVO.phone})}" th:text="${i}">1</a> </li> <li class="page-item" th:classappend="${page.current == page.pages} ? 'disabled' : ''"> <a class="page-link" th:href="@{/member/list(pageNum=${page.current}+1, pageSize=${page.size}, name=${queryVO.name}, phone=${queryVO.phone})}">下一页</a> </li> </ul> </nav> </div> <script> function deleteMember(id) { if (confirm('确定要删除此会员吗？')) { fetch('/member/delete/' + id, { method: 'POST' }) .then(response => response.text()) .then(result => { if (result === 'success') { alert('删除成功'); location.reload(); // 刷新页面 } else { alert('删除失败'); } }); } } </script> </body> </html>

5. 项目运行、验证与常见问题排查

完成核心模块开发后，需要启动项目并进行功能验证。这个阶段会遇到各种配置和代码问题。

5.1 启动项目与访问

找到主启动类（通常名为GymManagementApplication.java），其注解为@SpringBootApplication。
在 IDE 中直接运行该类，或在项目根目录下执行命令mvn spring-boot:run。
观察控制台日志，直到看到类似Tomcat started on port(s): 8080和Started GymManagementApplication in x.xxx seconds的信息，表示启动成功。
打开浏览器，访问http://localhost:8080/member/list。你应该能看到会员列表页面（初始为空，因为没有数据）。

5.2 核心功能验证流程

数据初始化：通过数据库客户端或编写一个简单的初始化 SQL 脚本，向member、course等表插入几条测试数据。
列表查询：访问/member/list，确认页面能正常显示数据，并且查询条件（姓名、手机号）能正常工作。
分页功能：插入超过 10 条数据，检查分页控件是否正常显示和跳转。
新增功能：点击“新增会员”，填写表单并提交，检查数据库是否成功插入数据，且会员卡号是否按规则生成。
删除功能：点击某条记录的删除按钮，确认记录状态变为已删除（is_deleted变为 1），且页面不再显示（或显示为已删除状态）。

5.3 高频问题排查指南

在开发过程中，以下问题是最高频出现的：

问题现象	可能原因	检查与解决步骤
启动报错：`Failed to configure a DataSource`	数据库连接配置错误或数据库服务未启动。	1. 检查`application.yml`中的`url`,`username`,`password`。 2. 确认 MySQL 服务已启动 (`net start mysql`)。 3. 确认数据库`gym_management`已创建。 4. 检查 MySQL 用户权限。
启动报错：`java: 警告: 源发行版 X 需要目标发行版 X`	IDE 中项目的 Java 编译版本与`pom.xml`中指定的版本不一致。	1. 在 IDEA 中：`File -> Project Structure -> Project`，确保`Project SDK`和`Project language level`与`pom.xml`中的`<java.version>`一致。 2.`File -> Settings -> Build -> Compiler -> Java Compiler`，检查模块的`Target bytecode version`。
访问页面报 404	1. 请求路径与`@RequestMapping`不匹配。 2. 静态资源或模板文件位置错误。 3. Controller 未被 Spring 扫描到。	1. 检查浏览器地址栏 URL 与 Controller 中定义的路径是否完全一致（包括大小写）。 2. Thymeleaf 模板必须放在`resources/templates/`下，且 Controller 返回的字符串与之对应。 3. 确保主启动类所在的包能扫描到你的 Controller（通常 Controller 放在主类子包下）。
页面能打开，但数据显示为`null`或报错	1. Thymeleaf 表达式写错。 2. Model 中未放入数据或 key 不对。 3. 实体类字段与数据库列名映射失败。	1. 检查 HTML 中`th:text`等属性的表达式是否正确引用 Model 中的属性。 2. 在 Controller 中调试，确认放入 Model 的数据不为空。 3. 检查实体类字段名是否与数据库列名对应（开启 MyBatis-Plus SQL 日志查看实际查询的字段）。
插入或更新数据时，日期字段报错	前端传递的日期字符串格式与后端接收格式不匹配。	1. 在实体类的`LocalDate`字段上添加`@DateTimeFormat(pattern = "yyyy-MM-dd")`注解。 2. 确保前端表单传递的日期字符串格式与该模式一致。
逻辑删除不生效	1. 实体类未加`@TableLogic`注解。 2. 数据库表没有`is_deleted`字段。 3. 未在配置中指定逻辑删除的全局值。	1. 确认实体类中标记逻辑删除的字段有`@TableLogic`。 2. 在`application.yml`中添加配置：`mybatis-plus.global-config.db-config.logic-delete-value: 1`和`logic-not-delete-value: 0`。

注意：排查问题时，控制台日志是首要信息来源。务必养成查看启动日志、SQL 日志和异常堆栈的习惯。将mybatis-plus.configuration.log-impl设置为StdOutImpl可以方便地看到所有执行的 SQL 语句。

6. 项目扩展方向与生产级考量

一个课程设计项目可以运行只是起点。要将其提升到毕业设计或更接近实际项目的水平，需要考虑以下扩展点。

6.1 功能扩展建议

课程预约与签到核销：实现会员预约课程、教练确认、上课签到、自动扣减次数的完整流程。这里涉及事务控制（@Transactional）以确保数据一致性。
消费流水与财务报表：记录每一笔充值、消费，并生成日/月/年度的收入统计报表。可以使用 EasyExcel 或 Apache POI 实现数据导出。
权限管理 (RBAC)：引入 Spring Security 或 Shiro，区分子系统管理员、前台、教练等不同角色，实现菜单和按钮级别的权限控制。
数据可视化：集成 ECharts，在管理后台展示会员增长趋势、课程出勤率、收入构成等图表。

6.2 生产环境最佳实践

如果这个系统需要部署到真实环境，以下事项必须考虑：

配置分离：将数据库密码等敏感信息从application.yml移到application-prod.yml，并通过启动参数--spring.profiles.active=prod激活。或使用配置中心。
API 文档：集成 Swagger 或 Knife4j，自动生成后端 API 文档，便于前后端联调。
统一响应封装：定义统一的Result类来包装所有 Controller 的返回结果，包含code,msg,data字段，使前端处理更规范。
全局异常处理：使用@ControllerAdvice和@ExceptionHandler捕获系统异常，并返回友好的错误信息，而不是暴露堆栈详情。
日志规范：使用 SLF4J 配合 Logback，合理设置日志级别，将不同级别的日志输出到不同文件，并做好日志滚动归档。
数据库优化：为高频查询字段（如phone,member_number）建立索引。对于复杂的统计报表，考虑使用定时任务预计算并存入统计表。
前端工程化：对于更复杂的交互，可以考虑将 Thymeleaf 替换为前后端分离架构，前端使用 Vue.js 或 React，通过 RESTful API 与后端交互。