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指令给门禁;网关收到指令控制开门,同时上报开门结果,回写通行日志状态。
边缘网关是整个无人健身房稳定性的关键。网关会定时同步门店会员白名单到本地,当云服务器网络中断时,门禁可以读取本地缓存权限,会员依旧可以扫码入场;网络恢复后,网关自动把离线阶段的通行日志批量同步到云端。 网关持续上报设备心跳,后端定时检测心跳,如果超过阈值未上报,判定设备离线,触发告警。AB门禁场景增加互锁逻辑,A门打开时B门禁止开启,防止安全漏洞。
Redis承担两处核心缓存:会员通行权限缓存、设备心跳缓存,减少会员扫码时频繁查询数据库;动态通行二维码有效期设置60秒,过期自动失效,规避截图盗用风险。 并发控制使用分布式锁,避免短时间多次扫码,重复下发开门指令;接口全部HTTPS传输,MQTT连接启用证书认证;通行日志、告警日志永久留存,用于后期对账和安全追溯。 小程序端增加请求防抖,防止用户连续点击通行按钮产生大量无效请求。
重点验证几个场景:会员过期卡禁止通行、次卡扣减次数准确、断网场景离线放行、门长时间未关闭触发告警、多用户同时扫码开门互不干扰。 监控指标:MQTT指令下发成功率、门禁设备在线率、通行接口响应耗时、告警数量、卡种核销次数。异常指标持续上涨时,通知运维排查门店硬件或者网络问题。

自助健身小程序整套方案,核心是小程序作为用户自助入口,后端服务统一管理会员、卡种、订单权限,依靠MQTT+边缘网关实现门禁硬件联动,同时设计离线兜底机制保障无人场景稳定运行。整套架构模块化,门店、卡种、通行、告警模块相互独立,支持单店快速部署,也可以横向扩展连锁门店。落地过程中,重点把控IoT指令可靠性、通行权限安全校验、断网兜底逻辑,在自助便捷性和场地安全之间做好平衡。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。