发生了什么
换电业务的用户端 App 里有一个订单列表页,用户在这里集中查看自己的订单:买过什么套餐、换过几次电、哪一笔还没结束。订单按业务类型分成七类,页面进入时按这些类型分别向服务端查询,结果回来后按页签分开展示。用户从列表点进某一笔订单,才能继续办理后面的操作,三方渠道用户的免押入口就在这条订单链路上。
正常流程是:用户打开订单列表页 → 页面按七个订单类型分别取数 → 拿到结果后渲染列表 → 用户点进某笔订单继续操作。
8 月中旬,业务人员在一个灰度群里反馈:有用户点不开订单列表,免押入口也进不去。开发按这位用户去查服务端请求记录,看到列表页那一屏并没有调用服务端的灰度接口;用户退出后重新进入,页面又能打开;同一个人换另一个支付渠道的入口进去,也是正常的。当时对这位用户身份的取值也有疑问,联系不上用户,没能进一步确认。
开发把原因归到前端一段历史逻辑上:七个订单类型的查询必须全部成功,页面才渲染列表;任意一类失败,异常会被统一捕获,页面就停在不能展示的状态。8 月 28 日发布了一版改动,把这一屏改成按当前页签懒加载,只请求当前展示的订单页面对应的接口,不再顺带拉其它类型的订单。
本质
一句话:页面把七类订单的查询绑成一个整体,任何一类失败都会让整页不可用。
- 页面进屏时不是"查一类、渲染一类",而是先把七类订单的查询一起发出去,等全部成功之后再一次性渲染列表。
- 这七个请求共用一个失败处理。任何一类返回错误、超时或者被拦下,都会走到同一个异常分支。
- 异常分支里只结束加载状态:不渲染列表、不给失败提示、也没有重试入口。用户看到的就是点不开、进不去。
- 用户退出重进等于重新走一遍初始化,这一次七类都成功,页面就恢复。所以现象是偶现,"退出重进能好"也是由此而来。
- 改成按页签取数之后,一类失败只影响它自己的页签,其它页签照常展示,失败也能单独暴露出来重试。
需要说清的是,这次的现象里连请求都没有发出去,具体中断在哪一步,记录里没有定论,测试在生产与 UAT 也都未能复现。能确定的是这段聚合逻辑的失败方式:它把单类失败放大成整页不可用。至于是哪一类、因为什么失败,没有被抓到。
一屏依赖多个请求时,"全部成功才渲染"等于把每个请求的失败都升级成整页打不开。
错误代码
// 订单列表页:进入时把七类订单的查询一起发出(脱敏教学示例)
const ORDER_TYPES = ['type1', 'type2', /* …共 7 类 */ 'type7'];
async function loadOrderList(page) {
const requests = ORDER_TYPES.map(type => orderApi.list({ type }));
try {
// 为什么错:七类订单绑在同一个 Promise.all 上,
// 任意一类失败都会让整个结果 reject,七类的数据一起丢掉
const groups = await Promise.all(requests);
page.list = groups.flat();
page.render();
} catch (e) {
// 为什么错:失败只关掉加载态,不渲染、不提示、不给重试,
// 用户看到的是整页不展示,只能退出重进
page.loading = false;
}
}
修复代码示例
// 修复:按当前选中页签,只查该页需要的订单类型(脱敏教学示例)
const TAB_TYPES = {
all: ['type1', 'type2'], // 页签与订单类型的对应关系按已确认的展示规则配置
charging: ['type3', 'type4'],
deposit: ['type5']
};
async function loadTab(page, tab) {
page.currentTab = tab;
try {
// 修复:只请求当前页签对应的接口,不再等七类全部成功
const list = await orderApi.list({ types: TAB_TYPES[tab] });
page.list = list;
page.render();
} catch (e) {
// 修复:只有当前页签失败,其它页签不受影响,失败状态交给页面展示
page.error = e.message; // 页面据此给出失败提示和重试入口
page.render();
}
}
下次遇到这些场景要警惕
- 一个页面要凑多类数据才展示:把这一屏依赖的接口逐条列出来,对每一条单独制造失败(超时、返回错误、返回空数据),看页面还剩多少可用区域、有没有看得见的失败提示和重试入口。
- 用户说"点不开",退出重进又好了:先确认请求有没有真的发出去,再逐条核对这一屏依赖的接口,不要只翻单个接口的日志就下结论。
- 把整屏取数改成按页签懒加载:切页签、快速来回切换、某个页签失败后切走再切回,检查各页签的数据不会串、不会残留成上一页的内容。
- 同一用户在不同入口表现不同:先确认各入口进的是哪一版页面、哪个开关,再判断是不是前端逻辑问题,不要按单一接口方向排查。