健身房系统开发搭建详解:自助健身小程序核心功能与技术架构
24小时自助健身房的核心诉求是无人值守、会员自助通行、自动计费与设备管控。自助健身小程序作为用户入口,串联会员购卡、扫码开门、通行校验、时长计费、订单售后等链路,同时对接门禁、储物柜、环境传感器等IoT硬件。本文从业务痛点、技术架构、核心功能模块、关键代码实现、运维优化几个维度,讲解自助健身小程序落地的开发方案。
一、自助健身场景开发痛点
无人健身房和传统健身房管理系统差异明显,开发阶段会遇到不少软硬件协同问题。
门禁通行对实时性要求高,断网情况下不能直接锁死门店;会员卡类型复杂,次卡、月卡、时段卡、临时单次卡的权限规则不一样;并发扫码开门场景,容易出现权限重复下发、通行日志错乱;设备状态分散,门禁故障、门长时间未关、异常闯入需要及时告警;小程序和硬件网关协议不同,直接对接容易出现指令丢失、状态不同步。
单纯做前端页面无法支撑无人模式,必须把会员权限、通行校验、设备指令、告警规则统一在后端服务管控。
二、整体技术架构设计
整体采用前后端分离 + IoT边缘网关分层架构,分为四层:前端小程序层、业务服务层、边缘网关层、硬件感知层。
前端采用UniApp开发,编译为微信小程序,支持后续扩展H5;后端基于SpringBoot + MyBatis-Plus开发,MySQL存储会员、订单、通行日志、设备配置;Redis缓存会员临时通行权限、设备心跳、分布式锁;MQTT作为IoT通信协议,对接边缘网关,实现门禁指令下发、设备状态上报;边缘网关本地缓存权限,断网时支持离线放行,联网后同步日志。
管理后台独立开发,用于门店配置、卡种管理、设备绑定、告警记录查看。业务服务和设备解耦,新增门禁、储物柜等硬件时,只需要扩展物模型,不用改动会员核心逻辑。
三、小程序核心功能模块
- 门店与卡种模块:展示附近门店、营业时间、场地设施,支持单次卡、月卡、次卡、时段卡购买,微信支付完成自动开卡,记录卡有效期、剩余次数。
- 会员通行模块:生成动态通行二维码,支持扫码开门、人脸核验;动态码设置短有效期,防止截图复用;校验会员卡状态、有效期、门店权限。
- 时长计费与离场模块:按时长计费的订单,入场记录时间,离场自动结算;支持中途离场、超时续费。
- 储物柜预约模块:小程序预约储物柜,下发开锁权限,到期自动锁定。
- 通行记录与订单模块:保存每一次开门记录、入场离场时间,会员可查看历史订单、消费明细。
- 告警消息模块:门禁异常、长时间门未关闭、设备离线,通过小程序模板消息推送告警给运营人员。
四、后端通行权限校验核心代码
@Service
public class GymAccessService {
@Autowired
private StringRedisTemplate redisTemplate;
@Autowired
private MqttSendService mqttSendService;
@Autowired
private MemberCardMapper memberCardMapper;
@Autowired
private AccessLogMapper accessLogMapper;
private static final String ACCESS_LOCK_KEY = "gym:access:lock:";
private static final String MEMBER_PERMISSION_KEY = "gym:member:perm:";
@Transactional(rollbackFor = Exception.class)
public ResultDTO<String> verifyAccess(Long memberId, Long storeId, String deviceNo) {
// 分布式锁,防止同一会员高频重复下发开门指令
String lockKey = ACCESS_LOCK_KEY + memberId + ":" + storeId;
Boolean lock = redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 3, TimeUnit.SECONDS);
if (!Boolean.TRUE.equals(lock)) {
return ResultDTO.fail("操作频繁,请稍后重试");
}
// 查询会员有效卡
MemberCard card = memberCardMapper.selectValidCard(memberId, storeId);
if (card == null) {
return ResultDTO.fail("无有效健身卡,无法通行");
}
// 校验卡状态,次卡判断剩余次数
if ("TIMES".equals(card.getCardType()) && card.getRemainCount() <= 0) {
return ResultDTO.fail("次卡次数已用完");
}
// 构造通行指令,通过MQTT下发到门禁网关
AccessCommand command = new AccessCommand();
command.setDeviceNo(deviceNo);
command.setMemberId(memberId);
command.setStoreId(storeId);
command.setExpireTime(System.currentTimeMillis() + 60 * 1000);
mqttSendService.publishAccessCommand(command);
// 写入通行日志
AccessLog log = new AccessLog();
log.setMemberId(memberId);
log.setStoreId(storeId);
log.setDeviceNo(deviceNo);
log.setAccessStatus(1);
log.setAccessTime(LocalDateTime.now());
accessLogMapper.insert(log);
// 缓存会员通行权限
redisTemplate.opsForValue().set(MEMBER_PERMISSION_KEY + memberId, storeId, 5, TimeUnit.MINUTES);
return ResultDTO.success("通行校验通过,已下发开门指令");
}
}
通行码动态生成,后端校验通过后才下发MQTT指令给门禁;网关收到指令控制开门,同时上报开门结果,回写通行日志状态。
五、IoT网关与断网兜底策略
边缘网关是整个无人健身房稳定性的关键。网关会定时同步门店会员白名单到本地,当云服务器网络中断时,门禁可以读取本地缓存权限,会员依旧可以扫码入场;网络恢复后,网关自动把离线阶段的通行日志批量同步到云端。
网关持续上报设备心跳,后端定时检测心跳,如果超过阈值未上报,判定设备离线,触发告警。AB门禁场景增加互锁逻辑,A门打开时B门禁止开启,防止安全漏洞。
六、缓存、并发与安全优化
Redis承担两处核心缓存:会员通行权限缓存、设备心跳缓存,减少会员扫码时频繁查询数据库;动态通行二维码有效期设置60秒,过期自动失效,规避截图盗用风险。
并发控制使用分布式锁,避免短时间多次扫码,重复下发开门指令;接口全部HTTPS传输,MQTT连接启用证书认证;通行日志、告警日志永久留存,用于后期对账和安全追溯。
小程序端增加请求防抖,防止用户连续点击通行按钮产生大量无效请求。
七、测试与运维监控
重点验证几个场景:会员过期卡禁止通行、次卡扣减次数准确、断网场景离线放行、门长时间未关闭触发告警、多用户同时扫码开门互不干扰。
监控指标:MQTT指令下发成功率、门禁设备在线率、通行接口响应耗时、告警数量、卡种核销次数。异常指标持续上涨时,通知运维排查门店硬件或者网络问题。
总结
自助健身小程序整套方案,核心是小程序作为用户自助入口,后端服务统一管理会员、卡种、订单权限,依靠MQTT+边缘网关实现门禁硬件联动,同时设计离线兜底机制保障无人场景稳定运行。整套架构模块化,门店、卡种、通行、告警模块相互独立,支持单店快速部署,也可以横向扩展连锁门店。落地过程中,重点把控IoT指令可靠性、通行权限安全校验、断网兜底逻辑,在自助便捷性和场地安全之间做好平衡。