发生了什么

换电业务的小程序里,用户要先买一份套餐,之后才能在电柜上换电池。套餐页除了列出可选套餐,还会告诉用户自己是在哪个商户这里下的单。商户是接入换电业务的商家,每家有一张自己的二维码(商户码),用户用手机扫一扫就直接进到这个小程序的套餐页。二维码链接里带着一个商户编号(merchantId):页面用它查出商户名称显示出来,下单时再把这个编号一起提交,订单落库后就会写上这笔订单属于哪家商户,这个字段在业务里叫商户溯源。

正常流程是:用户扫商户码 → 打开套餐页,页面从链接参数里取到商户编号 → 页面显示商户名称 → 提交订单时带上同一个编号 → 订单归属到这家商户。

这一期做了一次融合改造,把换电业务接进更大的入口,同时要适配不同机型的页面跳转。开发发现,安卓支付宝端从中间页面、活动页直接跳到 tabbar 页面(小程序底部导航栏对应的几个主页面,比如首页、套餐页、我的)时,页面堆栈会出现兼容问题。于是这类跳转被统一改成 navigateTo 和 redirectTo 两种页面跳转接口,改造后的链路也变长了:首页 → 点击活动 → 内嵌活动页 → 点击自定义跳转 → 换电中间页面 → 重定向回套餐页 → 再切换回首页。

问题就出在这条新链路上。navigateTo 和 redirectTo 跳到 tabbar 页面时,链接上的参数无法被解析,套餐页拿不到商户编号:页面上显示不出商户名称,只剩一个定位地址;下单请求里也没有带商户编号,订单落库时商户溯源字段是空的。受影响的主要是新客,以及流失一个月以上又回来的复购客户,他们的商户归属完全依赖这一次扫码带进来的编号。时间窗从 11 月底一直到次年 1 月上旬,安卓支付宝端的那一版小程序下出来的订单,都没有归属到商户码对应的商户。截止统计有两百多笔订单、一百七十多个商家,已按这些订单做了数据修正。

本质

一句话:为了解决安卓端的页面堆栈问题,跳转方式被换成了 navigateTo 和 redirectTo,但 tabbar 页面在这套框架里不接收链接参数,改跳转的同时把扫码带进来的商户编号这条唯一来源一起弄丢了。

  1. 原流程里,商户编号只有一个来源:用户扫的那张商户码。链接带着编号打开套餐页,页面读参数、显示商户名、下单时回传,三处用的是同一个值。
  2. 因为安卓端的页面堆栈不兼容,开发把跳转方式换成 navigateTo 和 redirectTo。这一步是为跳转本身服务的,改完只确认了“能不能跳到目标页”。
  3. 目标页是 tabbar 页面。这类页面要用专门的切换方式打开,且不解析链接上的查询参数,于是编号在跳转过程中被丢掉,套餐页的启动参数里没有它。
  4. 套餐页拿到空编号,两个后果一起出现:查不到商户,页面退化成只显示定位地址;下单请求里也没有编号,订单的商户溯源字段落成空值。
  5. 旧的扫码链路是直达套餐页,参数一直在;这次链路中间多了一层重定向和一次首页切换,只有走改造过的安卓跳转才会丢参。回归时看的是页面能不能打开、活动能不能跳,没有检查跳完之后参数还在不在,于是这个已经回归过的功能点没有被发现。

修复方式是在跳 tabbar 页面之前,主动把页面参数写进全局存储,目标页再从全局存储里取回来;用 index > -1 判断是否命中了 tabbar 页面,只对命中的情况走这套补参数逻辑,以减小改动影响面。这套改动是否已全量上线、验证结果如何,记录里没有写。下面是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

能跳过去不等于参数还在:换掉跳转接口时,带参链路要按目标页面的类型重新确认一遍。

错误代码

// 套餐页:扫商户码进入时,从启动参数里取商户编号(脱敏教学示例)
Page({
  onLoad(options) {
    // 商户名称、下单归属都依赖这一个值
    this.merchantId = options.merchantId;
    this.loadMerchant(this.merchantId);
  },
  onSubmit() {
    orderApi.create({ planId: this.planId, merchantId: this.merchantId });
  }
});

// 活动页:为解决安卓端页面堆栈问题,跳转统一改成 navigateTo / redirectTo
function gotoPlanPage(merchantId) {
  // 为什么错:目标页是 tabbar 页面,框架只允许用专门的切换方式打开它,
  // 链接上带的 merchantId 不会被解析,套餐页 onLoad 的 options 里没有它
  my.navigateTo({ url: '/pages/plan/index?merchantId=' + merchantId });
}

修复代码示例

// 跳 tabbar 页面之前先把参数转存,目标页再取回(脱敏教学示例)
const TAB_PAGES = ['/pages/home/index', '/pages/plan/index', '/pages/mine/index'];

function gotoPlanPage(merchantId) {
  const url = '/pages/plan/index';
  const index = TAB_PAGES.indexOf(url);
  if (index > -1) {
    // 修复:index > -1 说明命中 tabbar 页面,它不接收链接参数,跳转前转存到全局存储
    getApp().globalData.pageParams = { merchantId: merchantId };
    my.switchTab({ url: url });
  } else {
    my.navigateTo({ url: url + '?merchantId=' + merchantId });
  }
}

Page({
  onLoad(options) {
    const cached = getApp().globalData.pageParams || {};
    // 修复:优先用链接参数,命中 tabbar 的跳转从全局存储补回
    this.merchantId = options.merchantId || cached.merchantId;
    // 取完即清,避免下一次进入读到上一个商户的编号
    getApp().globalData.pageParams = null;
    this.loadMerchant(this.merchantId);
  }
});

下次遇到这些场景要警惕

  • 准备批量替换页面跳转接口时:先把目标页面清单列出来,标出哪些是 tabbar 页面。凡是带参数的入口,逐个走完并核对目标页拿到的是不是来源页的同一个值,不能只看“跳过去了没有”。
  • 扫码、分享、推送这类从外部带参进入的入口:它们往往是参数的唯一来源。改完跳转链路后,用真机从扫码入口完整走一遍,检查页面上的商户名称和提交出去的归属编号。
  • 页面只显示定位地址、没有商户名称:把这种“缺省的展示”当参数缺失的信号去查,同时看下单请求体里关键编号是不是空的,不要当成纯展示问题。
  • 用全局存储补参数这类修复:验证取参后是否清理、连续扫两个不同商户的码、返回后再次进入这几种场景,确认不会串用上一个商户的编号。