健身房小程序开发实战：从0到1

去年我帮一家连锁健身房做了会员小程序，从需求梳理到上线只用了三周。这篇文章把踩过的坑和关键实现整理出来，给想做健身房小程序的独立开发者一个参考。

为什么健身房需要小程序而不是APP

健身房的核心场景非常集中：约课、签到、看卡、续费。这四件事都发生在门店现场或课前几分钟，用户没有耐心下载一个几十兆的APP。小程序扫码即用、微信支付闭环、消息推送触达，天然契合这个场景。

• 获客成本低：地推扫码直接进小程序，转化路径短
• 开发成本低：一套代码同时覆盖iOS和Android
• 支付顺畅：微信支付免密代扣适合月卡/年卡续费

核心功能模块拆解

1. 会员卡与身份识别

会员卡是整个系统的入口。用户首次进入小程序时，通过手机号授权绑定会员身份。这里要注意：不要强制授权，先让用户浏览课程，在预约或支付环节再触发授权，转化率会高很多。

// 获取手机号（新版接口需button触发）
Page({
  getPhoneNumber(e) {
    if (e.detail.code) {
      wx.request({
        url: 'https://api.yourdomain.com/bind',
        method: 'POST',
        data: { code: e.detail.code, openid: this.data.openid },
        success: res => this.setData({ member: res.data })
      })
    }
  }
})

2. 课程预约与排期

团课预约是高频功能。数据库设计上，我用了三张表：course（课程模板）、schedule（排期实例）、booking（预约记录）。排期表里存start_time、capacity、booked_count，用乐观锁防止超卖。

UPDATE schedule 
SET booked_count = booked_count + 1 
WHERE id = ? AND booked_count < capacity;

如果affectedRows为0，说明已满，返回“手慢了”提示。这个方案比事务锁更轻量，适合中小型健身房。

3. 签到与核销

到店签到用扫码或定位。扫码方案更可靠：前台放一个固定二维码，用户扫后调用核销接口。定位方案容易作弊，只适合辅助验证。

4. 私教与续费

私教课涉及教练排班和课时扣减，逻辑比团课复杂。我的做法是把私教预约做成“申请-确认”流程，教练在小程序端确认后才扣课时，避免纠纷。

技术选型建议

• 前端：原生小程序或Taro，团队小建议原生，坑少
• 后端：Node.js + MySQL，或直接用云开发
• 云开发适合快速验证，但复杂查询和定时任务会受限
• 消息推送：订阅消息，注意用户每次授权只能推一条

几个容易踩的坑

订阅消息的“一次性”特性是最大的坑。用户授权一次只能发一条，必须设计好触发时机，比如约课成功、课前提醒、卡到期提醒，分别引导授权。

• 微信支付退款要保留原始订单号，否则对账困难
• 课程时间用UTC存储，展示时转本地时区
• 会员卡到期提醒提前3天发，太早用户无感，太晚来不及续
• 小程序包体积控制在2M以内，图片走CDN

上线后的数据观察

上线一个月后，约课转化率从原来的电话预约提升了40%，续费率提升约15%。最明显的变化是前台工作量下降，以前每天接几十个约课电话，现在用户自己搞定。

如果你也在做健身房小程序，建议先把约课和签到做扎实，这两个功能跑通，其他都是锦上添花。