发生了什么

换电业务里,电池按规格分成不同的“电池类目”,比如 48V20AH 这一类,同一台电柜能放进哪些类目是固定的。运营要把电池从别处调到某个网点、再放进该网点的电柜时,走的是后台的“人工调度工单”:值班人员在页面上先选网点,再选要调入的电池类目、填数量,提交后系统生成一张调度工单,后续按这张单子把电池调过去。

正常流程是:选完网点,页面拿到这个网点下的电柜列表,再用这些电柜支持的类目把“电池类目”下拉填满;值班人员选一个类目,填好数量提交,工单就生成出来。

这次出问题的网点刚投了一台新电柜,柜里还一颗电池都没有。值班人员照常建单,进到调入电池这一步时,电池类目下拉是空的,没有任何可选项,提交一直不成功。页面给出的提示是“软件版本过低,请先升级最新版本”,讲的是客户端版本,实际把提交拦下来的却是那个空的必填项。当时可用的绕过办法,是先往电柜里放一颗电池,再回来建单。

本质

问题在页面取类目那一步的判断条件:它只认“电柜数量恰好等于 1 台”这一种情况。

  1. 页面进入调入电池这一步,先看网点下有几台电柜。原来的写法是判断电柜列表长度是否等于 1,只有等式成立,才去读那台电柜支持的电池类目。
  2. 网点新投放一台电柜后,电柜数量不再是恰好一台,等式不成立,这个分支整个被跳过,页面一个类目都没有取到。
  3. 类目是提交时的必填项,下拉为空就等于填不上值,页面只能把提交拦下来,工单没有生成。
  4. 提示语和真正的原因对不上:拦下提交的是空类目,页面提示的却是版本过低,按提示去升级客户端不会有任何变化,排查也容易被带偏。
  5. 还有一处相邻问题:选完电柜之后,页面没有按所选的这台电柜重新算一遍类目,多电柜的网点即使有默认值,也不会跟着选择变化。

修复方向是:只要电柜数量大于 0,就取第一台电柜的类目作为默认值;用户切换电柜后,再按选中的电柜重新渲染类目。记录里标注该修复已经发版上线,上线之后的验证结果没有记录。

判断条件写成“只有一台才取值”,网点一多一台电柜就取不到类目,必填下拉直接空掉。

下面的代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 网点调入电池:渲染电池类目下拉(脱敏教学示例)
Page({
  data: { cabinetList: [], categoryOptions: [], form: { cabinetId: '', categoryCode: '' } },

  onSiteChange(site) {
    const cabinetList = site.cabinetList || [];
    this.setData({ cabinetList });

    // 为什么错:把“网点有电柜”写成了“恰好只有 1 台电柜”。
    // 新加一台电柜后长度不再等于 1,这里整段跳过,类目一个都不取,下拉是空的
    if (cabinetList.length === 1) {
      this.setData({ categoryOptions: cabinetList[0].supportedCategories });
    }
  },

  onSubmit() {
    // 为什么错:类目是必填项,空值直接被拦下,
    // 页面却只提示“软件版本过低”,把排查引向版本升级
    if (!this.data.form.categoryCode) {
      return wx.showToast({ title: '软件版本过低,请先升级最新版本' });
    }
    createDispatchOrder(this.data.form);
  },
});

修复代码示例

// 同一页面:有电柜就取默认类目,并跟着所选电柜重算(脱敏教学示例)
Page({
  data: { cabinetList: [], categoryOptions: [], form: { cabinetId: '', categoryCode: '' } },

  onSiteChange(site) {
    const cabinetList = site.cabinetList || [];
    // 修复:大于 0 就取第一台电柜的类目作为默认,不再要求恰好一台
    const first = cabinetList[0];
    this.setData({
      cabinetList,
      categoryOptions: first ? first.supportedCategories : [],
      'form.cabinetId': first ? first.cabinetId : '',
      'form.categoryCode': first ? first.supportedCategories[0] : '',
    });
  },
  onCabinetChange(cabinetId) {
    // 修复:换了电柜就按这台电柜重新算类目,不停留在上一台电柜的选项上
    const cabinet = this.data.cabinetList.find((item) => item.cabinetId === cabinetId);
    this.setData({
      'form.cabinetId': cabinetId,
      categoryOptions: cabinet ? cabinet.supportedCategories : [],
      'form.categoryCode': '',
    });
  },
});

下次遇到这些场景要警惕

  • 给下级选项填默认值时,先把上级对象的数量造成 0 个、1 个、多个三种情况,各走一次表单,观察下拉是否有选项、默认值是否落在第一个对象上。
  • 网点或门店新加设备后,把“设备数量”本身当测试数据:新增一台、下掉一台、只剩一台,分别提交一次,确认必填下拉不空、提交能过。
  • 表单因为空值被拦下时,先核对页面提示指向的是不是这个字段;版本过低、网络异常这类无关提示,会把排查带到别的方向。
  • 上级选择项变化后,检查依赖它的下级选项有没有重新计算,而不是沿用上一次取到的值。