发生了什么

客户端里有一个按城市提供商品的服务页。用户在某座城市打开页面,能看到这座城市在售的商品(可以理解为可售的服务项)。页面上每一条商品都来自服务端的“商品是否可售”查询,这个查询不只看商品编号,还要知道是哪个城市的哪个渠道:每座城市在商品配置里对应一个城市渠道编号(示例字段名 cityChannelId)。这个编号是查询的必填参数,缺了就定位不到这座城市的商品配置。

页面还接入了实验分流。同一个页面,不同用户可能被分到不同的配置组,页面后续要用的参数跟着实验结果走。正常流程是:用户进入页面,页面先取一次实验结果,确定分组和这组要用的城市渠道编号;再用同一个编号查商品列表、渲染页面;用户点某件商品时,沿用同一份结果里的参数继续请求。列表按哪组渲染,点击就按哪组取参数,两边始终一致。

九月十九日的版本里,开发把页面改成按城市做实验分流:用户切换城市,就必须重新取一次新城市的实验结果。九月二十五日上午,监控收到一条服务告警,报出的是商品可售查询接口的错。网关日志显示,同一个来源在一分钟内向这个接口发起了三百多次请求,全部没有带城市渠道编号。起初怀疑是异常流量,查了网关日志后排除——同一时间段内,这个来源还正常访问了其他业务的接口,行为模式和普通用户一致。

结果是,这些请求因缺少必填参数被服务端拒绝,接口报错并触发告警;接口被拒后,页面在这次操作里也拿不到该商品的可售结果。

本质

一句话:页面渲染列表用的是上一次的实验结果,用户点击时读的却是最新一次实验结果,弱网下两次结果来自不同分组,按新分组取不到城市渠道编号,请求就把这个必填参数漏掉了。

  1. 原流程只有一次读取:进页面取实验,拿到分组和这组对应的城市渠道编号,再查列表、渲染、点击,前后同一个来源,不会互相打架。
  2. 切城改变了这个前提:切换城市后必须重新取新城市的实验结果,而取实验是一次异步请求,结果不会立刻回来。
  3. 弱网下这次请求返回更慢。实验平台对这一跳有 3 秒超时,超时后启用对照组——也就是说,结果一定会回来,只是可能晚于用户的下一步操作。
  4. 页面没有等结果就继续往下走,列表仍按上一次的实验结果渲染,页面看上去是完整的、可点的。
  5. 用户点商品时,代码读的是“当前最新”的实验结果。如果此时新结果已经到达,点击取到的是新分组,而列表还是旧分组的那批商品。
  6. 按新分组去取城市渠道编号,在这批商品上取不到对应值,参数为空;请求照常发出,服务端拿不到城市渠道编号,直接判为缺参报错。

同一份实验配置被页面分两处各取一次,中间隔着一个异步请求,用户看到的和点下去的就可能来自两个分组。

至于一分钟三百多次调用,是另一条线索:它只出现过一次,参数问题修复后前端和服务侧仍在继续观察,成因没有确认。参数缺失和调用量陡增是两件事,不把后者归到这个原因上。

修复方向是:用户发起城市切换、重新取实验结果时,先把页面置成加载中,等实验结果返回后再加载页面,让列表渲染和用户操作基于同一份结果;实验有 3 秒超时并回落对照组,所以加载不会无限持续。问题已标记为完成,但修复后是否做过验证、结果如何,没有说明。

下面两段 JavaScript 是脱敏教学示例,只对比页面读取实验结果的时机,不代表实际项目源码或已上线实现。

错误代码

// 教学示例:切城后重新取实验,但渲染和点击各读一次结果
let experiment = null;

async function loadExperiment(city) {
  experiment = await abClient.fetch({ scene: 'goodsPage', city });
}

async function onCityChange(city) {
  loadExperiment(city);        // 为什么错:没有等结果,也没有挡住页面
  renderGoods(experiment);     // 为什么错:列表用的还是上一次的实验结果
}

function renderGoods(exp) {
  const list = goodsApi.list({ cityChannelId: exp.cityChannelId });
  // 为什么错:点击回调读全局最新结果,那时可能已经换成新分组
  list.forEach(g => bindClick(g, () => openGoods(g, getExperiment())));
}

function openGoods(goods, exp) {
  // exp 与渲染列表的那份结果不是同一次,参数可能取不到
  request('/goods/exists', { goodsId: goods.id, cityChannelId: exp && exp.cityChannelId });
}

修复代码示例

// 修复示例:切城时先置加载中,结果回来后再渲染,并把这份结果一路传下去
let experiment = null;

async function onCityChange(city) {
  setPageLoading(true);        // 结果回来前挡住操作入口
  try {
    experiment = await abClient.fetch({ scene: 'goodsPage', city });  // 等新结果
    renderGoods(experiment);   // 列表按这一份结果渲染
  } finally {
    setPageLoading(false);
  }
}

function renderGoods(exp) {
  const list = goodsApi.list({ cityChannelId: exp.cityChannelId });
  // 点击沿用渲染时的同一份结果,不再读全局最新值
  list.forEach(g => bindClick(g, () => openGoods(g, exp)));
}

function openGoods(goods, exp) {
  if (!exp || !exp.cityChannelId) {
    return;                    // 取不到编号就不发请求,避免缺参打到服务端
  }
  request('/goods/exists', { goodsId: goods.id, cityChannelId: exp.cityChannelId });
}

下次遇到这些场景要警惕

  • 页面按城市、门店等维度重新拉取实验或配置时:用弱网或人为延迟这次请求,切换几次维度后立刻点列表项,检查列表数据和点击参数是否来自同一次结果,而不是看页面有没有渲染出来。
  • 同一份配置在页面里被两处以上读取时:改成加载时读一次、把这份结果往下传;再全局搜一遍,确认没有地方在点击时直接读这份配置的“最新值”。
  • 异步配置是页面渲染的前置条件时:结果回来之前把页面置成加载中或禁用操作入口,不要先拿旧数据把列表铺上去、再让用户点,尤其要覆盖超时回落的路径。
  • 接口报“缺必填参数”且调用量同时陡增时:把两条线索分开查——参数来源查页面赋值链路,调用量查客户端是否重复触发或重试,不要用一个原因同时解释两个现象。