发生了什么

换电按套餐卖:用户在小程序里买一份“1 天不限次换电”这类套餐,付完钱拿到订单,到门店由店员核销后才能开始用电池。电池要押金,平台也提供免押——不交押金,先由信用担保。

免押只能在支付宝小程序里办,微信小程序办不了。所以在微信端车服小程序里买了换电套餐的人,付款后会收到一条短信,里面带一个入口,把人引到支付宝小程序办完这笔订单的免押。车服和换电是两条并行的业务线,各有自己的小程序,短信模板也分两套:模板不同,带用户去的入口也不同。

发哪一套模板,由订单详情页决定。页面打开时调订单详情接口,返回里有一个表示业务类型的字段,页面拿它选模板交给短信服务发出,也决定跳进哪个业务的支付宝小程序。这套写法 19 个月前就加进来了。

12 月初,一位用户在微信端车服小程序买换电套餐,付款成功,详情页显示免押。这次页面拿到的类型是换电业务的值,于是发出的是换电模板,用户被带进了换电业务的支付宝小程序。那边没有这笔车服订单的免押入口,免押始终没办完;门店按订单号查询,查不到可核销的记录,套餐买了却用不了。

本质

问题不在免押规则,也不在短信通道,而在选模板前的一步:页面把“这笔订单属于哪个业务”交给接口返回的字段,而它在车服小程序下的订单上返回了换电的值。至于接口为什么返回换电的值,没有说明。

  1. 原流程:用户在车服小程序下单 → 详情页调订单详情接口 → 按返回的类型选短信模板 → 用户进对应业务支付宝小程序办免押 → 门店核销,套餐开始可用。
  2. 出错位置在选模板之前:详情接口给这笔车服订单返回的是换电业务的类型值,页面没做核对,直接把它当成“当前业务”。
  3. 页面用这个值查模板表,取到换电模板;同一个值又决定跳转目标,落地页也成了换电的支付宝小程序。一个字段错,通知内容和落地页一起错。
  4. 用户在换电小程序里找不到这笔车服订单的免押入口,免押办不完;门店按订单号查询,查不到可核销的记录。

一句话:同一个字段既决定短信内容又决定落地页,它返回错值,用户就被带进了另一条业务线。页面从没和“订单来自哪个小程序”比对过,发现不了这个值不对。

修复分两步。前端本期先止血:车服小程序里不再采信接口返回的类型,写死车服的值(2),模板和跳转都按车服走,用户能被带到车服支付宝小程序把免押办完。服务端不动老接口,另新增接口替换发短信链路——老接口在核心服务上,直接改影响面太大。两项都是本期方案,没有上线时间和验证结果,修复状态待确认;已发错模板的用户是否补发、订单是否人工核销,没有交代。

写死类型有代价:这段逻辑一旦被别的页面复用,或者这个页面以后也卖别的业务商品,写死的值就会反过来把用户带错。它只适合页面只属于一个业务,长期还得让类型从订单本身取准。

错误代码

// 订单详情页:付款成功后按接口返回的业务类型选短信模板并跳转(接口路径为示意)
async function onOrderPaid(orderNo) {
  const detail = await request('/order/detail', { orderNo });
  // 为什么错:把返回值当成“当前业务”,没有核对。
  // 车服小程序里的订单,接口回的却是换电的 1,模板和落地页都跟着错
  const bizType = detail.depositCategory;
  const tpl = SMS_TEMPLATE[bizType]; // 1 换电模板,2 车服模板
  await request('/sms/send', { orderNo, templateId: tpl.id });
  // 为什么错:同一个错值又决定跳转目标,用户被带进换电业务的支付宝小程序,
  // 这笔车服订单的免押在那里面办不了
  navigateToAlipayMiniProgram(MINI_APP[bizType]);
}

修复代码示例

// 车服小程序里:本页只服务车服业务,业务类型按页面所属业务固定
const CAR_SERVICE_BIZ_TYPE = 2;
async function onOrderPaid(orderNo) {
  const detail = await request('/order/detail', { orderNo });
  // 修复:返回值与页面所属业务不一致时只上报、不参与分流,
  // 既把用户带对地方,也让服务端看得见这条脏数据
  if (detail.depositCategory !== CAR_SERVICE_BIZ_TYPE) {
    reportMismatch({ orderNo, expected: CAR_SERVICE_BIZ_TYPE, actual: detail.depositCategory });
  }
  await request('/sms/send', { orderNo, templateId: SMS_TEMPLATE[CAR_SERVICE_BIZ_TYPE].id });
  navigateToAlipayMiniProgram(MINI_APP[CAR_SERVICE_BIZ_TYPE]);
}

两段代码改的是同一处:错误版拿接口返回值决定模板和落地页,修复版按页面所属业务固定,只把不一致的返回值降级成一条上报。写死值只是当期止血办法,服务端新增接口替换发短信链路才是根治方向。代码为脱敏教学示例,只解释机制,不代表实际项目源码或已上线实现。

下次遇到这些场景要警惕

  • 页面用接口字段决定发通知、跳转或落地页时:先确认这个字段的口径归谁维护,再用另一条业务线的订单实测,看模板和落地页是否仍落在当前业务;对不上按页面所属业务兜底。
  • 多端下单、只在其中一端做完后续步骤时(例如微信下单、支付宝补免押):列出每个端能做什么,逐端走一遍“下单 → 引导短信 → 进小程序 → 办完 → 门店核销”,看引导入口是否落在能办这笔业务的小程序。
  • 打算给字段写死兜底之前:确认这个页面只属于一个业务、以后也不会复用;写死的同时要把不一致上报出来,否则错误值一直存在,只是不再被人看见。
  • 改动上线后:按模板 ID 反查近期短信与订单所属业务是否对得上,把错发的用户重新引导一次,不要只等下一单验证。