发生了什么
调拨是把车辆从一个网点调到另一个网点。运营在手机端处理调拨时,页面上有一份待调拨车辆的清单,运营在这份清单里选出要调走的车,确认后按选中的数量提交调拨单。清单是分页加载的:一页装不下时,用户往下滑到底,页面会向服务端再要一页,把新拿到的车辆接在已有列表后面。
正常时,一页取回多少辆,列表就显示多少行。运营要调 25 辆,勾选 25 辆,页面上看到的也是 25 辆,提交出去的就是这 25 辆,看不出来任何异常。
这次不同:清单在加载过程中没有停下来,同一批车辆被接了两遍,25 辆显示成了 50 辆。清单里的车是重复的行,运营勾选和提交仍以车辆为准,实际提交的数量没有变,问题只出在页面显示上。这段滚动加载逻辑是十四个月前加进去的,一直留到这次才被反馈。
本质
一句话:列表组件用来判断“还要不要再取一页”的加载状态从来没有被正确维护,组件以为没有请求在进行,于是反复触发加载,把同一页车辆追加了两遍。
- 这份清单用移动端的滚动列表组件做分页。组件自己不取数,它只在合适的时机调用页面写的加载方法;判断“现在要不要再调一次”的依据,是页面传给它的加载状态。
- 页面的数据里并没有定义这个加载字段,模板却用
v-model="loading"把它双向绑给了组件。组件读到的始终是空值,看到的就是“没有任何加载在进行”。 - 加载方法里也没有维护这个状态:请求发出前不置为“加载中”,请求结束后也不置回“空闲”。
- 于是第一批车辆还没返回,组件就认为可以再取一页,又调用了一次加载方法。
- 页码要等请求返回之后才加一,两轮调用用的是同一个页码,取回来的是同一批车辆。两份结果先后被接进同一个数组,清单里就出现了两遍。
- 页面显示 50 辆,而提交时仍以车辆为准,实际提交的仍是 25 辆。这也是为什么问题只影响看,不影响调拨结果。
- 修复是把加载状态声明出来,模板改成只单向传入、不再用
v-model回写;加载方法在请求前置为加载中,成功或失败都在最后复位。这样组件能等到这一轮结束,再决定要不要取下一页。修复上线后的验证结果没有记录。
加载状态既没声明也没复位,组件就判断不出请求是否在进行,同一页会被反复取回并追加。
下面两段代码是按上述机制写的最小教学示例,用于对比“状态缺失”和“状态完整”两种写法,不代表实际项目源码或已上线实现。示例中的页码和车辆字段均为示意。
错误代码
// 模板:<van-list v-model="loading" :finished="finished" @load="onLoad">
export default {
data() {
return {
// 为什么错:没有声明 loading,组件经 v-model 读到的始终是空值,
// 判断不出“正在加载”,列表没铺满就会再次触发 onLoad
vehicleList: [],
pageNo: 1,
finished: false
};
},
methods: {
async onLoad() {
// 为什么错:请求前不置加载中、结束后不置回空闲,
// 上一轮还没返回,组件就放行了下一轮
const res = await this.fetchVehicles(this.pageNo);
// 为什么错:页码要等返回后才加一,并发的两轮读到同一页,
// 同一批车辆被接了两遍
this.vehicleList = this.vehicleList.concat(res.rows);
this.pageNo += 1;
if (res.rows.length === 0) this.finished = true;
}
}
};
修复代码示例
// 模板:<van-list :loading="loading" :finished="finished" @load="onLoad">
export default {
data() {
return {
loading: false, // 声明出来交给组件判断,不再用 v-model 回写
vehicleList: [],
pageNo: 1,
finished: false
};
},
methods: {
async onLoad() {
if (this.loading) return; // 上一轮未结束,不再进入
this.loading = true; // 请求发出前就告诉组件“在加载”
try {
const res = await this.fetchVehicles(this.pageNo);
this.vehicleList = this.vehicleList.concat(res.rows);
this.pageNo += 1;
if (res.rows.length === 0) this.finished = true;
} finally {
this.loading = false; // 成功或失败都复位
}
}
}
};
下次遇到这些场景要警惕
- 给列表接入滚动或分页加载:先确认组件判断加载状态的那个字段在数据里有声明,并在请求发出前、结束后各赋值一次;然后滑到底,数网络面板里同一页码请求了几次、列表行数是不是接口返回条数的整数倍。
- 用
v-model绑定组件状态:改之前先看这个字段有没有在数据里声明;没声明时组件读到的是空值,双向绑定还会把值写到一个页面上看不见的地方。 - 看到列表条数与勾选数、提交数对不上:先比对列表数组长度和按车辆编号去重后的数量,再抓接口返回,区分是页面把同一份数据放了两遍,还是后端真的返回了重复记录。
- 异步加载失败之后:检查加载状态是否在失败分支也复位;只看成功路径的话,一次失败就可能让后续加载停住或反复触发。