发生了什么

换电业务里,运营和一线运维要在后台页面处理电池调度工单:给一张工单指定这次投入多少块电池,不再需要时把工单取消。页面打开后,前端先按工单所属城市调用库存查询接口,查出这个城市当前可投入的电池,再据此渲染数量输入框和取消按钮。改版时为了打开页面不出现大片空白,给内容区加了骨架屏——数据还没回来之前,先用灰块占住这一块。

正常流程是:进入工单详情,前端请求库存接口,接口返回该城市可投入的电池列表;前端把骨架屏换成真实内容,运维填写数量并提交,或者直接取消工单。对于暂时没有可投入电池的城市,库存接口同样返回成功,只是数据为空。这是正常的业务结果,页面应该展示“暂无可用库存”一类的空状态。

这次出问题的是一个没有可投入库存的城市。前端判断“加载完成”的条件是接口返回里带 data;该城市返回的成功响应里没有数据,加载态就一直没被关闭,页面停在骨架屏上。运维看到的是:投入电池的数量不展示,取消工单也无法完成,整个页面像卡住。

处置时先回滚这次前端发布止血,页面退回旧版本。回滚之后,另一个正在推进的改动给取消工单接口增加了字段,发布时没有做兼容处理,调用方和接口对字段的约定对不上,取消请求直接报错,工单依旧取消不了。最后重新发布前端代码,接口报错消失,取消操作才恢复。

本质

库存接口对“这个城市没有可投入库存”返回成功且数据为空,是接口本来的约定,也是业务上真实存在的状态。加了骨架屏之后,前端把“加载是否结束”和“接口有没有返回数据”合并成了同一个判断,只有拿到非空数据才关闭骨架、才渲染内容。

  1. 请求发出前,前端把加载态置为进行中,页面显示骨架屏。
  2. 请求成功返回,但该城市的数据为空,前端既没有进入渲染分支,也没有执行关闭骨架的动作。
  3. 骨架屏一直占着内容区,数量没有地方渲染,取消按钮也没有进入可用状态,同一个加载态同时表现为“不显示数量”和“无法取消”。
  4. 回滚只撤掉了前端,取消工单接口新增的字段仍留在服务端,两端的字段约定不一致,接口直接报错,取消能力继续不可用。
  5. 重新发布与接口匹配的前端代码,字段对齐后操作恢复。

问题不在于某个城市没有数据,而在于前端把一个可以合法为空的返回值,当成了“请求还没结束”的信号。加载态应该由请求本身的生命周期来结束,数据为空只是结果的一种。同理,接口加字段只发布一端、不留兼容,等于让另一端按旧约定继续调用。

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

错误代码

// 错误版:加载态只在“拿到数据”时关闭
async function loadWorkOrder(orderId) {
  loading.value = true;                     // 打开骨架屏
  const order = await api.getWorkOrder(orderId);
  const stock = await api.queryCityStock(order.cityCode);

  if (stock && stock.data && stock.data.length) {
    // 为什么错:把“有数据”当成“请求结束”,无库存城市永远进不来
    stockList.value = stock.data;
    loading.value = false;                  // 骨架只在这里关闭
  }
  // 没有 else:请求其实已经成功返回,骨架却一直留着
}

async function onCancel(orderId) {
  // 页面仍在骨架态,取消入口不可用,再叠加接口字段不兼容的报错
  await api.cancelWorkOrder({ orderId });
}

修复代码示例

// 修复版:加载态跟随请求生命周期,空数据按正常业务结果渲染
async function loadWorkOrder(orderId) {
  loading.value = true;
  try {
    const order = await api.getWorkOrder(orderId);
    const stock = await api.queryCityStock(order.cityCode);
    // data 为空是合法结果:该城市没有可投入电池,按空列表展示
    stockList.value = (stock && stock.data) || [];
  } finally {
    loading.value = false;        // 成功、空数据、失败都关闭骨架
  }
}

async function onCancel(orderId) {
  // 只带双方已约定的字段;新增字段先确认旧调用方仍能解析
  await api.cancelWorkOrder({ orderId });
}

下次遇到这些场景要警惕

  1. 给页面加骨架屏或加载遮罩时,先确认它由什么信号关闭。关闭动作要放在请求结束的位置,覆盖成功、空数据、失败三种结果;把“拿到数据”当结束条件,遇到合法空值就会永久停在加载态。
  2. 空结果分支要用真实数据验证:挑一个确实没有可投入库存的城市打开工单页,看骨架屏是否消失、数量输入是否出现、取消是否可点。只测有数据的城市,这类问题一定测不出来。
  3. 接口新增字段前,列出所有调用方和发布节奏,确认字段缺失或多出时旧调用方仍能正常解析;只回滚其中一端时,要再确认另一端的新字段还能不能兼容。
  4. 线上出现“页面一直加载”,先把请求失败和“请求成功但数据为空”分开看:核对响应码和响应体里到底有没有数据,再去定位是加载态没关,还是渲染分支没覆盖。