又到了毕业设计选题和 Java 项目练手的密集期。很多同学在后台问我想找一个功能适中、技术栈主流、能写进简历也能应付答辩的 JavaWeb 项目。挑来挑去健身房会员管理系统确实是一个很合适的选题。这类项目典型的业务场景是“会员 卡 课程 预约 消费记录”既没有电商系统那么复杂又比单纯的学生管理系统更有业务深度。数据表之间有清晰的关联关系代码能覆盖增删改查、分页搜索、事务处理、时间到期判断等常见开发场景用来巩固 Java 基础、学习 Spring Boot 和 MySQL 实战非常合适。这篇文章我会按项目开发顺序来拆解从需求分析、数据库设计到核心代码实现再到常见报错排查和答辩准备建议。每个关键点都尽量解释清楚“为什么这么做”而不是只贴代码。1. 系统背景与需求分析1.1 健身房会员管理系统是什么健身房会员管理系统是一套面向中小型健身房的前台业务管理工具。核心目标是帮助健身房工作人员完成会员开卡、续费、课程预约、消费记录查询等日常工作让老板能及时掌握会员数量和经营收入情况。从开发角度看这个系统本质上是一个典型的信息管理系统数据模型以“会员”为中心围绕会员的办卡行为、上课行为和消费行为展开。相比网上常见的“学生管理系统”它的业务规则更多一些比如会员卡有有效期、续费要延长到期时间、私教课预约要扣减剩余课时这些规则能锻炼真实的业务建模能力。1.2 为什么适合做 Java 毕设或练手项目业务规模适中表数量控制在 6~8 张左右功能完整度高但又不至于像大型系统那样难以驾驭。技术栈主流可以完整使用 Spring Boot MyBatis-Plus MySQL 这套 Java 后端开发最常见的组合。答辩容易讲系统边界清晰模块划分直观面试官或答辩老师很容易理解你的项目价值。可扩展性强做完基础版后可以继续加 Redis 缓存、JWT 登录、Excel 导出、ECharts 统计图表等特性适合提升项目亮点。1.3 系统核心角色与用例在健身房管理系统中通常分为两种角色角色主要操作管理员/前台会员信息管理、会员卡办理、续费、课程管理、预约审核、查看营业统计会员查看个人信息、查看课程、预约私教课、查看自己的消费记录如果只做后端管理端会员端的功能可以简化为后台的查询与预约操作。如果是前后端分离项目还可以把会员端小程序或 H5 作为二期扩展。2. 技术选型与项目环境准备2.1 技术栈选择我采用的是一套比较稳妥的 Java 后端技术组合技术用途Java 8编程语言JDK 8 对大多数毕设和中小企业项目仍然足够稳定Spring Boot 2.x / 3.x后端基础框架自动配置快速构建独立应用MyBatis-PlusORM 框架简化单表增删改查提供分页插件MySQL 5.7 / 8.0关系型数据库存储业务数据Maven项目构建与依赖管理Lombok简化实体类代码Postman / Apifox接口调试与测试如果你本机 JDK 是 17 或更高版本建议优先使用 Spring Boot 3.x 版本但要注意 MyBatis-Plus 需要使用适配 Spring Boot 3 的版本例如mybatis-plus-spring-boot3-starter。2.2 环境检查清单开始写代码之前建议先确认开发环境java -version mvn -v mysql --version运行结果里能正常输出版本号即可。MySQL 需要提前启动服务并确保有权限创建数据库。如果你使用 Navicat、DataGrip 或 IDEA 自带的数据库工具可以直接通过工具创建数据库和导入 SQL 脚本。2.3 项目结构规划一个清晰的项目结构能帮助后续扩展和维护。本文采用经典的三层架构gym-member-system ├── pom.xml └── src/main ├── java/com/example/gym │ ├── GymApplication.java // Spring Boot 启动类 │ ├── controller/ // 控制层接收前端请求 │ ├── service/ // 业务层处理业务逻辑 │ ├── mapper/ // 数据访问层数据库操作 │ ├── entity/ // 实体类对应数据库表 │ ├── dto/ // 数据传输对象 │ ├── common/ // 统一返回结果、异常处理等 │ └── config/ // 配置类如 MyBatis-Plus 配置 └── resources ├── application.yml // 应用配置 └── sql/gym_member.sql // 数据库初始化脚本3. 数据库设计与建表 SQL数据库设计是健身房会员管理系统最关键的一步。表结构如果设计得不合理后面写代码会非常痛苦。3.1 核心表设计我建议至少设计以下 6 张表表名说明核心字段member会员基本信息表id、name、phone、gender、birthday、create_timecard_type会员卡类型表id、type_name、duration_days、price、is_activemember_card会员持卡表id、member_id、card_type_id、start_date、end_date、statuscourse课程表id、course_name、course_type、teacher、class_time、max_peopleappointment预约记录表id、member_id、course_id、appointment_time、statusconsume_record消费记录表id、member_id、consume_type、amount、remark、create_time如果需要登录功能可以额外增加一张admin_user管理员表。如果涉及私教课时扣减可以在member_card或单独private_course_record表中增加课时数字段。3.2 建表 SQL 示例下面提供一个完整可执行的 SQL 脚本。实际使用时可先创建gym_member数据库然后导入该脚本。CREATE DATABASE IF NOT EXISTS gym_member DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE gym_member; -- 会员表 CREATE TABLE member ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 会员ID, name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) NOT NULL UNIQUE COMMENT 手机号, gender TINYINT DEFAULT 0 COMMENT 性别0未知 1男 2女, birthday DATE COMMENT 生日, address VARCHAR(255) COMMENT 住址, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员信息表; -- 会员卡类型表 CREATE TABLE card_type ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 卡类型ID, type_name VARCHAR(50) NOT NULL COMMENT 卡名称如季卡、年卡, duration_days INT NOT NULL COMMENT 有效天数, price DECIMAL(10,2) NOT NULL COMMENT 价格, is_active TINYINT DEFAULT 1 COMMENT 是否启用1启用 0停用 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员卡类型表; -- 会员持卡表 CREATE TABLE member_card ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 持卡记录ID, member_id BIGINT NOT NULL COMMENT 会员ID, card_type_id BIGINT NOT NULL COMMENT 卡类型ID, start_date DATETIME NOT NULL COMMENT 开卡时间, end_date DATETIME NOT NULL COMMENT 到期时间, status TINYINT DEFAULT 1 COMMENT 状态1正常 0停用, remark VARCHAR(255) COMMENT 备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员持卡表; -- 课程表 CREATE TABLE course ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 课程ID, course_name VARCHAR(100) NOT NULL COMMENT 课程名称, course_type VARCHAR(50) COMMENT 课程类型如瑜伽、动感单车, teacher VARCHAR(50) COMMENT 教练, class_time VARCHAR(50) COMMENT 上课时间描述, max_people INT DEFAULT 20 COMMENT 最大人数 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT课程表; -- 预约记录表 CREATE TABLE appointment ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 预约ID, member_id BIGINT NOT NULL COMMENT 会员ID, course_id BIGINT NOT NULL COMMENT 课程ID, appointment_time DATETIME NOT NULL COMMENT 预约时间, status TINYINT DEFAULT 0 COMMENT 状态0已预约 1已取消 2已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT预约记录表; -- 消费记录表 CREATE TABLE consume_record ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 消费ID, member_id BIGINT NOT NULL COMMENT 会员ID, consume_type VARCHAR(50) NOT NULL COMMENT 消费类型开卡、续费、私教课, amount DECIMAL(10,2) NOT NULL COMMENT 消费金额, remark VARCHAR(255) COMMENT 备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 消费时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT消费记录表; -- 管理员表 CREATE TABLE admin_user ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 管理员ID, username VARCHAR(50) NOT NULL UNIQUE COMMENT 用户名, password VARCHAR(100) NOT NULL COMMENT 密码BCrypt加密, real_name VARCHAR(50) COMMENT 姓名, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT管理员表; -- 插入默认管理员密码为 123456 的 BCrypt 加密结果 INSERT INTO admin_user (username, password, real_name) VALUES (admin, $2a$10$D8mR1mHUdF0nG5iK7zJzUO9vjP4QY7gQ1Y8m1wXtQy0vVKHh0w4ye, 系统管理员);在实际开发中会员表和会员卡表可以设计成一对多关系因为一个老会员可能在年卡到期后继续续费产生多条持卡记录。这样能保留历史数据方便后续统计复购率。3.3 表关系说明member与member_card一对多一个会员可以有多张卡记录。card_type与member_card一对多一个卡类型可被多个会员持有。member与appointment一对多。course与appointment一对多。member与consume_record一对多。这个模型是完整的“会员生命周期”管理思路开卡产生持卡记录和消费记录续费更新持卡到期时间并追加消费记录上课通过预约记录关联课程。4. 项目搭建与核心代码实现4.1 创建 Spring Boot 项目使用 IDEA 创建项目时选择Spring Initializr需要添加的依赖如下Spring WebMySQL DriverMyBatis-Plus 依赖需要手动添加Lombok如果是手动创建 Maven 项目请在pom.xml中引入下面的关键依赖版本号可以根据自己实际情况调整parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies !-- Web 支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus 启动器Spring Boot 2 版本 -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Lombok 简化实体类 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies如果你的环境是 Spring Boot 3.x那么 MyBatis-Plus 需要换成mybatis-plus-spring-boot3-starter。这个差异是很多同学第一次启动就报错的主要原因需要特别留意。4.2 配置 application.yml在src/main/resources目录下创建application.yml配置数据源和 MyBatis-Plus 相关参数server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/gym_member?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0map-underscore-to-camel-case的作用是把数据库的create_time字段自动映射为实体类的createTime这样写代码时不需要每次手动指定映射关系。serverTimezoneAsia/Shanghai可以解决 MySQL 8.x 连接时的时区问题避免数据库时间和本地时间相差 8 小时。4.3 编写实体类以Member实体类为例使用 Lombok 简化 getter/setter// 文件路径src/main/java/com/example/gym/entity/Member.java package com.example.gym.entity; import com.baomidou.mybatisplus.annotation.IdType; import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; import java.time.LocalDateTime; Data TableName(member) public class Member { TableId(type IdType.AUTO) private Long id; private String name; private String phone; private Integer gender; private String birthday; private String address; private LocalDateTime createTime; private LocalDateTime updateTime; }TableName用于指定实体类对应的数据库表。TableId(type IdType.AUTO)表示主键自增。其他实体类如CardType、MemberCard、Course、Appointment、ConsumeRecord的写法类似。4.4 编写 Mapper 接口MyBatis-Plus 的 Mapper 接口只需继承BaseMapperT就能获得单表的增删改查能力// 文件路径src/main/java/com/example/gym/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 public interface MemberMapper extends BaseMapperMember { }如果需要编写自定义 SQL比如联表查询会员卡信息可以在接口中增加方法并配合Select注解或 XML 文件实现。4.5 统一返回结果类为了让前端或接口调用方拿到统一格式的数据建议定义一个通用的返回结构// 文件路径src/main/java/com/example/gym/common/Result.java package com.example.gym.common; import lombok.Data; Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(操作成功); result.setData(data); return result; } public static T ResultT error(String message) { ResultT result new Result(); result.setCode(500); result.setMessage(message); return result; } }4.6 Service 层实现会员管理先定义接口// 文件路径src/main/java/com/example/gym/service/MemberService.java package com.example.gym.service; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.example.gym.entity.Member; public interface MemberService { PageMember pageMembers(int pageNum, int pageSize, String name, String phone); Member getMemberById(Long id); boolean addMember(Member member); boolean updateMember(Member member); boolean deleteMember(Long id); }实现类// 文件路径src/main/java/com/example/gym/service/impl/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.example.gym.entity.Member; import com.example.gym.mapper.MemberMapper; import com.example.gym.service.MemberService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.util.StringUtils; Service public class MemberServiceImpl implements MemberService { Autowired private MemberMapper memberMapper; Override public PageMember pageMembers(int pageNum, int pageSize, String name, String phone) { PageMember page new Page(pageNum, pageSize); LambdaQueryWrapperMember wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(name)) { wrapper.like(Member::getName, name); } if (StringUtils.hasText(phone)) { wrapper.eq(Member::getPhone, phone); } wrapper.orderByDesc(Member::getCreateTime); return memberMapper.selectPage(page, wrapper); } Override public Member getMemberById(Long id) { return memberMapper.selectById(id); } Override public boolean addMember(Member member) { return memberMapper.insert(member) 0; } Override public boolean updateMember(Member member) { return memberMapper.updateById(member) 0; } Override public boolean deleteMember(Long id) { return memberMapper.deleteById(id) 0; } }这里的LambdaQueryWrapper是 MyBatis-Plus 提供的条件构造器用 Lambda 表达式引用实体字段避免硬编码数据库列名。如果字段改名或实体属性改名代码会有编译期提示。4.7 Controller 层暴露接口// 文件路径src/main/java/com/example/gym/controller/MemberController.java package com.example.gym.controller; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.example.gym.common.Result; import com.example.gym.entity.Member; import com.example.gym.service.MemberService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; RestController RequestMapping(/api/member) public class MemberController { Autowired private MemberService memberService; GetMapping(/page) public ResultPageMember page( RequestParam(defaultValue 1) int pageNum, RequestParam(defaultValue 10) int pageSize, RequestParam(required false) String name, RequestParam(required false) String phone) { return Result.success(memberService.pageMembers(pageNum, pageSize, name, phone)); } GetMapping(/{id}) public ResultMember getById(PathVariable Long id) { return Result.success(memberService.getMemberById(id)); } PostMapping public ResultBoolean add(RequestBody Member member) { return Result.success(memberService.addMember(member)); } PutMapping public ResultBoolean update(RequestBody Member member) { return Result.success(memberService.updateMember(member)); } DeleteMapping(/{id}) public ResultBoolean delete(PathVariable Long id) { return Result.success(memberService.deleteMember(id)); } }4.8 配置 MyBatis-Plus 分页插件如果直接使用selectPage而不配置分页插件分页功能不会生效这是新手最容易忽略的问题。需要新建一个配置类// 文件路径src/main/java/com/example/gym/config/MybatisPlusConfig.java package com.example.gym.config; import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }4.9 会员开卡与续费业务逻辑健身房系统的业务核心不是单纯的增删改查而是“开卡”和“续费”这两个场景。开卡的逻辑是根据memberId判断会员是否存在。根据cardTypeId查出卡类型得到有效天数。计算endDate startDate durationDays。插入member_card记录。插入consume_record消费记录。续费的逻辑略有不同如果该会员已有一张有效的会员卡续费时应基于原到期时间往后延长而不是重新从当前时间开始计算。为了方便演示这里给出一个简化版的开卡 Service 代码// 文件路径src/main/java/com/example/gym/service/impl/CardServiceImpl.java package com.example.gym.service.impl; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.example.gym.entity.CardType; import com.example.gym.entity.ConsumeRecord; import com.example.gym.entity.MemberCard; import com.example.gym.mapper.CardTypeMapper; import com.example.gym.mapper.ConsumeRecordMapper; import com.example.gym.mapper.MemberCardMapper; import com.example.gym.mapper.MemberMapper; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.math.BigDecimal; import java.time.LocalDateTime; Service public class CardServiceImpl { Autowired private MemberCardMapper memberCardMapper; Autowired private CardTypeMapper cardTypeMapper; Autowired private MemberMapper memberMapper; Autowired private ConsumeRecordMapper consumeRecordMapper; Transactional(rollbackFor Exception.class) public boolean openCard(Long memberId, Long cardTypeId) { // 1. 校验会员和卡类型 if (memberMapper.selectById(memberId) null) { throw new RuntimeException(会员不存在); } CardType cardType cardTypeMapper.selectById(cardTypeId); if (cardType null || cardType.getIsActive() 0) { throw new RuntimeException(卡类型不存在或已停用); } // 2. 计算开卡时间与到期时间 LocalDateTime now LocalDateTime.now(); LocalDateTime endDate now.plusDays(cardType.getDurationDays()); // 3. 生成持卡记录 MemberCard memberCard new MemberCard(); memberCard.setMemberId(memberId); memberCard.setCardTypeId(cardTypeId); memberCard.setStartDate(now); memberCard.setEndDate(endDate); memberCard.setStatus(1); memberCardMapper.insert(memberCard); // 4. 写入消费记录 ConsumeRecord consumeRecord new ConsumeRecord(); consumeRecord.setMemberId(memberId); consumeRecord.setConsumeType(开卡); consumeRecord.setAmount(cardType.getPrice()); consumeRecord.setRemark(办理 cardType.getTypeName()); consumeRecordMapper.insert(consumeRecord); return true; } }需要注意的是Transactional(rollbackFor Exception.class)。它的作用是开启事务当插入持卡记录成功但插入消费记录失败时会回滚前面的操作避免出现“会员有卡但没消费记录”的数据不一致问题。如果做续费功能建议先查询当前会员最近一张状态正常的会员卡再判断endDate是否大于当前时间如果未到期则顺延如果已到期则从当前时间重新计算。4.10 会员到期状态查询会员是否到期是一个高频查询场景。可以通过 SQL 查询当前所有到期时间早于今天、状态仍为“正常”的会员也可以在 Java 中直接比较LocalDateTime。下面是一个基于 MyBatis-Plus 的查询示例// 查询已到期会员 LambdaQueryWrapperMemberCard wrapper new LambdaQueryWrapper(); wrapper.eq(MemberCard::getStatus, 1) .lt(MemberCard::getEndDate, LocalDateTime.now()); ListMemberCard expiredCards memberCardMapper.selectList(wrapper);这种查询在定时任务或后台管理页面中很实用。可以在每天凌晨运行一个定时任务把到期会员的卡状态改为“已到期”并记录日志。5. 前台页面与接口联调说明这篇文章的编码重点是后端但如果你需要完成一个完整的前端页面可以选择下面任意一种方式方式一使用 Thymeleaf 模板引擎配合 Bootstrap 写一个简单的管理后台。方式二使用 Vue 2 Element UI搭建前后端分离项目。方式三先只完成后端接口再用 Postman/Apifox 调试最后根据答辩要求补充页面。对于大多数毕设来说不需要做得过于花哨。建议优先完成以下几个核心页面页面功能登录页管理员输入用户名密码登录会员列表页分页展示会员支持按姓名/手机号搜索会员新增/编辑页表单弹窗或独立页面会员开卡页选择会员、选择卡类型确认开卡课程列表页课程信息展示与维护预约管理页查看课程预约情况支持取消后端接口返回的Result统一结构能极大地方便前端处理数据。前端只需要判断code是否为 200再取data渲染即可。6. 常见问题与排查思路6.1 数据库连接失败现象项目启动时报Access denied for user rootlocalhost或Communications link failure。常见原因MySQL 服务没有启动。用户名或密码写错。数据库名不是gym_member。url中数据库地址或端口错误。排查步骤# 先测试 MySQL 是否能连接 mysql -uroot -p然后在application.yml中确认用户名、密码、数据库名是否正确。如果确认无误但仍失败检查 MySQL 端口是否为默认的 3306或者连接 URL 是否被其他配置覆盖。6.2 MyBatis-Plus 分页不生效现象查询能返回数据但分页返回的结果里total总是 0或所有记录一次性返回。原因没有配置分页插件PaginationInnerInterceptor。解决方案参考前文的MybatisPlusConfig配置类确保它被 Spring 扫描到。6.3 时间字段相差 8 小时现象存入数据库的时间比本地时间少 8 小时或页面显示的时间不对。原因MySQL 连接串没有设置serverTimezone或 Jackson 序列化时区与本地时区不一致。解决方案spring: datasource: url: jdbc:mysql://localhost:3306/gym_member?serverTimezoneAsia/Shanghai jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT86.4 中文乱码现象数据库插入中文后显示为???或接口返回中文乱码。原因数据库表字符集不是utf8mb4或连接串未指定characterEncodingutf8。解决方案建表时统一使用DEFAULT CHARSETutf8mb4连接串中增加characterEncodingutf8。IDEA 中还可以检查文件编码是否为 UTF-8。6.5 Maven 依赖下载缓慢或失败现象项目导入后一直卡在下载依赖或pom.xml中的依赖报红。解决方案在 Maven 的settings.xml中配置阿里云镜像mirror idaliyunmaven/id namealiyun maven mirror/name urlhttps://maven.aliyun.com/repository/public/url mirrorOfcentral/mirrorOf /mirror6.6 端口被占用现象启动时提示Port 8080 was already in use。解决方案关闭占用端口的进程或者在application.yml中修改端口。# Windows netstat -ano | findstr 8080 taskkill /PID 进程号 /F # Linux/Mac lsof -i :8080 kill -9 进程号7. 最佳实践与答辩建议7.1 开发阶段的最佳实践参数校验不能省新增或修改会员时手机号、姓名不能为空手机号格式要校验。可以使用 Spring 的Validated注解也可以自己写工具类判断。密码必须加密存储管理员密码不要明文存在数据库推荐使用BCryptPasswordEncoder。删除前先做关联检查删除会员前先检查该会员是否有未完成的预约记录或仍在有效期内的会员卡避免产生孤儿数据或业务冲突。重要操作保留日志开卡、续费、删除会员这类操作建议记录操作人和操作时间。接口路径使用 RESTful 风格GET /api/member/{id}、POST /api/member清晰易懂。全局异常处理使用RestControllerAdvice统一处理业务异常和系统异常避免把报错堆栈直接返回给前端。下面是一个简单的全局异常处理示例// 文件路径src/main/java/com/example/gym/common/GlobalExceptionHandler.java package com.example.gym.common; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(RuntimeException.class) public ResultString handleRuntimeException(RuntimeException e) { return Result.error(e.getMessage()); } ExceptionHandler(Exception.class) public ResultString handleException(Exception e) { return Result.error(系统异常请联系管理员); } }7.2 答辩高频问题与回答思路答辩老师通常会围绕“系统设计”和“业务细节”提问我整理了几个常见问题问题回答思路为什么选择 Spring Boot MyBatis-Plus快速搭建项目减少配置文件MyBatis-Plus 能提高单表 CRUD 开发效率。会员续费时如何计算到期时间先查询当前有效会员卡若未到期就把剩余天数累加到新到期时间上若已到期则从当天重新计算。系统中哪些地方用到了事务开卡操作会同时插入持卡记录和消费记录必须在一个事务中完成失败时回滚。如何防止用户重复预约同一课程在appointment表增加member_id和course_id的唯一约束或查询时先判断是否已存在预约记录。项目有哪些可以扩展的功能引入 Redis 缓存热门课程使用 ECharts 统计会员增长趋势和营收报表增加 JWT 登录鉴权。7.3 学习路线与后续提升如果你还没有完整掌握这个项目说明还需要加强以下几块知识Java 基础集合、Lambda、Stream、日期时间 API。MySQL 基础建表约束、索引、多表联查、事务隔离级别。Spring Boot 基础自动配置原理、常用注解、依赖注入。MyBatis-Plus 基础条件构造器、分页插件、逻辑删除、乐观锁。完成基础版后可以继续用这个项目练习给会员列表增加导出 Excel 功能。给登录模块换成 JWT Token 认证。使用 Redis 缓存高频查询的课程信息。增加定时任务每天自动扫描到期会员并发送提醒。这些功能都是 Java 项目实战中非常加分的点也是面试时能拉开差距的内容。8. 源码与数据库使用说明源码中需要重点关注的目录结构如下src/main/java/com/example/gym ├── common ├── config ├── controller ├── dto ├── entity ├── mapper └── service数据库初始化脚本位于src/main/resources/sql/gym_member.sql。拿到脚本后打开 Navicat 或命令行执行mysql -uroot -p gym_member.sql执行成功后在application.yml中修改数据库账号密码然后启动项目。启动日志中出现Started GymApplication即表示成功。接着使用 Postman 或浏览器访问GET http://localhost:8080/api/member/page?pageNum1pageSize10如果返回 JSON 数据中包含code: 200说明项目已经正常跑起来了。需要注意开源项目源码通常只包含基础功能。拿到源码后建议先完整阅读数据库脚本和 Service 层代码理解业务后再修改和扩展。不要直接照搬到答辩演示最好能加入自己的优化点比如增加了导出功能、图表统计或新的校验逻辑。9. 写在最后健身房会员管理系统是一个非常适合 Java 毕设和练手的项目它的核心价值不在于技术多新而在于完整覆盖了一个真实业务系统的开发流程需求分析、数据库建模、后端接口设计、业务规则落地。做完这个项目后你对 Spring Boot 和 MyBatis-Plus 的理解会扎实很多。动手实践时建议按顺序完成先建库建表再写实体类和 Mapper然后从简单的会员 CRUD 做起最后再实现开卡续费这种复杂业务。每一步都要实际运行验证遇到报错不要急着搜答案先看日志和堆栈信息这是提升 Java 水平最快的方式。如果你在搭建过程中遇到了任何问题可以在评论区留言我会尽量结合实际开发经验帮你分析。下一篇内容可以考虑继续深化这个项目比如加入 Redis 缓存、JWT 登录、Excel 导出或者前端 Vue 页面联调欢迎保持关注。 Spring Boot健身房会员管理系统设计与实现：从数据库到业务逻辑全解析
又到了毕业设计选题和 Java 项目练手的密集期。很多同学在后台问我想找一个功能适中、技术栈主流、能写进简历也能应付答辩的 JavaWeb 项目。挑来挑去健身房会员管理系统确实是一个很合适的选题。这类项目典型的业务场景是“会员 卡 课程 预约 消费记录”既没有电商系统那么复杂又比单纯的学生管理系统更有业务深度。数据表之间有清晰的关联关系代码能覆盖增删改查、分页搜索、事务处理、时间到期判断等常见开发场景用来巩固 Java 基础、学习 Spring Boot 和 MySQL 实战非常合适。这篇文章我会按项目开发顺序来拆解从需求分析、数据库设计到核心代码实现再到常见报错排查和答辩准备建议。每个关键点都尽量解释清楚“为什么这么做”而不是只贴代码。1. 系统背景与需求分析1.1 健身房会员管理系统是什么健身房会员管理系统是一套面向中小型健身房的前台业务管理工具。核心目标是帮助健身房工作人员完成会员开卡、续费、课程预约、消费记录查询等日常工作让老板能及时掌握会员数量和经营收入情况。从开发角度看这个系统本质上是一个典型的信息管理系统数据模型以“会员”为中心围绕会员的办卡行为、上课行为和消费行为展开。相比网上常见的“学生管理系统”它的业务规则更多一些比如会员卡有有效期、续费要延长到期时间、私教课预约要扣减剩余课时这些规则能锻炼真实的业务建模能力。1.2 为什么适合做 Java 毕设或练手项目业务规模适中表数量控制在 6~8 张左右功能完整度高但又不至于像大型系统那样难以驾驭。技术栈主流可以完整使用 Spring Boot MyBatis-Plus MySQL 这套 Java 后端开发最常见的组合。答辩容易讲系统边界清晰模块划分直观面试官或答辩老师很容易理解你的项目价值。可扩展性强做完基础版后可以继续加 Redis 缓存、JWT 登录、Excel 导出、ECharts 统计图表等特性适合提升项目亮点。1.3 系统核心角色与用例在健身房管理系统中通常分为两种角色角色主要操作管理员/前台会员信息管理、会员卡办理、续费、课程管理、预约审核、查看营业统计会员查看个人信息、查看课程、预约私教课、查看自己的消费记录如果只做后端管理端会员端的功能可以简化为后台的查询与预约操作。如果是前后端分离项目还可以把会员端小程序或 H5 作为二期扩展。2. 技术选型与项目环境准备2.1 技术栈选择我采用的是一套比较稳妥的 Java 后端技术组合技术用途Java 8编程语言JDK 8 对大多数毕设和中小企业项目仍然足够稳定Spring Boot 2.x / 3.x后端基础框架自动配置快速构建独立应用MyBatis-PlusORM 框架简化单表增删改查提供分页插件MySQL 5.7 / 8.0关系型数据库存储业务数据Maven项目构建与依赖管理Lombok简化实体类代码Postman / Apifox接口调试与测试如果你本机 JDK 是 17 或更高版本建议优先使用 Spring Boot 3.x 版本但要注意 MyBatis-Plus 需要使用适配 Spring Boot 3 的版本例如mybatis-plus-spring-boot3-starter。2.2 环境检查清单开始写代码之前建议先确认开发环境java -version mvn -v mysql --version运行结果里能正常输出版本号即可。MySQL 需要提前启动服务并确保有权限创建数据库。如果你使用 Navicat、DataGrip 或 IDEA 自带的数据库工具可以直接通过工具创建数据库和导入 SQL 脚本。2.3 项目结构规划一个清晰的项目结构能帮助后续扩展和维护。本文采用经典的三层架构gym-member-system ├── pom.xml └── src/main ├── java/com/example/gym │ ├── GymApplication.java // Spring Boot 启动类 │ ├── controller/ // 控制层接收前端请求 │ ├── service/ // 业务层处理业务逻辑 │ ├── mapper/ // 数据访问层数据库操作 │ ├── entity/ // 实体类对应数据库表 │ ├── dto/ // 数据传输对象 │ ├── common/ // 统一返回结果、异常处理等 │ └── config/ // 配置类如 MyBatis-Plus 配置 └── resources ├── application.yml // 应用配置 └── sql/gym_member.sql // 数据库初始化脚本3. 数据库设计与建表 SQL数据库设计是健身房会员管理系统最关键的一步。表结构如果设计得不合理后面写代码会非常痛苦。3.1 核心表设计我建议至少设计以下 6 张表表名说明核心字段member会员基本信息表id、name、phone、gender、birthday、create_timecard_type会员卡类型表id、type_name、duration_days、price、is_activemember_card会员持卡表id、member_id、card_type_id、start_date、end_date、statuscourse课程表id、course_name、course_type、teacher、class_time、max_peopleappointment预约记录表id、member_id、course_id、appointment_time、statusconsume_record消费记录表id、member_id、consume_type、amount、remark、create_time如果需要登录功能可以额外增加一张admin_user管理员表。如果涉及私教课时扣减可以在member_card或单独private_course_record表中增加课时数字段。3.2 建表 SQL 示例下面提供一个完整可执行的 SQL 脚本。实际使用时可先创建gym_member数据库然后导入该脚本。CREATE DATABASE IF NOT EXISTS gym_member DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE gym_member; -- 会员表 CREATE TABLE member ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 会员ID, name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) NOT NULL UNIQUE COMMENT 手机号, gender TINYINT DEFAULT 0 COMMENT 性别0未知 1男 2女, birthday DATE COMMENT 生日, address VARCHAR(255) COMMENT 住址, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员信息表; -- 会员卡类型表 CREATE TABLE card_type ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 卡类型ID, type_name VARCHAR(50) NOT NULL COMMENT 卡名称如季卡、年卡, duration_days INT NOT NULL COMMENT 有效天数, price DECIMAL(10,2) NOT NULL COMMENT 价格, is_active TINYINT DEFAULT 1 COMMENT 是否启用1启用 0停用 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员卡类型表; -- 会员持卡表 CREATE TABLE member_card ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 持卡记录ID, member_id BIGINT NOT NULL COMMENT 会员ID, card_type_id BIGINT NOT NULL COMMENT 卡类型ID, start_date DATETIME NOT NULL COMMENT 开卡时间, end_date DATETIME NOT NULL COMMENT 到期时间, status TINYINT DEFAULT 1 COMMENT 状态1正常 0停用, remark VARCHAR(255) COMMENT 备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT会员持卡表; -- 课程表 CREATE TABLE course ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 课程ID, course_name VARCHAR(100) NOT NULL COMMENT 课程名称, course_type VARCHAR(50) COMMENT 课程类型如瑜伽、动感单车, teacher VARCHAR(50) COMMENT 教练, class_time VARCHAR(50) COMMENT 上课时间描述, max_people INT DEFAULT 20 COMMENT 最大人数 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT课程表; -- 预约记录表 CREATE TABLE appointment ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 预约ID, member_id BIGINT NOT NULL COMMENT 会员ID, course_id BIGINT NOT NULL COMMENT 课程ID, appointment_time DATETIME NOT NULL COMMENT 预约时间, status TINYINT DEFAULT 0 COMMENT 状态0已预约 1已取消 2已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT预约记录表; -- 消费记录表 CREATE TABLE consume_record ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 消费ID, member_id BIGINT NOT NULL COMMENT 会员ID, consume_type VARCHAR(50) NOT NULL COMMENT 消费类型开卡、续费、私教课, amount DECIMAL(10,2) NOT NULL COMMENT 消费金额, remark VARCHAR(255) COMMENT 备注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 消费时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT消费记录表; -- 管理员表 CREATE TABLE admin_user ( id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 管理员ID, username VARCHAR(50) NOT NULL UNIQUE COMMENT 用户名, password VARCHAR(100) NOT NULL COMMENT 密码BCrypt加密, real_name VARCHAR(50) COMMENT 姓名, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT管理员表; -- 插入默认管理员密码为 123456 的 BCrypt 加密结果 INSERT INTO admin_user (username, password, real_name) VALUES (admin, $2a$10$D8mR1mHUdF0nG5iK7zJzUO9vjP4QY7gQ1Y8m1wXtQy0vVKHh0w4ye, 系统管理员);在实际开发中会员表和会员卡表可以设计成一对多关系因为一个老会员可能在年卡到期后继续续费产生多条持卡记录。这样能保留历史数据方便后续统计复购率。3.3 表关系说明member与member_card一对多一个会员可以有多张卡记录。card_type与member_card一对多一个卡类型可被多个会员持有。member与appointment一对多。course与appointment一对多。member与consume_record一对多。这个模型是完整的“会员生命周期”管理思路开卡产生持卡记录和消费记录续费更新持卡到期时间并追加消费记录上课通过预约记录关联课程。4. 项目搭建与核心代码实现4.1 创建 Spring Boot 项目使用 IDEA 创建项目时选择Spring Initializr需要添加的依赖如下Spring WebMySQL DriverMyBatis-Plus 依赖需要手动添加Lombok如果是手动创建 Maven 项目请在pom.xml中引入下面的关键依赖版本号可以根据自己实际情况调整parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies !-- Web 支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MyBatis-Plus 启动器Spring Boot 2 版本 -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驱动 -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Lombok 简化实体类 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies如果你的环境是 Spring Boot 3.x那么 MyBatis-Plus 需要换成mybatis-plus-spring-boot3-starter。这个差异是很多同学第一次启动就报错的主要原因需要特别留意。4.2 配置 application.yml在src/main/resources目录下创建application.yml配置数据源和 MyBatis-Plus 相关参数server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/gym_member?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: 123456 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0map-underscore-to-camel-case的作用是把数据库的create_time字段自动映射为实体类的createTime这样写代码时不需要每次手动指定映射关系。serverTimezoneAsia/Shanghai可以解决 MySQL 8.x 连接时的时区问题避免数据库时间和本地时间相差 8 小时。4.3 编写实体类以Member实体类为例使用 Lombok 简化 getter/setter// 文件路径src/main/java/com/example/gym/entity/Member.java package com.example.gym.entity; import com.baomidou.mybatisplus.annotation.IdType; import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; import java.time.LocalDateTime; Data TableName(member) public class Member { TableId(type IdType.AUTO) private Long id; private String name; private String phone; private Integer gender; private String birthday; private String address; private LocalDateTime createTime; private LocalDateTime updateTime; }TableName用于指定实体类对应的数据库表。TableId(type IdType.AUTO)表示主键自增。其他实体类如CardType、MemberCard、Course、Appointment、ConsumeRecord的写法类似。4.4 编写 Mapper 接口MyBatis-Plus 的 Mapper 接口只需继承BaseMapperT就能获得单表的增删改查能力// 文件路径src/main/java/com/example/gym/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 public interface MemberMapper extends BaseMapperMember { }如果需要编写自定义 SQL比如联表查询会员卡信息可以在接口中增加方法并配合Select注解或 XML 文件实现。4.5 统一返回结果类为了让前端或接口调用方拿到统一格式的数据建议定义一个通用的返回结构// 文件路径src/main/java/com/example/gym/common/Result.java package com.example.gym.common; import lombok.Data; Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(操作成功); result.setData(data); return result; } public static T ResultT error(String message) { ResultT result new Result(); result.setCode(500); result.setMessage(message); return result; } }4.6 Service 层实现会员管理先定义接口// 文件路径src/main/java/com/example/gym/service/MemberService.java package com.example.gym.service; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.example.gym.entity.Member; public interface MemberService { PageMember pageMembers(int pageNum, int pageSize, String name, String phone); Member getMemberById(Long id); boolean addMember(Member member); boolean updateMember(Member member); boolean deleteMember(Long id); }实现类// 文件路径src/main/java/com/example/gym/service/impl/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.example.gym.entity.Member; import com.example.gym.mapper.MemberMapper; import com.example.gym.service.MemberService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.util.StringUtils; Service public class MemberServiceImpl implements MemberService { Autowired private MemberMapper memberMapper; Override public PageMember pageMembers(int pageNum, int pageSize, String name, String phone) { PageMember page new Page(pageNum, pageSize); LambdaQueryWrapperMember wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(name)) { wrapper.like(Member::getName, name); } if (StringUtils.hasText(phone)) { wrapper.eq(Member::getPhone, phone); } wrapper.orderByDesc(Member::getCreateTime); return memberMapper.selectPage(page, wrapper); } Override public Member getMemberById(Long id) { return memberMapper.selectById(id); } Override public boolean addMember(Member member) { return memberMapper.insert(member) 0; } Override public boolean updateMember(Member member) { return memberMapper.updateById(member) 0; } Override public boolean deleteMember(Long id) { return memberMapper.deleteById(id) 0; } }这里的LambdaQueryWrapper是 MyBatis-Plus 提供的条件构造器用 Lambda 表达式引用实体字段避免硬编码数据库列名。如果字段改名或实体属性改名代码会有编译期提示。4.7 Controller 层暴露接口// 文件路径src/main/java/com/example/gym/controller/MemberController.java package com.example.gym.controller; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.example.gym.common.Result; import com.example.gym.entity.Member; import com.example.gym.service.MemberService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; RestController RequestMapping(/api/member) public class MemberController { Autowired private MemberService memberService; GetMapping(/page) public ResultPageMember page( RequestParam(defaultValue 1) int pageNum, RequestParam(defaultValue 10) int pageSize, RequestParam(required false) String name, RequestParam(required false) String phone) { return Result.success(memberService.pageMembers(pageNum, pageSize, name, phone)); } GetMapping(/{id}) public ResultMember getById(PathVariable Long id) { return Result.success(memberService.getMemberById(id)); } PostMapping public ResultBoolean add(RequestBody Member member) { return Result.success(memberService.addMember(member)); } PutMapping public ResultBoolean update(RequestBody Member member) { return Result.success(memberService.updateMember(member)); } DeleteMapping(/{id}) public ResultBoolean delete(PathVariable Long id) { return Result.success(memberService.deleteMember(id)); } }4.8 配置 MyBatis-Plus 分页插件如果直接使用selectPage而不配置分页插件分页功能不会生效这是新手最容易忽略的问题。需要新建一个配置类// 文件路径src/main/java/com/example/gym/config/MybatisPlusConfig.java package com.example.gym.config; import com.baomidou.mybatisplus.annotation.DbType; import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor; import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }4.9 会员开卡与续费业务逻辑健身房系统的业务核心不是单纯的增删改查而是“开卡”和“续费”这两个场景。开卡的逻辑是根据memberId判断会员是否存在。根据cardTypeId查出卡类型得到有效天数。计算endDate startDate durationDays。插入member_card记录。插入consume_record消费记录。续费的逻辑略有不同如果该会员已有一张有效的会员卡续费时应基于原到期时间往后延长而不是重新从当前时间开始计算。为了方便演示这里给出一个简化版的开卡 Service 代码// 文件路径src/main/java/com/example/gym/service/impl/CardServiceImpl.java package com.example.gym.service.impl; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.example.gym.entity.CardType; import com.example.gym.entity.ConsumeRecord; import com.example.gym.entity.MemberCard; import com.example.gym.mapper.CardTypeMapper; import com.example.gym.mapper.ConsumeRecordMapper; import com.example.gym.mapper.MemberCardMapper; import com.example.gym.mapper.MemberMapper; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.math.BigDecimal; import java.time.LocalDateTime; Service public class CardServiceImpl { Autowired private MemberCardMapper memberCardMapper; Autowired private CardTypeMapper cardTypeMapper; Autowired private MemberMapper memberMapper; Autowired private ConsumeRecordMapper consumeRecordMapper; Transactional(rollbackFor Exception.class) public boolean openCard(Long memberId, Long cardTypeId) { // 1. 校验会员和卡类型 if (memberMapper.selectById(memberId) null) { throw new RuntimeException(会员不存在); } CardType cardType cardTypeMapper.selectById(cardTypeId); if (cardType null || cardType.getIsActive() 0) { throw new RuntimeException(卡类型不存在或已停用); } // 2. 计算开卡时间与到期时间 LocalDateTime now LocalDateTime.now(); LocalDateTime endDate now.plusDays(cardType.getDurationDays()); // 3. 生成持卡记录 MemberCard memberCard new MemberCard(); memberCard.setMemberId(memberId); memberCard.setCardTypeId(cardTypeId); memberCard.setStartDate(now); memberCard.setEndDate(endDate); memberCard.setStatus(1); memberCardMapper.insert(memberCard); // 4. 写入消费记录 ConsumeRecord consumeRecord new ConsumeRecord(); consumeRecord.setMemberId(memberId); consumeRecord.setConsumeType(开卡); consumeRecord.setAmount(cardType.getPrice()); consumeRecord.setRemark(办理 cardType.getTypeName()); consumeRecordMapper.insert(consumeRecord); return true; } }需要注意的是Transactional(rollbackFor Exception.class)。它的作用是开启事务当插入持卡记录成功但插入消费记录失败时会回滚前面的操作避免出现“会员有卡但没消费记录”的数据不一致问题。如果做续费功能建议先查询当前会员最近一张状态正常的会员卡再判断endDate是否大于当前时间如果未到期则顺延如果已到期则从当前时间重新计算。4.10 会员到期状态查询会员是否到期是一个高频查询场景。可以通过 SQL 查询当前所有到期时间早于今天、状态仍为“正常”的会员也可以在 Java 中直接比较LocalDateTime。下面是一个基于 MyBatis-Plus 的查询示例// 查询已到期会员 LambdaQueryWrapperMemberCard wrapper new LambdaQueryWrapper(); wrapper.eq(MemberCard::getStatus, 1) .lt(MemberCard::getEndDate, LocalDateTime.now()); ListMemberCard expiredCards memberCardMapper.selectList(wrapper);这种查询在定时任务或后台管理页面中很实用。可以在每天凌晨运行一个定时任务把到期会员的卡状态改为“已到期”并记录日志。5. 前台页面与接口联调说明这篇文章的编码重点是后端但如果你需要完成一个完整的前端页面可以选择下面任意一种方式方式一使用 Thymeleaf 模板引擎配合 Bootstrap 写一个简单的管理后台。方式二使用 Vue 2 Element UI搭建前后端分离项目。方式三先只完成后端接口再用 Postman/Apifox 调试最后根据答辩要求补充页面。对于大多数毕设来说不需要做得过于花哨。建议优先完成以下几个核心页面页面功能登录页管理员输入用户名密码登录会员列表页分页展示会员支持按姓名/手机号搜索会员新增/编辑页表单弹窗或独立页面会员开卡页选择会员、选择卡类型确认开卡课程列表页课程信息展示与维护预约管理页查看课程预约情况支持取消后端接口返回的Result统一结构能极大地方便前端处理数据。前端只需要判断code是否为 200再取data渲染即可。6. 常见问题与排查思路6.1 数据库连接失败现象项目启动时报Access denied for user rootlocalhost或Communications link failure。常见原因MySQL 服务没有启动。用户名或密码写错。数据库名不是gym_member。url中数据库地址或端口错误。排查步骤# 先测试 MySQL 是否能连接 mysql -uroot -p然后在application.yml中确认用户名、密码、数据库名是否正确。如果确认无误但仍失败检查 MySQL 端口是否为默认的 3306或者连接 URL 是否被其他配置覆盖。6.2 MyBatis-Plus 分页不生效现象查询能返回数据但分页返回的结果里total总是 0或所有记录一次性返回。原因没有配置分页插件PaginationInnerInterceptor。解决方案参考前文的MybatisPlusConfig配置类确保它被 Spring 扫描到。6.3 时间字段相差 8 小时现象存入数据库的时间比本地时间少 8 小时或页面显示的时间不对。原因MySQL 连接串没有设置serverTimezone或 Jackson 序列化时区与本地时区不一致。解决方案spring: datasource: url: jdbc:mysql://localhost:3306/gym_member?serverTimezoneAsia/Shanghai jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT86.4 中文乱码现象数据库插入中文后显示为???或接口返回中文乱码。原因数据库表字符集不是utf8mb4或连接串未指定characterEncodingutf8。解决方案建表时统一使用DEFAULT CHARSETutf8mb4连接串中增加characterEncodingutf8。IDEA 中还可以检查文件编码是否为 UTF-8。6.5 Maven 依赖下载缓慢或失败现象项目导入后一直卡在下载依赖或pom.xml中的依赖报红。解决方案在 Maven 的settings.xml中配置阿里云镜像mirror idaliyunmaven/id namealiyun maven mirror/name urlhttps://maven.aliyun.com/repository/public/url mirrorOfcentral/mirrorOf /mirror6.6 端口被占用现象启动时提示Port 8080 was already in use。解决方案关闭占用端口的进程或者在application.yml中修改端口。# Windows netstat -ano | findstr 8080 taskkill /PID 进程号 /F # Linux/Mac lsof -i :8080 kill -9 进程号7. 最佳实践与答辩建议7.1 开发阶段的最佳实践参数校验不能省新增或修改会员时手机号、姓名不能为空手机号格式要校验。可以使用 Spring 的Validated注解也可以自己写工具类判断。密码必须加密存储管理员密码不要明文存在数据库推荐使用BCryptPasswordEncoder。删除前先做关联检查删除会员前先检查该会员是否有未完成的预约记录或仍在有效期内的会员卡避免产生孤儿数据或业务冲突。重要操作保留日志开卡、续费、删除会员这类操作建议记录操作人和操作时间。接口路径使用 RESTful 风格GET /api/member/{id}、POST /api/member清晰易懂。全局异常处理使用RestControllerAdvice统一处理业务异常和系统异常避免把报错堆栈直接返回给前端。下面是一个简单的全局异常处理示例// 文件路径src/main/java/com/example/gym/common/GlobalExceptionHandler.java package com.example.gym.common; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(RuntimeException.class) public ResultString handleRuntimeException(RuntimeException e) { return Result.error(e.getMessage()); } ExceptionHandler(Exception.class) public ResultString handleException(Exception e) { return Result.error(系统异常请联系管理员); } }7.2 答辩高频问题与回答思路答辩老师通常会围绕“系统设计”和“业务细节”提问我整理了几个常见问题问题回答思路为什么选择 Spring Boot MyBatis-Plus快速搭建项目减少配置文件MyBatis-Plus 能提高单表 CRUD 开发效率。会员续费时如何计算到期时间先查询当前有效会员卡若未到期就把剩余天数累加到新到期时间上若已到期则从当天重新计算。系统中哪些地方用到了事务开卡操作会同时插入持卡记录和消费记录必须在一个事务中完成失败时回滚。如何防止用户重复预约同一课程在appointment表增加member_id和course_id的唯一约束或查询时先判断是否已存在预约记录。项目有哪些可以扩展的功能引入 Redis 缓存热门课程使用 ECharts 统计会员增长趋势和营收报表增加 JWT 登录鉴权。7.3 学习路线与后续提升如果你还没有完整掌握这个项目说明还需要加强以下几块知识Java 基础集合、Lambda、Stream、日期时间 API。MySQL 基础建表约束、索引、多表联查、事务隔离级别。Spring Boot 基础自动配置原理、常用注解、依赖注入。MyBatis-Plus 基础条件构造器、分页插件、逻辑删除、乐观锁。完成基础版后可以继续用这个项目练习给会员列表增加导出 Excel 功能。给登录模块换成 JWT Token 认证。使用 Redis 缓存高频查询的课程信息。增加定时任务每天自动扫描到期会员并发送提醒。这些功能都是 Java 项目实战中非常加分的点也是面试时能拉开差距的内容。8. 源码与数据库使用说明源码中需要重点关注的目录结构如下src/main/java/com/example/gym ├── common ├── config ├── controller ├── dto ├── entity ├── mapper └── service数据库初始化脚本位于src/main/resources/sql/gym_member.sql。拿到脚本后打开 Navicat 或命令行执行mysql -uroot -p gym_member.sql执行成功后在application.yml中修改数据库账号密码然后启动项目。启动日志中出现Started GymApplication即表示成功。接着使用 Postman 或浏览器访问GET http://localhost:8080/api/member/page?pageNum1pageSize10如果返回 JSON 数据中包含code: 200说明项目已经正常跑起来了。需要注意开源项目源码通常只包含基础功能。拿到源码后建议先完整阅读数据库脚本和 Service 层代码理解业务后再修改和扩展。不要直接照搬到答辩演示最好能加入自己的优化点比如增加了导出功能、图表统计或新的校验逻辑。9. 写在最后健身房会员管理系统是一个非常适合 Java 毕设和练手的项目它的核心价值不在于技术多新而在于完整覆盖了一个真实业务系统的开发流程需求分析、数据库建模、后端接口设计、业务规则落地。做完这个项目后你对 Spring Boot 和 MyBatis-Plus 的理解会扎实很多。动手实践时建议按顺序完成先建库建表再写实体类和 Mapper然后从简单的会员 CRUD 做起最后再实现开卡续费这种复杂业务。每一步都要实际运行验证遇到报错不要急着搜答案先看日志和堆栈信息这是提升 Java 水平最快的方式。如果你在搭建过程中遇到了任何问题可以在评论区留言我会尽量结合实际开发经验帮你分析。下一篇内容可以考虑继续深化这个项目比如加入 Redis 缓存、JWT 登录、Excel 导出或者前端 Vue 页面联调欢迎保持关注。