1. 马拉松报名系统的业务本质它为什么不是一张普通表单加支付先讲一个我实际遇到的场景。某地一场半程马拉松开放报名通道刚打开五分钟小程序端就有用户反馈我明明提交成功了为什么两小时后收到短信说没有名额支付成功了但订单列表里查不到记录。客服后台被刷屏运营团队一脸懵地来找我排查。问题出在哪出在很多人把马拉松报名系统当成一张报名表单 一个微信支付来做。但实际上马拉松报名这个业务场景它对系统的要求非常特殊至少有三个点是普通报名表单不会遇到的第一同一时刻的并发量极高。一场热门城市马拉松开放报名后第一分钟可能涌进几万人同时点击提交。普通表单系统每秒处理几百个请求就够了报名系统面对的是每秒几千甚至上万的写请求。此时数据库连接池、事务锁、接口响应速度都可能成为瓶颈。第二资格判断不是一个简单的是非题。马拉松报名不是填了就能报名成功它涉及赛事规则是否重复报名、是否已报名其他项目、年龄是否符合组别要求、是否需要上传健康证明或完赛证书、报名人数是否已满。这些规则的组合判断必须在提交的瞬间完成而且结果要绝对一致——不能出现两个人同时提交都通过了校验最后只有一个能拿到名额。第三报名成功这件事的定义是分阶段的。用户提交报名信息后先进入待支付状态支付成功后才真正锁定名额如果名额已经占满已提交未支付的用户会被淘汰甚至需要退款。这个状态流转比普通商品订单要复杂得多因为它是一场先到先得 支付确认的竞争机制。所以你要做的不是一个能报名的小程序而是一个能在高并发下保证数据一致性的赛事名额分配系统。这个认知决定了后面所有的设计决策。很多项目做到一半发现各种奇怪问题根源都在于一开始把系统想简单了。这篇文章我就按我实际落地的一套方案来讲如何设计数据模型、如何实现完整的报名主流程、如何解决并发抢名额、如何做后台赛事管理和消息触达。技术栈用微信小程序原生或 uni-app 都可以后端我用 Spring Boot MySQL Redis这套组合在报名类场景里非常成熟。文章会给出关键接口设计和核心逻辑有需要可以直接照着改。2. 先建模赛事、期次、报名记录三层结构缺一不可2.1 为什么必须拆成赛事—期次—报名记录三层很多初版设计会把赛事信息直接做成一张大表赛事名称、比赛时间、报名开始时间、报名结束时间、人数上限、报名费用、年龄要求……全塞在一起。如果只办一场比赛这么干勉强能跑。但真实运营中你会遇到这些情况同一场赛事分多个项目全马、半马、迷你跑、亲子跑每个项目的报名费用、人数上限、年龄要求都不同。同一场赛事分多期报名第一轮开放给早鸟第二轮普通报名第三轮补录。每一期的名额数量、价格、开放时间都不一样。已经关闭报名的赛事下一届要开启时不能直接把上一届的数据覆盖掉。所以正确的做法是拆成三层赛事表marathon_event存一场比赛的固定属性比如赛事名称、比赛日期、起终点位置、主办方信息、赛事介绍。这些信息一旦发布基本不变。期次表registration_period存这次赛事下的某个报名期次比如2025年春季全马项目-早鸟期。它的核心字段是关联的赛事ID、关联的项目ID或者直接存项目名称和组别、报名开始时间、报名结束时间、名额总数、报名费、是否启用。为什么要单独建期次表因为名额价格开放时间这些是随报名进度动态变化的它们不属于赛事静态信息。报名记录表registration_order存用户每一次提交报名生成的一条记录。它关联期次ID记录用户在小程序端的身份信息、参赛资料、报名状态、支付状态、支付单号等。这三层结构里最关键的是期次表。所有并发控制、名额扣减、资格校验都挂在期次粒度的字段上。赛事表反而是最静态的。2.2 报名记录表的关键字段设计报名记录表是整个系统的数据核心我建议至少包含以下字段字段类型说明idbigint主键order_novarchar(64)业务订单号展示给用户和客服看event_idbigint赛事IDperiod_idbigint期次IDopenidvarchar(64)用户在小程序端的身份标识user_namevarchar(32)真实姓名id_cardvarchar(18)身份证号phonevarchar(20)手机号gendertinyint性别age_groupvarchar(16)年龄组别bib_novarchar(16)参赛号码报名成功后分配registration_statustinyint报名状态1待支付 2已支付 3已取消 4已退款 5名额作废pay_statustinyint支付状态0未支付 1已支付 2已退款pay_amountdecimal(10,2)支付金额transaction_idvarchar(64)微信支付单号pay_timedatetime支付时间create_timedatetime提交时间update_timedatetime更新时间这里有个非常容易被忽略的点身份证号这类敏感信息在小程序前端提交时就要加密传输后端存储建议进行加密或掩码处理。我见过有项目把用户身份证明文存在数据库里这不仅是合规风险一旦数据库泄露就是重大事故。至少要做到后端接口用 HTTPS身份证号入库前做加密查询时只展示掩码后的内容。另外我用registration_status和pay_status两个字段分开存不要合并成一个状态字段。原因很简单报名记录有待支付但已提交资料的中间态如果只用一个状态你无法区分用户还没支付和用户支付失败这两种情况也无法做超时自动取消。分开存语义清晰后续做统计报表也方便。2.3 说一个关于主键的坑有人喜欢用用户ID做报名记录表的唯一索引认为一个用户只能报名一次。但实际业务里一个用户可能报名同一场赛事的全马又报名迷你跑甚至在一期内有多条历史记录比如上一届报过、这届又报。所以报名记录表一定不要对openid或user_id建唯一索引唯一键应该是(period_id, openid, id_card)这样的组合维度或者干脆就只用业务订单号order_no做唯一。我之前看到一个项目用用户ID做主键结果同一期次内用户重复报名时直接主键冲突整个提交接口报错。排查了半天才发现是建表时拍脑袋加的唯一约束。建模阶段多想一步后面省一周的排查时间。3. 用户端报名主流程从赛事发现到支付成功的完整链路3.1 赛事列表与期次状态的前后端联动小程序首页通常是一个赛事列表展示可报名的赛事和期次。这里要注意一个点期次能否报名不能只靠前端判断时间后端接口必须每次都校验当前时间是否在报名窗口内。前端展示逻辑通常是期次状态为未开始显示倒计时报名按钮置灰。进行中报名按钮可点。已结束或名额已满按钮变成已满或查看成绩。后端接口则要在返回赛事数据时就带上期次状态字段不要只给开始时间和结束时间让前端自己算。原因有两个一是前端时钟可能与服务器时间不一致二是状态计算逻辑如果散落在前端多个页面后期调整规则要改好几处。我把状态计算收敛在后端一个枚举里1 未开始当前时间小于报名开始时间2 报名中当前时间在报名时间窗口内且还有名额3 已满名额已耗尽不管时间是否到结束4 已结束当前时间超过报名结束时间列表接口返回赛事简要信息 当前期次状态 剩余名额。重点说下剩余名额不要在列表页直接返回精确的剩余数量返回一个模糊的梯度充足/紧张/已满就够了。精确数量会引发用户反复刷新套数据而且并发场景下返回的剩余数量和用户提交时的实际数量一定存在误差反而引发投诉。我用的是剩余名额 50% 显示充足10%50% 显示紧张小于 10% 显示少量0 显示已满。3.2 报名表单的关键校验项用户点击报名后进入报名信息填写页。这个页面除了常见的姓名、手机、身份证、性别、紧急联系人还必须做以下几个关键校验年龄组别校验。全马和半马通常有年龄下限比如全马要求年满20周岁。后端要根据身份证号解析出生日期计算出实际年龄再判断题目的年龄要求是否满足。这部分逻辑一定要放后端前端只是做体验性提示。后端校验的公式很简单年龄 报名年份 - 出生年份再判断是否已过生日更严谨的写法是LocalDate birthDate parseIdCard(idCard); LocalDate regDate LocalDate.now(); int age regDate.getYear() - birthDate.getYear(); if (regDate.getMonthValue() birthDate.getMonthValue() || (regDate.getMonthValue() birthDate.getMonthValue() regDate.getDayOfMonth() birthDate.getDayOfMonth())) { age--; }重复报名校验。规则通常是同一用户、同一赛事只能报名一个项目。这个校验要在后端用event_id openid registration_status in (1,2)查一下是否存在已提交或已支付的记录。注意要把已取消和已退款的记录排除掉否则用户退赛后想重新报名会被挡在门外这种问题运营人员能把你电话打爆。跨期次冲突校验。如果一个用户在早鸟期提交了全马报名但未支付之后普通期开放时又想报半马系统应该拦截还是在普通期放行不同赛事有不同的规则。我的处理方式是把拦截规则做成配置项在后端设置一个开关——是否允许同一赛事多期次同时存在未支付记录。默认关闭也就是同一赛事下只要存在待支付或已支付的记录就不允许提交新的报名。这个开关放在管理员后台运营人员可以根据实际赛制调整。3.3 提交报名的核心接口设计报名提交接口是我重点设计的因为它是并发压力最大、最容易出数据问题的环节。接口设计如下POST /api/registration/submit请求参数{ periodId: 1001, userName: 张三, idCard: 110101199003077777, phone: 13800138000, gender: 1, emergencyContact: 李四, emergencyPhone: 13900139000 }后端逻辑分五步校验期次是否存在、是否启用、当前时间是否在报名窗口内。校验用户提交的身份证号、手机号格式解析身份证得到年龄做组别判断。检查重复报名和跨期次冲突。尝试扣减名额。扣减成功则生成报名记录状态置为待支付返回订单号扣减失败返回名额已满。这里的重点是第四步和第五步之间的关联下面专门用一节讲并发扣减的实现。我先说一个很多人会犯的错误先插入报名记录再判断名额够不够。这种顺序在并发量小的时候没问题一旦并发上来就会出现多个人插入成功但名额超卖的情况。正确的顺序必须是先扣名额后写记录而且扣名额和写记录要保证要么都成功、要么都失败。还有一个细节扣减名额的对象是期次的剩余名额字段不是赛事的总名额。因为每一期独立开放、独立限额不同期次之间互不影响。剩余名额存在期次表还是单独一张表我建议单独建一张名额表关联期次ID字段就两个total_quota 和 remaining_quota。为什么要单独拆出来因为并发扣减时这张表会被频繁更新如果和其他字段挤在同一张表里行锁竞争会拖慢整体性能而且后续如果要支持名额池动态调配比如从 A 期挪一部分名额给 B 期单独一张表更好操作。3.4 支付流程与支付回调的幂等处理用户提交报名后会拿到 order_no然后在小程序前端调用微信支付。这一步的流程是标准的小程序支付后端根据订单号生成微信支付预支付单拿到 prepay_id。返回给前端前端用wx.requestPayment拉起收银台。用户完成支付微信服务器向你的后端回调地址发送支付结果通知。后端处理回调更新订单状态给用户发送报名成功通知。这里我踩过一个比较大的坑支付回调必须做幂等处理。微信支付文档明确说明同样的支付结果通知可能会多次发送且通知顺序不保证。如果后端不做幂等可能出现的问题包括用户支付成功但回调先到处理了一次随后又收到同样的回调再次更新订单状态把支付时间覆盖了。回调与用户主动查询并发导致状态错乱。我的做法是在回调处理逻辑里先根据 transaction_id 或 order_no 查询订单当前状态只有在待支付或支付处理中的状态下才执行状态变更如果已经是已支付直接返回成功应答不再做任何更新。同时回调处理要加分布式锁或数据库行锁防止同一订单的多个回调线程并发执行。还有一个容易被忽视的问题支付金额必须校验。回调通知里带的total_fee要和订单表里的应付金额比对不一致直接返回失败防止中间环节被篡改。不要觉得这是多余我见过有项目因为没校验金额被刷单薅了羊毛——用户改了支付金额参数用一分钱支付了几百块的报名费等发现时已经退不了款了。3.5 超时未支付名额释放的定时策略报名系统必然会有提交了不付钱的用户。这些用户占着名额导致真正想报名的人进不来。所以必须设计超时取消机制用户提交报名后如果在规定时间内比如 15 分钟未完成支付系统自动取消订单释放名额。实现方式有两种一种是定时任务扫表。每 30 秒扫一次报名记录表找出registration_status1且create_time超过 15 分钟的记录将其置为已取消同时将名额回补到期次的 remaining_quota。这种方式简单直接但要注意名额回补必须做原子操作不能先更新订单状态再回补名额否则一旦中途失败名额就丢了。我建议把回补名额放在同一个数据库事务里或者用 Redis 的原子自增。另一种是延迟队列。用 Redis 的 ZSET 实现订单创建时以create_time timeout作为 score 存入后台定时拉取到期订单处理。这种方式比定时扫表更精准但实现复杂度略高。对于报名系统这种量级定时扫表就够用了没必要为了优雅增加维护成本。我再提醒一个点当超时取消和支付回调同时发生时有可能出现支付已经成功、但超时任务已经把订单取消的情况。处理方式是支付回调处理时如果发现订单已是已取消状态不要直接改回已支付而是标记为已支付待人工确认同时自动退款。这个逻辑写清楚能避免很多客诉。我当时的实现是在超时取消前先检查订单是否已处于支付中状态比如前端已拉起收银台但用户还在操作如果支付中则跳过取消。4. 并发抢名额Redis 预扣减 数据库兜底4.1 为什么单纯靠数据库扣减会出事假设期次表里有字段remaining_quota 5000用户提交报名时后端执行UPDATE registration_quota SET remaining_quota remaining_quota - 1 WHERE period_id ? AND remaining_quota 0这个 SQL 在数据库层面是原子操作本身不会超卖。问题出在哪里出在事务隔离级别和锁竞争上。当大量请求同时执行这条更新语句时数据库会对该行加行锁其他请求必须等待前一个事务提交才能继续。在 5000 人同时抢 5000 个名额的场景里这个行锁竞争会导致接口响应时间飙升甚至出现大量超时。更严重的是如果你的代码把扣名额和插订单放在两个事务里中间出现异常而事务回滚不一致就会产生已扣名额但无订单记录的情况或者有订单但名额没扣的情况。这种脏数据排查起来非常痛苦。所以我的思路是把名额扣减从数据库前移到 Redis用 Redis 的原子操作快速完成预扣减数据库只负责最终的数据持久化。Redis 单线程模型天然保证原子性处理每秒几千次自减毫无压力。4.2 Redis 预扣减的具体实现整个并发控制流程我拆成两段第一段接口入口处做快速预检。用户提交报名时后端先从 Redis 读取该期次的可用名额 key比如key: reg:quota:1001 value: 5000如果 value 0直接返回名额已满。这一步是快速失败避免大量无效请求打到数据库。第二段扣减名额。用 Redis 的原子自减命令DECR reg:quota:1001返回结果如果小于 0说明名额已经扣超了需要立即执行INCR回补然后返回名额已满。如果返回值大于等于 0说明名额扣减成功这时候才允许继续插入报名记录。这里有一个很关键的细节DECR 返回的是自减后的新值不是旧值。比如剩余名额是 1第一个请求 DECR 后返回 0说明扣减成功第二个请求 DECR 后返回 -1说明超卖必须把最后一个名额通过 INCR 回补。这个逻辑写错的话名额会越扣越少甚至越回补越多。用代码表示Long remaining redisTemplate.opsForValue().decrement(reg:quota: periodId); if (remaining 0) { redisTemplate.opsForValue().increment(reg:quota: periodId); throw new BusinessException(名额已满); }4.3 数据库兜底防止 Redis 与数据库数据不一致Redis 扣减只是预占真正要落到数据库的还是那条 UPDATE 语句。为什么不直接用 Redis 扣减结果作为最终名额依据因为 Redis 是内存态一旦宕机数据会丢失必须用数据库做最终对账。所以我在扣减订单插入成功后还会执行数据库的兜底更新UPDATE registration_quota SET remaining_quota remaining_quota - 1 WHERE period_id ? AND remaining_quota 0这条语句如果在数据库层面影响行数为 0说明数据库里名额已经耗尽但 Redis 可能还没同步到位或者 Redis 数据被重置过此时需要人工或自动对账以数据库的实际剩余名额为准重新回填 Redis。对账方案我会在后台管理系统里实现一个定时任务每 5 分钟用数据库的名额数据覆盖 Redis 中的值。但要注意覆盖操作不能简单地直接 SET否则会出现用户已经扣减了 Redis 名额尚未写入订单但数据库对账把 Redis 重置了的竞态问题。所以对账时要做取更大值的合并逻辑或者把对账放在业务低峰期执行最好配合分布式锁。4.4 防重提交一个请求只允许扣一次名额并发场景下用户可能因为网络超时连续点了两次提交按钮。如果不做防重同一个用户可能扣两个名额、生成两条订单。我的处理方式是在提交接口入口处根据openid, periodId生成一个唯一键用 Redis 的 SETNX 命令实现请求锁Boolean locked redisTemplate.opsForValue().setIfAbsent(reg:lock: openid : periodId, 1, 10, TimeUnit.SECONDS); if (!locked) { throw new BusinessException(请勿重复提交); }锁过期时间设 10 秒足够一次提交接口完成全部逻辑。如果第一次请求还没处理完第二次请求就会被拦下。同时在数据库层面我给报名记录表加了(openid, period_id)的唯一索引兜底即使 Redis 锁失效数据库唯一约束也能拦住重复插入。这里要说明一下为什么不用数据库唯一索引做唯一的防重手段因为唯一索引冲突时会抛出异常你需要在代码里捕获异常并转换成业务提示但并发高时异常量太大会拖慢数据库。Redis 锁拦在门口数据库唯一索引只是最后一道保险两者配合既高效又安全。4.5 容量评估Redis 够不够快有人会担心Redis 做预扣减扛得住几万并发吗我可以给个参考数据。我用 Redis 单实例做了个压测纯 DECR 操作无网络延迟理想状态每秒可以做到 10 万次以上加上网络请求、JSON 解析、业务逻辑单机扛每秒 5000 次扣减毫无压力。如果赛事规模巨大比如同时开放多个期次还可以做 Redis 集群分片每个期次一个 key天然分散压力。真正可能成为瓶颈的是数据库的订单插入。所以我建议订单插入采用批量写入或者异步落库的优化方案。用户提交后先返回报名受理中后台把订单数据写入消息队列消费者批量插入数据库。但要注意异步落库意味着用户可能查不到即时订单需要配合报名状态查询接口提供凭据查询。如果你的项目体量不大完全没必要上异步直接同步插入加索引优化就够了。报名系统一年也就几场大赛单场峰值再高也是短暂的没必要为了极限性能把系统搞复杂。这里有个经验之谈技术选型要匹配业务量级。做个县城的马拉松报名用 Redis 预扣减 数据库兜底这套方案已经是杀鸡用牛刀了但好在实现成本低、稳定性高后续体量涨了也不用重构。真到了北上广深万人级赛事再考虑分区分流和消息队列也不迟。5. 管理后台赛事配置、名额监控与数据统计5.1 管理员能配什么把业务规则做成可配置项马拉松报名系统真正的运营压力在后端管理。运营人员可不是程序员他们需要一套能自己改规则的后台。我的后台管理页面最少包含以下几个模块赛事管理创建赛事、编辑赛事信息、上下架赛事。赛事下架后用户端列表不再展示但已产生的订单和成绩查询功能不受影响。期次管理在赛事下创建期次填写期次名称、报名时间窗口、名额总数、报名费用、项目组别、年龄要求等。这里我强烈建议把允许重复报名是否需要健康证明是否显示剩余名额这些开关都做成下拉选项或勾选框不要写死在代码里。报名订单管理以列表形式展示所有报名记录支持按赛事、期次、姓名、身份证、手机号、状态筛选。运营人员可以进行手动取消、人工退款、修改参赛组别、录入参赛号码。这些操作全部记录操作日志方便追溯。5.2 实时监控剩余名额的看板管理后台首页我放了一个实时监控看板展示每个期次的总名额 / 已报名人数 / 剩余名额当前报名状态未开始 / 报名中 / 已满 / 已结束待支付订单数量、超时即将释放的名额数量最近 5 分钟的报名趋势曲线这个看板的数据从哪里来实时性要求高的字段从 Redis 读比如剩余名额历史汇总数据从数据库聚合。这里有个小技巧不要在每次看板请求时实时 count 订单表数据量大了会很慢。我的做法是维护一张期次统计表每次报名成功、取消、退款时同步更新这张表的已报名人数字段。后台看板只查这张统计表性能非常稳。5.3 数据导出与报表运营人员最常用的功能报名结束后运营人员需要导出参赛名单、生成参赛号码、统计各组别人数。我的后台提供了两个导出功能报名名单导出按期次导出 Excel包含姓名、性别、身份证掩码、手机号、组别、报名状态、支付金额、参赛号码。导出操作放到异步任务里生成文件后存到对象存储前端提供下载链接。为什么不能同步导出我曾经在一个两万人报名的赛事上同步导出后端卡了 30 秒网关直接超时文件还没生成完。后来改成异步生成用户体验反而更好。号码布批量分配报名结束后运营人员需要给每个参赛者分配参赛号码。号码规则通常有固定格式比如A1001按组别前缀 序号。我实现了后台自动分配功能先按组别排序再按报名时间顺序分配号码。分配后可以人工调整个别号码比如赞助商名额调整时校验号码唯一性。5.4 定时对账与数据修复整个系统运行过程中Redis 和数据库的数据一致性不能完全依赖代码不出错必须有一套自动对账机制。我在后台做了一个定时任务模块包含两类任务名额对账任务每 10 分钟执行一次遍历所有启用中的期次统计数据库里registration_status in (1,2)的记录数计算实际剩余名额 总名额 - 已报名数与 Redis 中的值比对。不一致时以数据库为准回写 Redis。回写时加上分布式锁避免与正在进行的报名操作冲突。订单超时取消任务每 30 秒执行一次找出待支付超过 15 分钟的订单执行取消和名额回补。上面已经讲过了这里不重复。另外我还加了一个重复订单检测任务每天凌晨扫描一次找出同一用户在同一赛事下的多条已支付订单标记出来供运营人员人工确认。真出过这种情况——用户先报了全马支付成功后因为网络延迟又提交了一次半马报名居然也通过了因为重复校验按待支付或已支付只查了当时时间点的状态没挡住他第二次并发提交。这种极端场景靠业务逻辑很难完全防住事后检测 人工处理是最稳妥的方案。6. 消息触达与用户体验报名成功通知、赛事提醒、结果查询6.1 报名状态的主动通知微信订阅消息的合理用法马拉松报名系统里用户最关心几个时间点报名成功、报名失败名额已满、支付成功、退款成功、赛前提醒、成绩公布。这些节点都应该给用户发消息。微信小程序里就是订阅消息。订阅消息有个限制每次调用要求用户主动同意且一次性订阅只能推送一次。设计上要注意报名提交成功后弹出订阅请求订阅报名结果通知。支付成功后再次请求订阅订阅赛事提醒可以设置多个提前量比如提前 7 天、提前 1 天。赛事结束后请求订阅成绩通知。不要试图在用户刚进入小程序时就请求订阅一堆消息类型转化的成功率很低而且会干扰核心操作。我的经验是每一次订阅请求都跟着一个用户当前正在完成的动作走自然且干扰小。6.2 报名状态查询与主动刷新用户在小程序里进入我的报名页面能看到自己所有报名记录及其状态。这里要支持下拉刷新并在状态变更时给出明确的引导文案待支付显示请在 15 分钟内完成支付超时名额将自动释放按钮为去支付。已支付显示参赛号码、赛事时间、地点按钮为查看详情。已取消显示订单已超时取消如需报名请重新提交。已退款显示退款金额和退款时间。我的报名页面的数据来源我建议直接查后端接口不要在小程序本地缓存。因为报名状态是强一致的用户刷新页面就应该看到最新状态。这个接口做了分页一次加载 20 条下拉加载更多。数据量不大不用做太多缓存优化。6.3 报名成功的电子凭证多一道身份核验报名成功后除了发订阅消息我还给用户生成了一张电子报名凭证。凭证上包含赛事名称、项目组别、参赛号码、用户姓名、身份证掩码、报名状态、赛事二维码。现场领物时工作人员可以通过小程序扫描二维码核验参赛者身份。不要小看这个电子凭证它能显著减少赛前领物的排队时间也避免用户忘带纸质确认函导致无法领物。实现方式不复杂二维码内容用一个带签名的 URL 或者加密字符串后端接口校验签名后返回参赛信息。注意二维码要有有效期防止截图被冒用。6.4 关于 iOS 静音播放、视频下载这些附属功能做小程序的过程中有些用户反馈的怪问题你迟早会遇到。比如 iOS 设备上视频没声音、长按图片出菜单、web-view 高度不合适等。我看过很多讨论帖子这里挑两个和报名系统相关的说一说。iOS 静音状态下播放视频无声赛事宣传视频如果在小程序里播放iOS 的静音开关会全局静音用户以为出了 bug。解决方式是使用微信小程序同层渲染的 video 组件并引导用户关闭静音模式或者在视频播放按钮旁加提示请在非静音模式下观看。web-view 高度问题如果赛事详情页嵌入了 HTML 网页web-view 的高度在小程序里经常出现内容被截断的情况。我的处理方式是在 HTML 页面里保证外层容器有足够高度同时在 web-view 加载完成后通过 postMessage 告知小程序调整高度。这个方案不完美但能用。当然如果赛事详情是纯文本图片用小程序原生页面展示更省心没必要为了省开发时间引入 web-view。这些小问题虽然和报名系统核心业务无关但用户体验的细节往往决定了用户对这个小程序的整体评价。我在项目里专门有一类 bug 清单叫平台兼容性每遇到一个新问题就记录解决方案下一个赛事直接复用效率会提高很多。7. 反作弊与风控边界黄牛、刷单和异常行为的处理7.1 报名场景会遇到哪些作弊行为很多人写报名系统只关注正常流程忽略了恶意行为。马拉松报名场景里最常见的风险是黄牛占坑大批量注册微信账号提交报名但不支付占用名额后加价转让参赛资格。刷单攻击用脚本批量调用提交接口造成虚假报名记录干扰系统正常运行。信息篡改修改身份证号、手机号等关键字段绕过年龄或身份校验。这些行为的危害不同应对方式也不同。我的原则是核心目标是保证真实用户能正常报名不追求绝对杜绝作弊——绝对杜绝的成本太高而且会影响正常用户体验。7.2 低成本的风控手段设备指纹 频控 人工审核我先说三个实现成本低、效果明显的风控手段接口频控对同一 openid 限制报名接口调用频率比如 1 分钟内最多调用 5 次。超出直接返回操作过于频繁。这个用 Redis 计数就能实现成本极低。设备指纹通过前端收集设备的型号、操作系统版本、屏幕分辨率等信息生成一个哈希值作为设备标识传给后端。同一设备在短时间内关联多个 openid 提交报名触发告警。设备指纹不需要做到绝对准确够识别脚本批量操作就行。敏感操作人工审核同一个身份证号出现在多个订单中、年龄临界值、性别与身份证信息不符这类记录后台标记为异常待核验由运营人员人工判断。不要指望全自动风控能把所有问题都挡掉报名系统的人工审核机制比复杂的算法更可靠。7.3 关于骗审和虚拟支付的边界提醒搜索记录里有人问微信小程序如果开发骗审虚拟支付苹果 IAP 退款这类问题我这里明确说一句小程序审核是平台规则不是用来钻的空子更不要尝试用违规手段通过审核。报名类小程序属于服务类目核心是线下赛事服务不是虚拟支付不涉及苹果 IAP 的虚拟商品规则只要业务流程合规审核不会有问题。从技术上确保小程序审核通过你有几件必须做对的事小程序类目选择和赛事主办方资质材料匹配。用户隐私保护指引中明确说明收集身份证号、手机号的用途。不能有未开放的功能入口比如未完成的按钮放在页面上。支付流程必须走微信官方组件不能自己构造支付页面。这几点做到审核一般很顺利。反过来动歪心思的结果通常是永久封禁开发者账号得不偿失。8. 腾讯云与部署注意点从开发到上线的完整链路8.1 小程序前后端的云环境选择微信小程序的后端部署方案我推荐两种方案一微信云开发。适合小规模赛事不需要自建服务器。云开发提供云函数、云数据库、云存储天然和微信生态打通。报名人数在几千人的赛事用云开发完全够用。我一开始做第一届赛事时用的就是云开发两周就上线了成本几乎为零。方案二自建后端 小程序。适合预计规模较大、后续要扩展的赛事。自建后端可以用任何语言我熟悉的是 Java Spring Boot部署在腾讯云服务器或容器服务上。这个方案的好处是数据完全自主可控坏处是要自己处理微信登录、支付回调签名验证、HTTPS 证书这些基础设施问题。如果按方案二前端请求的域名必须在小程序后台配置为合法域名并且必须 HTTPS。我见过有人把后端部署在 IP 上小程序请求直接报 url not in domain list 错误。这个配置在 mp.weixin.qq.com 的后台「开发管理 → 开发设置 → 服务器域名」里request 合法域名和 uploadFile 合法域名要分别配置。配完不是立刻生效有缓存开发时可以用不校验合法域名选项临时调试但上线前一定要改回来。8.2 微信登录与 UnionID 的坑小程序的登录流程是前端调用wx.login获取 code后端拿 code 调用微信接口换取 openid 和 session_key。openid 是用户在某个小程序内的唯一 ID同一个用户在不同小程序下 openid 不同。如果你后续要做一个公众号关联的管理端让运营人员在小程序和管理端之间打通账号就要用 UnionID。UnionID 的获取前提是小程序和公众号绑定在同一个开放平台账号下。这里有个常见的坑很多开发者只取了 openid没处理 UnionID导致后面做多端数据打通时发现匹配不上。我的建议是从第一个版本开始用户表设计时就加上 union_id 字段登录时把 openid 和 union_id 都存下来。即使现在没用到以后也省得做数据迁移。8.3 上线前的安全自查清单上线报名系统之前我建议按这个清单逐项检查HTTPS 强制后端只支持 HTTPSHTTP 请求重定向到 HTTPS。接口鉴权除支付回调外所有业务接口都必须校验用户登录态不能靠 openid 明文传输来识别用户。敏感字段加密身份证号存储加密日志中不打印完整身份证号。参数校验手机号格式、身份证校验位、金额范围都要做。数据库备份每日自动备份备份文件异地存储至少保留 7 天。监控告警接口 5 分钟错误率超阈值、Redis 连接异常、数据库慢查询超 10 条都触发告警通知到运维群。这些不是加分项是必须项。马拉松报名涉及用户真实身份信息和资金一旦出问题就是大事。9. 实测中容易踩的五个隐形坑最后单独列一节专门讲我在开发这类报名系统时反复踩过、也帮别人排查过的坑。这些坑在文档里很难找到但实际运行中百分之百会遇到。9.1 小程序冷启动时wx.login与后端 session 异步问题小程序每次冷启动前端会调用wx.login获取新的 code后端用 code 换取 openid 后会得到一个新的 session_key。如果你把用户登录态存到后端 session要特别注意同一个用户短时间内多次调用 wx.login会生成多个不同的 session_key但你只能用一个。处理不当会出现用户已登录但部分页面提示未登录的诡异现象。我的做法是后端拿到 openid 后自己生成一个自定义的 tokenUUID 或 JWT返回给前端存储在小程序本地。后续所有接口都带这个 token后端根据 token 查询用户身份不依赖微信 session_key 的时效性。这种方式实现简单且完全可控。9.2 支付回调与用户主动查询的并发状态错乱这个前面提过我再展开说一次。用户支付成功后小程序前端可能同时做三件事微信支付回调通知后端、前端通过接口查询订单状态、用户点了刷新再次查询。这三者之间如果没有幂等控制订单状态可能被反复修改。我的处理方式是在订单状态变更的入口加一个状态机校验只允许从待支付迁移到已支付如果当前状态已经是已支付任何新的回调或查询都不做状态变更只返回当前状态。这个状态机写在一个服务方法里所有入口都走这个方法避免逻辑散落。9.3 名额回补时 Redis 与数据库的先后顺序超时取消订单时需要回补名额。这里的顺序是先更新数据库订单状态为已取消再回补数据库名额最后回补 Redis 名额。我强调一下 Redis 要放最后为什么如果先回补 Redis 再更新数据库一旦更新数据库失败Redis 已经多了名额用户实际还能报名但数据库里名额没增加最终对账时数据库会强制改回 Redis造成用户提交成功但后来被对账取消的严重客诉。反过来先更新数据库成功、Redis 回补失败这个不一致可以通过定时对账自动修复最多造成短时间的名额偏差。所以优先保证数据库一致Redis 允许短暂滞后这是全局设计原则。9.4 上传身份证照片的隐私合规有些报名流程需要用户上传身份证照片或扫描身份证。微信小程序里可以用wx.scanCode或第三方 OCR 插件实现身份证识别。但要注意识别结果不能直接在页面里明文展示完整身份证号要打码显示。OCR 识别服务建议在调用前先获得用户明确的授权同意隐私协议里写明用于实名认证及赛事保险购买。我碰到过一次用户投诉说小程序上传身份证后照片在后台管理列表里能被运营人员查看。后来我把身份证照片做了权限隔离只有超级管理员和指定的报名审核员有权限查看且查看动作留下日志。这个改动成本不高但对合规很有意义。9.5 期次名额释放最后一秒的边界判断报名截止时间精确到秒比如 23:59:59 结束。在这个时间点前一刻提交的用户算不算有效我的规则是只要当前时间 报名结束时间就允许提交名额是否充足以扣减时的 Redis 值为准与提交时间先后无关。这个规则要写清楚否则容易出现边界争执——用户 23:59:59.8 提交成功了另一个用户 23:59:59.9 提交却提示报名已结束客服解释不清楚。实际开发中我把这些边界规则统一写在配置类里作为业务规则常量运营人员可以在后台修改一部分。规则一旦确定所有代码片段都引用同一个常量避免各写各的判断逻辑导致前后不一致。以上就是我做马拉松报名系统微信小程序的核心经验。整套方案从数据模型、报名主流程、并发控制、管理后台到风控和部署都是在一次次赛事报名中打磨出来的。如果你正准备做一个类似的报名小程序建议先从第 2 节的数据模型和第 4 节的并发控制入手把这两块啃透了整个系统的大框架就稳了。至于表格里那几个字段怎么定、后台按钮怎么排后续按实际需求调就行不影响大局。最后分享一点个人心得报名系统的核心不是功能多炫酷而是该有的坑一个都不少地被提前堵住。多从运营人员和参赛者的角度去推演流程比多写一百行代码更有价值。
