发生了什么
商家端 App 里有一个车辆订单列表。商家打开后能看到自己名下的车辆,每辆车占一行,行里带这辆车的订单信息,商家靠这个列表核对车辆和使用情况。正常情况下,同一辆车在列表里只出现一次。
这个列表用的是移动端常见的 van-list 组件。它管两件事:用户下拉时通知页面执行刷新方法,组件认为数据还没加载完时通知页面执行加载方法。页面进入时先取一次车辆数据;用户下拉刷新时,期望的是把列表重新取一遍,用新结果替换旧内容,而不是在旧内容后面再接一份。
这次的现象是偶现的:商家下拉刷新之后,列表里同一辆车出现了两行。车辆订单列表是用来核对车辆和订单的,同一辆车占两行,会让人以为这辆车有两笔订单。当时这个页面并没有分页诉求,一次就把车辆全部取回来,所以团队也没有把“分页加载”当成需要覆盖的路径,问题只在特定时序下才露出来。
本质
问题不在接口多返回了数据,而在同一次下拉刷新触发了两次取数。
- 用户下拉,页面先执行刷新方法。它把 finished 置为 false,然后自己调用了一次车辆列表接口,这是第一份请求。
- finished 是告诉 van-list“还有没有下一批数据”的状态。它刚从 true 变回 false,组件就认为列表还没加载完,于是按自己的规则调用加载方法。
- 加载方法里同样调用车辆列表接口,发出第二份请求。到这里,同一个页面、同一批车辆,已经被请求了两遍。
- 列表的更新方式是把返回结果接在现有数组后面,这是分页加载的常规写法。两份结果都接进来,同一辆车就占了两行。
- 两次请求谁先返回并不固定,所以不是每次下拉都能看到重复。数据本身没有重复:接口返回的车辆没有变多,库里也没有多出订单,只是同一份数据被取了两遍、又放了两遍。
一次下拉刷新触发两次取数,列表里就会出现两行同一辆车;重复的是页面请求,不是业务数据。
处理方式是删掉刷新方法里的手动调用,让刷新只负责重置状态,把取数交给 van-list 触发的那一次加载;如果列表是按追加方式更新的,刷新时还要先清空旧列表,否则新取回的数据会接在旧数据后面。取数只保留加载方法一个入口,列表就不会被追加两遍。修复上线状态待确认。
下面的代码为脱敏教学示例,用于说明这次重复请求的机制和改法,不代表实际项目源码或已上线实现。
错误代码
// 模板绑定:van-pull-refresh 的 @refresh 指向 onRefresh
// van-list 的 :finished="finished"、@load 指向 onLoad
async onRefresh() {
// 为什么错:finished 置回 false,等于告诉 van-list 列表还没加载完
this.finished = false;
// 为什么错:这里又手动请求一次,和组件即将触发的加载同时进行
const rows = await this.getVehicleList("");
this.list = this.list.concat(rows);
}
async onLoad() {
// 为什么错:组件因 finished=false 调到这里,同一批车辆再取一遍并追加
const rows = await this.getVehicleList("");
this.list = this.list.concat(rows);
}
修复代码示例
// 模板不变,@refresh 只重置状态,取数统一由 @load 触发
async onRefresh() {
this.list = []; // 先清空旧列表,避免新结果接在旧数据后面
this.finished = false; // 置回 false 后,van-list 会自动调用一次 onLoad
}
async onLoad() {
// 页面里唯一的取数入口,一次刷新只走到这里一次
const rows = await this.getVehicleList("");
this.list = this.list.concat(rows);
this.finished = true; // 该列表没有分页诉求,一次取完就标记结束
}
下次遇到这些场景要警惕
- 列表同时绑定下拉刷新和自动加载:先列出两个事件各自调用了什么方法,确认取数只有一个入口;然后下拉一次,看网络面板里列表接口发了几次请求、列表里同一辆车占几行。
- 修改 finished、loading 这类组件状态:改之前先确认哪些状态会触发组件自动发请求;把 finished 从 true 改回 false 后不要立刻手动取数,观察加载方法被触发几次,再决定是否还需要手动调用。
- 页面没有分页需求却用了带分页逻辑的组件:分别用“数据不足一屏”和“数据超过一屏”各测一遍下拉刷新,对比列表行数与接口返回条数,而不是只看第一屏是否正常。
- 看到列表里出现重复行:先查请求次数和返回内容,确认是页面取了两遍,还是后端真的返回了两条;按车辆或订单的业务编号比对,不要只靠肉眼数行。