简介面向计算机毕业设计、课程设计及Java毕设场景这是一套基于SSMSpringSpringMVCMyBatis框架的健身房管理系统完整源码与数据库配套资料。系统围绕健身房日常运营设计提供登录/退出、账号管理、教练管理、健身器材管理、课程管理、健身房信息管理、会员卡管理等核心模块覆盖管理员、会员、教练、访客等多类角色的差异化操作管理员可维护账号、教练、器材、课程、门店及会员卡数据会员和教练也能在相应范围内自助修改信息。数据库采用MySQL并随附SQL脚本项目结构完整拿到后即可在本地部署运行或二次扩展适合用于毕业设计答辩、课程设计提交以及SSM整合开发入门参考。资源共2个文件主要文件类型为SSM工程源码zip与数据库脚本sql整体打包约54.9MB便于对照导入和快速启动。目前已有92人学习/下载可作为搭建健身房管理网站、理解SSM分层与角色权限设计的具体参考。1. 基于SSM的健身房管理系统先搞清楚它要管什么再谈源码和数据库一提到基于SSM的健身房管理系统很多人的第一反应是“又是一个毕业设计课题”。但真正落地时你会发现难点从来不是Spring、SpringMVC、MyBatis怎么搭而是会员开卡、私教预约、课程签到、器材报修这些业务状态之间怎么串起来数据库表怎么设计才不留下烂账。这个系统解决的是健身房前台还在用Excel记人、用本子约课的混乱状态会员到期没人提醒、教练排课冲突没人发现、月底统计收入全靠口算。它适合有Java Web基础、想把SSM整条链路走一遍的开发者也适合需要给小型健身房做内部管理后台的人。把源码和数据库脚本拿到手只是开始真正需要的是理解模块边界和数据流向否则改两行需求就会崩。2. 系统模块与数据库设计从会员卡到私教预约的字段怎么落2.1 先把业务边界画出来前台、会员、教练各要什么不要一上来就打开Navicat建表。我一般会拿一张白纸把一个真实健身房的工作流走一遍前台登记会员、推荐卡种、收款开卡会员凭卡到店、约私教、上团课教练查看当天课表、做签到店长关心这个月卖了多少卡、续费率多少、哪些器材该报修了。走到这一步系统模块自然分成六个系统用户登录、会员卡种、会员档案、课程与预约、器材报修、统计报表。这里面最容易被忽略的是“操作日志”。比如前台把会员手机号改了、教练把某节课的时间调了如果业务表里没有留下修订痕迹后期对账时根本说不清楚。我的做法是在每次状态变更时往一张operation_log表里写一条记录字段只要log_id, target_type, target_id, operate_user, action, create_time五个字段成本很低但排查问题时非常有用。下面的表结构是实际项目中最常见的剪枝版。完整项目中还会有字段如remark、create_by但核心表就这几张表名作用关键字段sys_user系统登录账号user_id, username, password, role_id, statusmember会员档案member_id, member_name, phone, id_card, birthdaycard_type卡种定义card_type_id, type_name, duration_month, price, total_timesmember_card会员购卡记录record_id, member_id, card_type_id, start_date, end_date, statuscoach教练信息coach_id, coach_name, phone, major, onboard_datecourse课程表course_id, course_name, coach_id, start_time, end_time, max_peoplecourse_booking课程预约记录booking_id, course_id, member_id, booking_time, statusequipment_repair器材报修repair_id, equipment_name, fault_desc, report_time, status2.2 会员和卡种别把购卡记录直接塞进会员表很多简化版的健身房系统会把card_type_id和expire_date直接写在member表里。初看很省事但会员第二次续卡时怎么办把原来的到期时间覆盖掉等于扔掉了一条历史购买记录。等到月底统计“本月续卡人数”时你只能用当前会员表里那些card_type_id和当前日期比较数据一塌糊涂。正确的做法是拆成“会员档案”和“购卡记录”两张表。member表只存这个人是谁member_card表记录每一次买卡一个会员可以有多个member_card记录其中一条状态为“生效中”。这样续卡时只需要把旧记录置为“已过期”插入一条新记录历史数据完整后续统计也清晰。建表SQL里尤其要注意expire_date推荐用date而不是datetime因为卡种到期只关心到哪一天带时分秒反而会在“当天是否生效”的判断上多写一堆边界逻辑。下面是剪枝后的建表脚本我会在db/01_schema.sql里按顺序执行。CREATE TABLE card_type ( card_type_id INT NOT NULL AUTO_INCREMENT, type_name VARCHAR(50) NOT NULL COMMENT 卡种名称如季卡年卡, duration_month INT NOT NULL COMMENT 有效期月数, price DECIMAL(10, 2) NOT NULL, total_times INT DEFAULT NULL COMMENT 次数卡的总次数不限次数则NULL, PRIMARY KEY (card_type_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE member_card ( record_id INT NOT NULL AUTO_INCREMENT, member_id INT NOT NULL, card_type_id INT NOT NULL, start_date DATE NOT NULL, end_date DATE NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1生效中 2已过期 3已退卡, PRIMARY KEY (record_id), KEY idx_member (member_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段建表逻辑里status是 TINYINT 而不是 VARCHAR原因是状态码方便程序里做枚举映射也方便数据库层做索引如果写成“生效中”“已过期”统计 SQL 还得先做字符串匹配性能差且容易写错。member_id上加普通索引是为了让“查某个会员的所有购卡记录”不用走全表扫描。实际项目中我还会加一个create_time DATETIME字段用于记录开卡时间这个字段到期提醒和续费分析都能用上。2.3 私教预约与课程排期用唯一约束挡住重复预约私教预约是整个系统里最容易出并发问题的模块。教练 A 在周六 10:00 有课两个会员同时在 9:59 提交预约如果代码里只做了“先查后插”极可能两个请求都看到“该时间段无预约”然后同时插入成功导致教练同时见两个会员。最常见的防线是在数据库层建立唯一约束UNIQUE KEY uk_coach_time (coach_id, start_time)。这样无论并发请求怎么跑数据库只会允许一条插入成功第二条直接撞唯一键程序拿到DuplicateKeyException后给会员提示“该时段已被预约请换时间”。这是用数据库兜底比纯靠 synchronized 或分布式锁可靠得多。CREATE TABLE personal_training_booking ( booking_id INT NOT NULL AUTO_INCREMENT, member_id INT NOT NULL, coach_id INT NOT NULL, training_date DATE NOT NULL, start_time TIME NOT NULL, end_time TIME NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1已预约 2已完成 3已取消, PRIMARY KEY (booking_id), UNIQUE KEY uk_coach_time (coach_id, training_date, start_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意唯一约束里我加了training_date这是因为教练每天都有 10:00 这个时段不能只约束coach_id start_time否则第二天 10:00 也约不进去。end_time不要实际存储也可以但存下来的好处是生成教练课表时不用再根据课程时长推算。另一种方案是用datetime存起始时间直接比较区间是否重叠但 SQL 写起来更复杂不如把时间段拆成日期加时间两个字段配合唯一约束更直观。2.4 数据库脚本的组织方式字符集和顺序都不能省源码包里一般会带 SQL 脚本但很多人拿到后直接全选执行最后中文乱码或者外键报错。我的习惯是把脚本拆成01_schema.sql、02_data.sql并且在每个建表语句里显式指定ENGINEInnoDB DEFAULT CHARSETutf8mb4。如果你用 Navicat 导出的脚本字符集可能还是latin1执行到中文注释时会直接报错。mysql -u root -p -e CREATE DATABASE IF NOT EXISTS gym_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p gym_db db/01_schema.sql mysql -u root -p gym_db db/02_data.sql这段命令先建库再导表结构和初始化数据。如果直接mysql 01_schema.sql而库里还挂着旧表你可能会遇到table already exists。所以强烈建议加DROP TABLE IF EXISTS放在每个建表语句前面或者执行前先清空库。另外COLLATE utf8mb4_general_ci这个排序规则适合中文业务场景比较字符串时忽略大小写查询“张”和“zhang”不会因为在不同字符集里而匹配不上。3. 用SSM搭起核心骨架配置文件的顺序与三个“能不能”校验3.1 项目结构与Maven依赖少了任何一个依赖都会翻车SSM 项目的标准目录是src/main/java放包src/main/resources放配置文件src/main/webapp放 JSP 和静态资源。如果你是用 Maven 从零建的模型一定把依赖写全。很多团队项目翻车不是因为代码而是因为pom.xml里漏了spring-jdbc导致容器启动时找不到JdbcTemplate相关的类。我这里给出一个经过多次验证的依赖组合Spring 版本锁定 5.2.xMyBatis 用 3.5.xmybatis-spring 用 2.0.x这套组合和 Tomcat 8/9 都能稳定工作。依赖之间版本冲突是 SSM 初学者的噩梦建议不要盲目追新也不要用 4.0 以下的旧 Spring。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.6/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.25/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.8/version /dependency /dependencies这里最关键的参数是mybatis-spring的版本如果你用 MyBatis 3.5.x 却配了 mybatis-spring 1.3.x启动时会直接报TypeException因为两个版本的兼容接口变了。第二个注意点是mysql-connector-java用了 8.x那数据库连接 URL 里的驱动类名必须是com.mysql.cj.jdbc.Driver而不是老项目里的com.mysql.jdbc.Driver。这个细节会让很多人卡在启动第一步。3.2 数据库连接参数五个参数决定系统能不能起来SSM 系统的第一道门槛是数据库连接。很多系统部署后启动失败报出Access denied for user rootlocalhost或者Server returns invalid timezone八成是jdbc.properties没写对。我的默认模板里固定有下面这些参数部署时只需要换用户名密码和库名。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/gym_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8allowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password123456 jdbc.initialSize5 jdbc.maxActive20注意 URL 里的serverTimezoneAsia/Shanghai是 MySQL 8 驱动必加的参数否则会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。useSSLfalse避免本地开发时自签名证书的警告铺满控制台。characterEncodingutf8一定要放在 URL 参数里光在建表时指定 utf8mb4 还不够。allowPublicKeyRetrievaltrue也是 MySQL 8 外加的因为默认不允许从服务器获取公钥某些连接工具会报连接失败。initialSize和maxActive是 Druid 连接池的参数。initialSize5表示启动时就预创建 5 个连接适合后台管理系统这种不需要瞬时高并发的场景maxActive20是连接池上限前提是 MySQL 的max_connections默认 151够用。如果健身房高峰期同时操作人数多可以适当调高但别超过数据库上限否则反而会拖垮 MySQL。3.3 Spring与MyBatis整合的三个“能不能”Spring 和 MyBatis 整合的核心是applicationContext.xml。这个文件负责数据源、SqlSessionFactory、Mapper 扫描。我见过太多配置错误最典型的是basePackage扫的包不对导致 Mapper 接口永远注入不进去。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ property nameinitialSize value${jdbc.initialSize}/ property namemaxActive value${jdbc.maxActive}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ property nametypeAliasesPackage valuecom.example.gym.entity/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.gym.mapper/ /bean配置完之后启动项目前可以自己问三个“能不能”第一能不能在com.example.gym.mapper包下找到所有 Mapper 接口第二能不能在classpath:mapper/下找到对应的 XML 文件第三XML 里的namespace能不能精确到接口全限定名这三个问题只要有一个是“不能”MyBatis 就会给你一堆莫名其妙的绑定异常。这里有个参数容易踩坑mapperLocations写成classpath:mapper/*.xml时如果你的 mapper 目录在resources/mapper下没问题但如果你把 XML 放到了java目录下Maven 默认打包时不会包含 XML运行时就报Invalid bound statement (not found)。解决方法是把 XML 放到resources/mapper或者在pom.xml里显式配置resources节点把 XML 也打进去。3.4 SpringMVC的controller扫描与静态资源放行spring-mvc.xml只管 controller 和视图解析不要在这里再扫描 service 和 mapper否则 Spring 容器会加载两份同名 Bean产生事务注解不生效的玄学问题。我一般用下面的配置。context:component-scan base-packagecom.example.gym.controller/ mvc:annotation-driven/ mvc:resources mapping/static/** location/static// bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean这里的关键是mvc:annotation-driven/必须保留否则RequestMapping不生效。base-package只扫controller避免把Service和Repository也扫进 MVC 容器。静态资源放行是因为 JSP 页面里要引 CSS、JS如果被 DispatcherServlet 拦截样式就全部丢失。视图解析器的prefix和suffix让 controller 返回member/list时自动找到/WEB-INF/views/member/list.jsp这样用户不能直接访问 JSP安全性好一些。4. 业务代码背后的关键参数分页、事务和状态机的设定4.1 分页插件PageHelper的3个必调参数后台管理的会员列表、课程列表必须要分页不然数据量一上来页面卡死。SSM 里最省心的分页方案是 PageHelper。这个插件会在 MyBatis 执行查询前拦截 SQL自动拼上limit所以你只需要在 Service 方法里调用PageHelper.startPage(pageNum, pageSize)后紧跟一条查询即可。public PageResultMember listMembers(int pageNum, int pageSize) { PageHelper.startPage(pageNum, pageSize); ListMember members memberMapper.selectAll(); PageInfoMember pageInfo new PageInfo(members); PageResultMember result new PageResult(); result.setList(pageInfo.getList()); result.setTotal(pageInfo.getTotal()); result.setPageNum(pageInfo.getPageNum()); result.setPageSize(pageInfo.getPageSize()); return result; }这段代码里PageHelper.startPage后面只能跟第一条mapper.selectAll()中间不能再插入其他查询否则分页会“串台”。三个必调参数是在 MyBatis 全局配置里设置helperDialectmysql指定数据库方言reasonabletrue表示 pageNum 如果超过总页数就自动纠正到最后一页如果小于 1 就纠正到第一页避免前端传个 -1 导致 SQL 里limit -1报错supportMethodsArgumentstrue允许从 Mapper 方法参数里直接取分页参数减少手动调 startPage 的重复代码。我在真实项目里还会要求pageSize必须小于等于 100防止有人恶意传 10000 把整张表拉出去。你可以在 controller 层做一层参数校验pageSize Math.min(pageSize, 100)。这个看起来简单但能避免很多不必要的数据库压力。4.2 事务的处理开卡和更新卡状态必须要一起成功业务里最典型的事务场景是会员开卡需要在member_card插入一条购卡记录同时把member表里的card_status更新为正常。如果第一步成功、第二步失败前台会告诉会员“开卡成功”但实际上会员状态没变导致会员卡用不了。这种脏数据是最难排查的。Service public class MemberCardService { Autowired private MemberCardMapper cardMapper; Autowired private MemberMapper memberMapper; Transactional(rollbackFor Exception.class) public void openCard(MemberCardAddDTO dto) { MemberCard card new MemberCard(); card.setMemberId(dto.getMemberId()); card.setCardTypeId(dto.getCardTypeId()); card.setStartDate(new Date()); card.setEndDate(DateUtils.addMonths(new Date(), dto.getDurationMonth())); card.setStatus(1); cardMapper.insert(card); Member member new Member(); member.setMemberId(dto.getMemberId()); member.setCardStatus(1); memberMapper.updateById(member); } }需要特别强调的是Transactional(rollbackFor Exception.class)。Spring 默认只对RuntimeException回滚如果你在方法里抛出了一个自定义的BusinessException而这个异常继承的是Exception没有指定rollbackFor那事务不会回滚数据库里就留下半条脏数据。这是很多“加了事务但还是多了一条记录”问题的根源。事务注解应该放在 Service 实现类的方法上而不是 Controller 的 Action 方法上。Controller 负责参数绑定和页面跳转如果它在事务里做太多无关操作会拉长数据库连接的占用时间。另外同一个类中方法直接调用另一个Transactional方法时事务注解不会生效因为走的是this调用而不是代理对象所以不要在 Service 里自己调自己。4.3 会员状态机用状态码而不是if-else煮成一锅粥会员卡的状态不是简单的 0 和 1至少包括1 正常、2 已过期、3 已停用、4 已注销。很多系统用字符串“正常”“过期”直接怼到页面上看起来直观但统计 SQL 时非常憋屈。更好的方式是数据库存 TINYINT 状态码Java 里用枚举统一管理。public enum MemberCardStatus { ACTIVE(1, 正常), EXPIRED(2, 已过期), DISABLED(3, 已停用), WITHDRAWN(4, 已注销); private final int code; private final String desc; MemberCardStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } public String getDesc() { return desc; } }状态流转是后期最容易改崩的地方。比如一张“已注销”的卡能不能直接续费变成“正常”从运营逻辑上讲应该不允许用户必须先“重新开通”或者“恢复档案”。“停用”的卡能不能约私教也不应该。把这些规则集中到一个状态机类里而不是散落在各个 Service 里后续维护才轻松。public static MemberCardStatus nextForRenew(MemberCardStatus current) { if (current EXPIRED || current DISABLED) { return ACTIVE; } throw new BusinessException(当前状态不支持续卡); }这段代码把“哪些状态可以续卡”收敛到了一个方法里。如果你看到 Service 里到处写if (正常.equals(member.getCardStatus()))那后面改需求时基本要血泪重写。状态机的好处在于新增一个“挂失”状态时你只需要在枚举中添加再在状态机类里明确从哪些状态可以进入其他调用点都不需要动。这就是状态码比字符串更可靠的原因。5. SSM健身房管理系统部署与排查从Tomcat到数据库连接的5个常见坑5.1 环境与依赖类Tomcat一启动就报ClassNotFound现象项目打包成 war 丢到 Tomcat webapps 下启动马上抛出ClassNotFoundException: org.springframework.web.context.ContextLoaderListener或者找不到 Druid 数据源类。原因war 包里的WEB-INF/lib没有依赖 jar常见于 IDEA 里直接 build artifact 时没有把 Maven 依赖一起打进去。配置文件里的 Bean 初始化找不到类自然启动失败。解决检查 Project Structure → Artifacts → Output Layout确保lib目录下包含了所有依赖。也可以用 Maven 打 war 包mvn clean package这样依赖会自动进WEB-INF/lib。以后部署后先看一眼 war 大小如果只有几百 KB说明 lib 没打进去别急着改代码。5.2 数据库连接失败Access denied和时区错误现象启动时控制台报Access denied for user rootlocalhost或者Cannot create PoolableConnectionFactory (The server time zone value ...)。原因密码不对是第一个密码对了但 URL 里没有serverTimezone是第二个。MySQL 8 驱动强制要求时区参数老驱动不需要所以很多旧代码换驱动版本后就踩坑。解决先用命令行测试mysql -u root -p -h localhost -P 3306 gym_db确认密码能连上库。然后检查jdbc.properties中jdbc.url是否包含serverTimezoneAsia/ShanghaiuseSSLfalsecharacterEncodingutf8。另外如果密码里带有或#等特殊字符在 properties 文件中需要转义或直接用 XML 的![CDATA[]]包起来否则参数会被截断。5.3 中文乱码页面正常但数据库里是问号现象前台填写的会员姓名存入 MySQL 后变成???查询出来也是问号。原因三处不一致页面编码、数据库表字符集、JDBC 连接字符集。最常见是数据库表用了latin1或 JDBC URL 没带characterEncodingutf8。解决分三步。第一步在web.xml里加编码过滤器保证请求和响应都是 UTF-8。第二步把数据库表改成 utf8mb4ALTER TABLE member CONVERT TO CHARACTER SET utf8mb4;。第三步确认jdbc.url里带characterEncodingutf8。这里要提一句MySQL 8 的 utf8mb4 是标准别再用 utf8因为 utf8 连 emoji 都存不下。改完这三处后老数据里的问号无法恢复所以建库脚本里一开始就写清楚字符集才是后悔药。5.4 分页失效PageHelper查询结果是全表现象会员列表第一页和第二页返回的数据完全一样SQL 日志里没有limit或者limit是limit 0,100但永远不变。原因PageHelper 使用 ThreadLocal 保存分页参数startPage之后必须紧跟着执行一条 Mapper 查询。如果你在startPage之后调用了另一个查询、或者先做了一步遍历集合的操作分页参数就会被消耗掉后续的查询自然不会加 limit。另外如果 MyBatis 配置里没有引入分页插件startPage根本不会生效。解决在 Service 方法里PageHelper.startPage(pageNum, pageSize);之后直接写ListMember members memberMapper.selectAll();中间不要做任何数据库操作。同时确认 MyBatis 配置中插件声明里有com.github.pagehelper.PageInterceptor。如果发现开启分页后查询全表优先检查这两个点。排查时打开 MyBatis SQL 日志看打印出来的语句有没有limit这是最直接的黑匣子破解方法。5.5 字段映射错误SQL报列不存在或结果全是null现象Mapper 执行时报BadSqlGrammarException: Column member_name not found或者查询结果里所有字段都是null但数据库明明有值。原因Java 实体属性是驼峰命名memberName数据库列名下划线member_nameMyBatis 默认不做自动驼峰映射。如果你没有写 resultMap查询结果就无法正确赋值。反过来实体属性映射到数据库列时MyBatis 会把memberName转成memberName不区分大小写数据库里根本没有这个大写列名。解决在 MyBatis 配置文件里加上一条设置setting namemapUnderscoreToCamelCase valuetrue/这样member_name会自动映射到memberName。如果项目已经有 resultMap就检查 resultMap 的column和property是否准确对应。这种问题消耗时间最多排查时先看控制台完整 SQL再对照实体类属性名很快就能定位。6. 让系统更像真实运营统计报表与会员到期提醒的进阶实现当核心增删改查跑通后最值得加的功能是“到期提醒”和“月度续费统计”。前者能让系统从“查不到数据”变成“主动告诉前台该给谁打电话”后者是店长最关心的数据。到期提醒最简单的实现是在启动类上加EnableScheduling然后用Scheduled(cron 0 0 8 * * ?)每天早上八点扫一次。Scheduled(cron 0 0 8 * * ?) Transactional public void checkExpiringMembers() { ListMemberCard expiringCards memberCardMapper.selectExpiringInDays(7); for (MemberCard card : expiringCards) { Member member memberMapper.selectById(card.getMemberId()); notifyService.sendSms(member.getPhone(), 您的会员卡将在 card.getEndDate() 到期请及时续费); } }这里的 SQL 是整段功能的核心WHERE status 1 AND end_date BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 7 DAY)。用end_date和当前日期比较而不去比较start_date是为了避免把“今天刚开卡”的用户也统计进去。真正到期的判定只看状态和截止日期这个模式适用于所有会员卡系统。我踩过的坑是定时任务里没有加事务导致短信服务在遍历过程中抛异常后面的会员就全漏了。所以给这个checkExpiringMembers方法加了Transactional短信发送记录统一入库即使中途有异常已发送的也不会重复发没发的会保留待发送状态。这个设计最早也是被店长投诉“老张明天到期怎么没通知”之后才补上的。如果你接手项目里的member_card表已经混乱比如没有end_date而只有duration_month和start_date也不要慌。可以用 SQL 视图把计算字段暴露出来SELECT DATE_ADD(start_date, INTERVAL duration_month MONTH) AS end_date ...。但这只是救火方案长期还是要拆出单独字段。作为一个习惯我每次建表一定会把“截止时间”这种高频查询字段真实存下来而不是每次都现算。这样做牺牲一点冗余换来的是所有统计逻辑又好写又不容易错。希望这篇从数据库到部署排查的笔记能帮到你。下次再有人问“SSM健身房管理系统怎么改”至少你能从表结构开始讲起而不是被一堆乱码配置牵着走。本文还有配套的精品资源点击获取
简介面向计算机毕业设计、课程设计及Java毕设场景这是一套基于SSMSpringSpringMVCMyBatis框架的健身房管理系统完整源码与数据库配套资料。系统围绕健身房日常运营设计提供登录/退出、账号管理、教练管理、健身器材管理、课程管理、健身房信息管理、会员卡管理等核心模块覆盖管理员、会员、教练、访客等多类角色的差异化操作管理员可维护账号、教练、器材、课程、门店及会员卡数据会员和教练也能在相应范围内自助修改信息。数据库采用MySQL并随附SQL脚本项目结构完整拿到后即可在本地部署运行或二次扩展适合用于毕业设计答辩、课程设计提交以及SSM整合开发入门参考。资源共2个文件主要文件类型为SSM工程源码zip与数据库脚本sql整体打包约54.9MB便于对照导入和快速启动。目前已有92人学习/下载可作为搭建健身房管理网站、理解SSM分层与角色权限设计的具体参考。1. 基于SSM的健身房管理系统先搞清楚它要管什么再谈源码和数据库一提到基于SSM的健身房管理系统很多人的第一反应是“又是一个毕业设计课题”。但真正落地时你会发现难点从来不是Spring、SpringMVC、MyBatis怎么搭而是会员开卡、私教预约、课程签到、器材报修这些业务状态之间怎么串起来数据库表怎么设计才不留下烂账。这个系统解决的是健身房前台还在用Excel记人、用本子约课的混乱状态会员到期没人提醒、教练排课冲突没人发现、月底统计收入全靠口算。它适合有Java Web基础、想把SSM整条链路走一遍的开发者也适合需要给小型健身房做内部管理后台的人。把源码和数据库脚本拿到手只是开始真正需要的是理解模块边界和数据流向否则改两行需求就会崩。2. 系统模块与数据库设计从会员卡到私教预约的字段怎么落2.1 先把业务边界画出来前台、会员、教练各要什么不要一上来就打开Navicat建表。我一般会拿一张白纸把一个真实健身房的工作流走一遍前台登记会员、推荐卡种、收款开卡会员凭卡到店、约私教、上团课教练查看当天课表、做签到店长关心这个月卖了多少卡、续费率多少、哪些器材该报修了。走到这一步系统模块自然分成六个系统用户登录、会员卡种、会员档案、课程与预约、器材报修、统计报表。这里面最容易被忽略的是“操作日志”。比如前台把会员手机号改了、教练把某节课的时间调了如果业务表里没有留下修订痕迹后期对账时根本说不清楚。我的做法是在每次状态变更时往一张operation_log表里写一条记录字段只要log_id, target_type, target_id, operate_user, action, create_time五个字段成本很低但排查问题时非常有用。下面的表结构是实际项目中最常见的剪枝版。完整项目中还会有字段如remark、create_by但核心表就这几张表名作用关键字段sys_user系统登录账号user_id, username, password, role_id, statusmember会员档案member_id, member_name, phone, id_card, birthdaycard_type卡种定义card_type_id, type_name, duration_month, price, total_timesmember_card会员购卡记录record_id, member_id, card_type_id, start_date, end_date, statuscoach教练信息coach_id, coach_name, phone, major, onboard_datecourse课程表course_id, course_name, coach_id, start_time, end_time, max_peoplecourse_booking课程预约记录booking_id, course_id, member_id, booking_time, statusequipment_repair器材报修repair_id, equipment_name, fault_desc, report_time, status2.2 会员和卡种别把购卡记录直接塞进会员表很多简化版的健身房系统会把card_type_id和expire_date直接写在member表里。初看很省事但会员第二次续卡时怎么办把原来的到期时间覆盖掉等于扔掉了一条历史购买记录。等到月底统计“本月续卡人数”时你只能用当前会员表里那些card_type_id和当前日期比较数据一塌糊涂。正确的做法是拆成“会员档案”和“购卡记录”两张表。member表只存这个人是谁member_card表记录每一次买卡一个会员可以有多个member_card记录其中一条状态为“生效中”。这样续卡时只需要把旧记录置为“已过期”插入一条新记录历史数据完整后续统计也清晰。建表SQL里尤其要注意expire_date推荐用date而不是datetime因为卡种到期只关心到哪一天带时分秒反而会在“当天是否生效”的判断上多写一堆边界逻辑。下面是剪枝后的建表脚本我会在db/01_schema.sql里按顺序执行。CREATE TABLE card_type ( card_type_id INT NOT NULL AUTO_INCREMENT, type_name VARCHAR(50) NOT NULL COMMENT 卡种名称如季卡年卡, duration_month INT NOT NULL COMMENT 有效期月数, price DECIMAL(10, 2) NOT NULL, total_times INT DEFAULT NULL COMMENT 次数卡的总次数不限次数则NULL, PRIMARY KEY (card_type_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE member_card ( record_id INT NOT NULL AUTO_INCREMENT, member_id INT NOT NULL, card_type_id INT NOT NULL, start_date DATE NOT NULL, end_date DATE NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1生效中 2已过期 3已退卡, PRIMARY KEY (record_id), KEY idx_member (member_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段建表逻辑里status是 TINYINT 而不是 VARCHAR原因是状态码方便程序里做枚举映射也方便数据库层做索引如果写成“生效中”“已过期”统计 SQL 还得先做字符串匹配性能差且容易写错。member_id上加普通索引是为了让“查某个会员的所有购卡记录”不用走全表扫描。实际项目中我还会加一个create_time DATETIME字段用于记录开卡时间这个字段到期提醒和续费分析都能用上。2.3 私教预约与课程排期用唯一约束挡住重复预约私教预约是整个系统里最容易出并发问题的模块。教练 A 在周六 10:00 有课两个会员同时在 9:59 提交预约如果代码里只做了“先查后插”极可能两个请求都看到“该时间段无预约”然后同时插入成功导致教练同时见两个会员。最常见的防线是在数据库层建立唯一约束UNIQUE KEY uk_coach_time (coach_id, start_time)。这样无论并发请求怎么跑数据库只会允许一条插入成功第二条直接撞唯一键程序拿到DuplicateKeyException后给会员提示“该时段已被预约请换时间”。这是用数据库兜底比纯靠 synchronized 或分布式锁可靠得多。CREATE TABLE personal_training_booking ( booking_id INT NOT NULL AUTO_INCREMENT, member_id INT NOT NULL, coach_id INT NOT NULL, training_date DATE NOT NULL, start_time TIME NOT NULL, end_time TIME NOT NULL, status TINYINT NOT NULL DEFAULT 1 COMMENT 1已预约 2已完成 3已取消, PRIMARY KEY (booking_id), UNIQUE KEY uk_coach_time (coach_id, training_date, start_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意唯一约束里我加了training_date这是因为教练每天都有 10:00 这个时段不能只约束coach_id start_time否则第二天 10:00 也约不进去。end_time不要实际存储也可以但存下来的好处是生成教练课表时不用再根据课程时长推算。另一种方案是用datetime存起始时间直接比较区间是否重叠但 SQL 写起来更复杂不如把时间段拆成日期加时间两个字段配合唯一约束更直观。2.4 数据库脚本的组织方式字符集和顺序都不能省源码包里一般会带 SQL 脚本但很多人拿到后直接全选执行最后中文乱码或者外键报错。我的习惯是把脚本拆成01_schema.sql、02_data.sql并且在每个建表语句里显式指定ENGINEInnoDB DEFAULT CHARSETutf8mb4。如果你用 Navicat 导出的脚本字符集可能还是latin1执行到中文注释时会直接报错。mysql -u root -p -e CREATE DATABASE IF NOT EXISTS gym_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p gym_db db/01_schema.sql mysql -u root -p gym_db db/02_data.sql这段命令先建库再导表结构和初始化数据。如果直接mysql 01_schema.sql而库里还挂着旧表你可能会遇到table already exists。所以强烈建议加DROP TABLE IF EXISTS放在每个建表语句前面或者执行前先清空库。另外COLLATE utf8mb4_general_ci这个排序规则适合中文业务场景比较字符串时忽略大小写查询“张”和“zhang”不会因为在不同字符集里而匹配不上。3. 用SSM搭起核心骨架配置文件的顺序与三个“能不能”校验3.1 项目结构与Maven依赖少了任何一个依赖都会翻车SSM 项目的标准目录是src/main/java放包src/main/resources放配置文件src/main/webapp放 JSP 和静态资源。如果你是用 Maven 从零建的模型一定把依赖写全。很多团队项目翻车不是因为代码而是因为pom.xml里漏了spring-jdbc导致容器启动时找不到JdbcTemplate相关的类。我这里给出一个经过多次验证的依赖组合Spring 版本锁定 5.2.xMyBatis 用 3.5.xmybatis-spring 用 2.0.x这套组合和 Tomcat 8/9 都能稳定工作。依赖之间版本冲突是 SSM 初学者的噩梦建议不要盲目追新也不要用 4.0 以下的旧 Spring。dependencies dependency groupIdorg.springframework/groupId artifactIdspring-context/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version5.2.15.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.5.6/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.25/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.8/version /dependency /dependencies这里最关键的参数是mybatis-spring的版本如果你用 MyBatis 3.5.x 却配了 mybatis-spring 1.3.x启动时会直接报TypeException因为两个版本的兼容接口变了。第二个注意点是mysql-connector-java用了 8.x那数据库连接 URL 里的驱动类名必须是com.mysql.cj.jdbc.Driver而不是老项目里的com.mysql.jdbc.Driver。这个细节会让很多人卡在启动第一步。3.2 数据库连接参数五个参数决定系统能不能起来SSM 系统的第一道门槛是数据库连接。很多系统部署后启动失败报出Access denied for user rootlocalhost或者Server returns invalid timezone八成是jdbc.properties没写对。我的默认模板里固定有下面这些参数部署时只需要换用户名密码和库名。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/gym_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8allowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password123456 jdbc.initialSize5 jdbc.maxActive20注意 URL 里的serverTimezoneAsia/Shanghai是 MySQL 8 驱动必加的参数否则会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。useSSLfalse避免本地开发时自签名证书的警告铺满控制台。characterEncodingutf8一定要放在 URL 参数里光在建表时指定 utf8mb4 还不够。allowPublicKeyRetrievaltrue也是 MySQL 8 外加的因为默认不允许从服务器获取公钥某些连接工具会报连接失败。initialSize和maxActive是 Druid 连接池的参数。initialSize5表示启动时就预创建 5 个连接适合后台管理系统这种不需要瞬时高并发的场景maxActive20是连接池上限前提是 MySQL 的max_connections默认 151够用。如果健身房高峰期同时操作人数多可以适当调高但别超过数据库上限否则反而会拖垮 MySQL。3.3 Spring与MyBatis整合的三个“能不能”Spring 和 MyBatis 整合的核心是applicationContext.xml。这个文件负责数据源、SqlSessionFactory、Mapper 扫描。我见过太多配置错误最典型的是basePackage扫的包不对导致 Mapper 接口永远注入不进去。context:property-placeholder locationclasspath:jdbc.properties/ bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ property nameinitialSize value${jdbc.initialSize}/ property namemaxActive value${jdbc.maxActive}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ property nametypeAliasesPackage valuecom.example.gym.entity/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.gym.mapper/ /bean配置完之后启动项目前可以自己问三个“能不能”第一能不能在com.example.gym.mapper包下找到所有 Mapper 接口第二能不能在classpath:mapper/下找到对应的 XML 文件第三XML 里的namespace能不能精确到接口全限定名这三个问题只要有一个是“不能”MyBatis 就会给你一堆莫名其妙的绑定异常。这里有个参数容易踩坑mapperLocations写成classpath:mapper/*.xml时如果你的 mapper 目录在resources/mapper下没问题但如果你把 XML 放到了java目录下Maven 默认打包时不会包含 XML运行时就报Invalid bound statement (not found)。解决方法是把 XML 放到resources/mapper或者在pom.xml里显式配置resources节点把 XML 也打进去。3.4 SpringMVC的controller扫描与静态资源放行spring-mvc.xml只管 controller 和视图解析不要在这里再扫描 service 和 mapper否则 Spring 容器会加载两份同名 Bean产生事务注解不生效的玄学问题。我一般用下面的配置。context:component-scan base-packagecom.example.gym.controller/ mvc:annotation-driven/ mvc:resources mapping/static/** location/static// bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean这里的关键是mvc:annotation-driven/必须保留否则RequestMapping不生效。base-package只扫controller避免把Service和Repository也扫进 MVC 容器。静态资源放行是因为 JSP 页面里要引 CSS、JS如果被 DispatcherServlet 拦截样式就全部丢失。视图解析器的prefix和suffix让 controller 返回member/list时自动找到/WEB-INF/views/member/list.jsp这样用户不能直接访问 JSP安全性好一些。4. 业务代码背后的关键参数分页、事务和状态机的设定4.1 分页插件PageHelper的3个必调参数后台管理的会员列表、课程列表必须要分页不然数据量一上来页面卡死。SSM 里最省心的分页方案是 PageHelper。这个插件会在 MyBatis 执行查询前拦截 SQL自动拼上limit所以你只需要在 Service 方法里调用PageHelper.startPage(pageNum, pageSize)后紧跟一条查询即可。public PageResultMember listMembers(int pageNum, int pageSize) { PageHelper.startPage(pageNum, pageSize); ListMember members memberMapper.selectAll(); PageInfoMember pageInfo new PageInfo(members); PageResultMember result new PageResult(); result.setList(pageInfo.getList()); result.setTotal(pageInfo.getTotal()); result.setPageNum(pageInfo.getPageNum()); result.setPageSize(pageInfo.getPageSize()); return result; }这段代码里PageHelper.startPage后面只能跟第一条mapper.selectAll()中间不能再插入其他查询否则分页会“串台”。三个必调参数是在 MyBatis 全局配置里设置helperDialectmysql指定数据库方言reasonabletrue表示 pageNum 如果超过总页数就自动纠正到最后一页如果小于 1 就纠正到第一页避免前端传个 -1 导致 SQL 里limit -1报错supportMethodsArgumentstrue允许从 Mapper 方法参数里直接取分页参数减少手动调 startPage 的重复代码。我在真实项目里还会要求pageSize必须小于等于 100防止有人恶意传 10000 把整张表拉出去。你可以在 controller 层做一层参数校验pageSize Math.min(pageSize, 100)。这个看起来简单但能避免很多不必要的数据库压力。4.2 事务的处理开卡和更新卡状态必须要一起成功业务里最典型的事务场景是会员开卡需要在member_card插入一条购卡记录同时把member表里的card_status更新为正常。如果第一步成功、第二步失败前台会告诉会员“开卡成功”但实际上会员状态没变导致会员卡用不了。这种脏数据是最难排查的。Service public class MemberCardService { Autowired private MemberCardMapper cardMapper; Autowired private MemberMapper memberMapper; Transactional(rollbackFor Exception.class) public void openCard(MemberCardAddDTO dto) { MemberCard card new MemberCard(); card.setMemberId(dto.getMemberId()); card.setCardTypeId(dto.getCardTypeId()); card.setStartDate(new Date()); card.setEndDate(DateUtils.addMonths(new Date(), dto.getDurationMonth())); card.setStatus(1); cardMapper.insert(card); Member member new Member(); member.setMemberId(dto.getMemberId()); member.setCardStatus(1); memberMapper.updateById(member); } }需要特别强调的是Transactional(rollbackFor Exception.class)。Spring 默认只对RuntimeException回滚如果你在方法里抛出了一个自定义的BusinessException而这个异常继承的是Exception没有指定rollbackFor那事务不会回滚数据库里就留下半条脏数据。这是很多“加了事务但还是多了一条记录”问题的根源。事务注解应该放在 Service 实现类的方法上而不是 Controller 的 Action 方法上。Controller 负责参数绑定和页面跳转如果它在事务里做太多无关操作会拉长数据库连接的占用时间。另外同一个类中方法直接调用另一个Transactional方法时事务注解不会生效因为走的是this调用而不是代理对象所以不要在 Service 里自己调自己。4.3 会员状态机用状态码而不是if-else煮成一锅粥会员卡的状态不是简单的 0 和 1至少包括1 正常、2 已过期、3 已停用、4 已注销。很多系统用字符串“正常”“过期”直接怼到页面上看起来直观但统计 SQL 时非常憋屈。更好的方式是数据库存 TINYINT 状态码Java 里用枚举统一管理。public enum MemberCardStatus { ACTIVE(1, 正常), EXPIRED(2, 已过期), DISABLED(3, 已停用), WITHDRAWN(4, 已注销); private final int code; private final String desc; MemberCardStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } public String getDesc() { return desc; } }状态流转是后期最容易改崩的地方。比如一张“已注销”的卡能不能直接续费变成“正常”从运营逻辑上讲应该不允许用户必须先“重新开通”或者“恢复档案”。“停用”的卡能不能约私教也不应该。把这些规则集中到一个状态机类里而不是散落在各个 Service 里后续维护才轻松。public static MemberCardStatus nextForRenew(MemberCardStatus current) { if (current EXPIRED || current DISABLED) { return ACTIVE; } throw new BusinessException(当前状态不支持续卡); }这段代码把“哪些状态可以续卡”收敛到了一个方法里。如果你看到 Service 里到处写if (正常.equals(member.getCardStatus()))那后面改需求时基本要血泪重写。状态机的好处在于新增一个“挂失”状态时你只需要在枚举中添加再在状态机类里明确从哪些状态可以进入其他调用点都不需要动。这就是状态码比字符串更可靠的原因。5. SSM健身房管理系统部署与排查从Tomcat到数据库连接的5个常见坑5.1 环境与依赖类Tomcat一启动就报ClassNotFound现象项目打包成 war 丢到 Tomcat webapps 下启动马上抛出ClassNotFoundException: org.springframework.web.context.ContextLoaderListener或者找不到 Druid 数据源类。原因war 包里的WEB-INF/lib没有依赖 jar常见于 IDEA 里直接 build artifact 时没有把 Maven 依赖一起打进去。配置文件里的 Bean 初始化找不到类自然启动失败。解决检查 Project Structure → Artifacts → Output Layout确保lib目录下包含了所有依赖。也可以用 Maven 打 war 包mvn clean package这样依赖会自动进WEB-INF/lib。以后部署后先看一眼 war 大小如果只有几百 KB说明 lib 没打进去别急着改代码。5.2 数据库连接失败Access denied和时区错误现象启动时控制台报Access denied for user rootlocalhost或者Cannot create PoolableConnectionFactory (The server time zone value ...)。原因密码不对是第一个密码对了但 URL 里没有serverTimezone是第二个。MySQL 8 驱动强制要求时区参数老驱动不需要所以很多旧代码换驱动版本后就踩坑。解决先用命令行测试mysql -u root -p -h localhost -P 3306 gym_db确认密码能连上库。然后检查jdbc.properties中jdbc.url是否包含serverTimezoneAsia/ShanghaiuseSSLfalsecharacterEncodingutf8。另外如果密码里带有或#等特殊字符在 properties 文件中需要转义或直接用 XML 的![CDATA[]]包起来否则参数会被截断。5.3 中文乱码页面正常但数据库里是问号现象前台填写的会员姓名存入 MySQL 后变成???查询出来也是问号。原因三处不一致页面编码、数据库表字符集、JDBC 连接字符集。最常见是数据库表用了latin1或 JDBC URL 没带characterEncodingutf8。解决分三步。第一步在web.xml里加编码过滤器保证请求和响应都是 UTF-8。第二步把数据库表改成 utf8mb4ALTER TABLE member CONVERT TO CHARACTER SET utf8mb4;。第三步确认jdbc.url里带characterEncodingutf8。这里要提一句MySQL 8 的 utf8mb4 是标准别再用 utf8因为 utf8 连 emoji 都存不下。改完这三处后老数据里的问号无法恢复所以建库脚本里一开始就写清楚字符集才是后悔药。5.4 分页失效PageHelper查询结果是全表现象会员列表第一页和第二页返回的数据完全一样SQL 日志里没有limit或者limit是limit 0,100但永远不变。原因PageHelper 使用 ThreadLocal 保存分页参数startPage之后必须紧跟着执行一条 Mapper 查询。如果你在startPage之后调用了另一个查询、或者先做了一步遍历集合的操作分页参数就会被消耗掉后续的查询自然不会加 limit。另外如果 MyBatis 配置里没有引入分页插件startPage根本不会生效。解决在 Service 方法里PageHelper.startPage(pageNum, pageSize);之后直接写ListMember members memberMapper.selectAll();中间不要做任何数据库操作。同时确认 MyBatis 配置中插件声明里有com.github.pagehelper.PageInterceptor。如果发现开启分页后查询全表优先检查这两个点。排查时打开 MyBatis SQL 日志看打印出来的语句有没有limit这是最直接的黑匣子破解方法。5.5 字段映射错误SQL报列不存在或结果全是null现象Mapper 执行时报BadSqlGrammarException: Column member_name not found或者查询结果里所有字段都是null但数据库明明有值。原因Java 实体属性是驼峰命名memberName数据库列名下划线member_nameMyBatis 默认不做自动驼峰映射。如果你没有写 resultMap查询结果就无法正确赋值。反过来实体属性映射到数据库列时MyBatis 会把memberName转成memberName不区分大小写数据库里根本没有这个大写列名。解决在 MyBatis 配置文件里加上一条设置setting namemapUnderscoreToCamelCase valuetrue/这样member_name会自动映射到memberName。如果项目已经有 resultMap就检查 resultMap 的column和property是否准确对应。这种问题消耗时间最多排查时先看控制台完整 SQL再对照实体类属性名很快就能定位。6. 让系统更像真实运营统计报表与会员到期提醒的进阶实现当核心增删改查跑通后最值得加的功能是“到期提醒”和“月度续费统计”。前者能让系统从“查不到数据”变成“主动告诉前台该给谁打电话”后者是店长最关心的数据。到期提醒最简单的实现是在启动类上加EnableScheduling然后用Scheduled(cron 0 0 8 * * ?)每天早上八点扫一次。Scheduled(cron 0 0 8 * * ?) Transactional public void checkExpiringMembers() { ListMemberCard expiringCards memberCardMapper.selectExpiringInDays(7); for (MemberCard card : expiringCards) { Member member memberMapper.selectById(card.getMemberId()); notifyService.sendSms(member.getPhone(), 您的会员卡将在 card.getEndDate() 到期请及时续费); } }这里的 SQL 是整段功能的核心WHERE status 1 AND end_date BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 7 DAY)。用end_date和当前日期比较而不去比较start_date是为了避免把“今天刚开卡”的用户也统计进去。真正到期的判定只看状态和截止日期这个模式适用于所有会员卡系统。我踩过的坑是定时任务里没有加事务导致短信服务在遍历过程中抛异常后面的会员就全漏了。所以给这个checkExpiringMembers方法加了Transactional短信发送记录统一入库即使中途有异常已发送的也不会重复发没发的会保留待发送状态。这个设计最早也是被店长投诉“老张明天到期怎么没通知”之后才补上的。如果你接手项目里的member_card表已经混乱比如没有end_date而只有duration_month和start_date也不要慌。可以用 SQL 视图把计算字段暴露出来SELECT DATE_ADD(start_date, INTERVAL duration_month MONTH) AS end_date ...。但这只是救火方案长期还是要拆出单独字段。作为一个习惯我每次建表一定会把“截止时间”这种高频查询字段真实存下来而不是每次都现算。这样做牺牲一点冗余换来的是所有统计逻辑又好写又不容易错。希望这篇从数据库到部署排查的笔记能帮到你。下次再有人问“SSM健身房管理系统怎么改”至少你能从表结构开始讲起而不是被一堆乱码配置牵着走。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
