发生了什么

调拨是把车辆从一个网点调到另一个网点。运营在手机端处理调拨时,页面上有一份待调拨车辆的清单,运营在这份清单里选出要调走的车,确认后按选中的数量提交调拨单。清单是分页加载的:一页装不下时,用户往下滑到底,页面会向服务端再要一页,把新拿到的车辆接在已有列表后面。

正常时,一页取回多少辆,列表就显示多少行。运营要调 25 辆,勾选 25 辆,页面上看到的也是 25 辆,提交出去的就是这 25 辆,看不出来任何异常。

这次不同:清单在加载过程中没有停下来,同一批车辆被接了两遍,25 辆显示成了 50 辆。清单里的车是重复的行,运营勾选和提交仍以车辆为准,实际提交的数量没有变,问题只出在页面显示上。这段滚动加载逻辑是十四个月前加进去的,一直留到这次才被反馈。

本质

一句话:列表组件用来判断“还要不要再取一页”的加载状态从来没有被正确维护,组件以为没有请求在进行,于是反复触发加载,把同一页车辆追加了两遍。

  1. 这份清单用移动端的滚动列表组件做分页。组件自己不取数,它只在合适的时机调用页面写的加载方法;判断“现在要不要再调一次”的依据,是页面传给它的加载状态。
  2. 页面的数据里并没有定义这个加载字段,模板却用 v-model="loading" 把它双向绑给了组件。组件读到的始终是空值,看到的就是“没有任何加载在进行”。
  3. 加载方法里也没有维护这个状态:请求发出前不置为“加载中”,请求结束后也不置回“空闲”。
  4. 于是第一批车辆还没返回,组件就认为可以再取一页,又调用了一次加载方法。
  5. 页码要等请求返回之后才加一,两轮调用用的是同一个页码,取回来的是同一批车辆。两份结果先后被接进同一个数组,清单里就出现了两遍。
  6. 页面显示 50 辆,而提交时仍以车辆为准,实际提交的仍是 25 辆。这也是为什么问题只影响看,不影响调拨结果。
  7. 修复是把加载状态声明出来,模板改成只单向传入、不再用 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 绑定组件状态:改之前先看这个字段有没有在数据里声明;没声明时组件读到的是空值,双向绑定还会把值写到一个页面上看不见的地方。
  • 看到列表条数与勾选数、提交数对不上:先比对列表数组长度和按车辆编号去重后的数量,再抓接口返回,区分是页面把同一份数据放了两遍,还是后端真的返回了重复记录。
  • 异步加载失败之后:检查加载状态是否在失败分支也复位;只看成功路径的话,一次失败就可能让后续加载停住或反复触发。