输入改完了,错误还挂在旧值上:一次异步校验竞态

0 阅读9分钟

用户名输入 bad,校验延迟 800ms 返回「不能为 bad」。趁它还没回来,改成 good——错误提示先消失了,半秒后又冒了出来。输入框里明明是 good。

这不是防抖没做,也不是 Promise 顺序反了,是旧请求的结果在写完界面之后才回来。异步校验天然有竞态,只是大多数表单没处理。

最小复现

const rules = {
  name: [{
    message: "不能为 bad",
    validator: (v) => new Promise((resolve) => {
      const delay = v === "bad" ? 800 : 20;
      setTimeout(() => resolve(v === "bad" ? "不能为 bad" : true), delay);
    }),
  }],
};

操作序列:

  1. 输入 bad,触发一次 800ms 的校验;
  2. 立刻全选改成 good,触发一次 20ms 的校验;
  3. good 的结果先回来,清空错误;
  4. 800ms 后 bad 的结果回来,把「不能为 bad」写了回去。

这条规则可以直接放进任何 Vue 3 表单复现。这类规则在业务里很常见:用户名查重、优惠券可用性、邀请码校验、手机号归属地——接口越慢,窗口越大。用户一边等一边改,旧结果就落在了新输入上。

实测日志(浏览器 performance.now(),单位毫秒):

时刻事件
2786msgood 校验开始
2878msgood 校验返回 true,错误清空
3300msbad 校验返回「不能为 bad」,错误重新出现

从 bad 到 good 只有两次输入,竞态已经出现;真实用户连续输入十几次时,窗口只会更多。从「值已经是 good」到「错误又出现」,中间隔了 422ms。用户看到的是:先好了,又坏了。422ms 足够让人再看一眼输入框,然后怀疑自己是不是没改成功。

0.2.31 前后的对照:

操作0.2.300.2.31
输入 bad → 改 good错误「不能为 bad」残留无错误
校验挂起数11
clearValidate 后等待旧错误被写回无错误
再输入 good无错误无错误

源码:await 之后无条件写 error

原来的 validate 很直白:

async function validate(trigger?: FormTrigger): Promise<boolean> {
  const value = getByPath(form.model, props.prop);
  try {
    for (const rule of activeRules) {
      const message = await checkRule(rule, value);
      if (message !== null) {
        error.value = message;   // 谁最后回来谁说了算
        return false;
      }
    }
  } catch {
    error.value = activeRules[0]?.message ?? t("form.validateFailed");
    return false;
  }
  error.value = "";
  return true;
}

这段代码的问题不在写法,而在缺失:它没有任何地方记录「现在是第几次校验」。value 在函数开头取一次,异步规则 await 期间用户改了值,这次校验仍然拿着旧值;它回来时不会检查「我是不是已经过期」,直接写 error。谁最后返回,谁就覆盖界面——和请求的发起顺序无关。

多规则串行时更容易出问题:

rules: [
  { validator: slowRemoteCheck },   // 800ms
  { validator: quickLocalCheck },   // 5ms
]

第一条慢规则在 await,用户改了值;第二条快规则用同一个旧 value 立即通过;旧 value 的慢规则最后返回失败,错误被写到新值上。规则越多,窗口越多。

clearValidate 也一样:它只把 error 置空,拦不住还在路上的校验。

修法:给每次校验编号

let validateSeq = 0;
let latestValidation: Promise<boolean> | null = null;

function validate(trigger?: FormTrigger): Promise<boolean> {
  const seq = ++validateSeq;
  const run = runValidate(seq, trigger);
  latestValidation = run;
  return run;
}

async function runValidate(seq: number, trigger?: FormTrigger) {
  const value = getByPath(form.model, props.prop);
  const stale = () => seq !== validateSeq;

  for (const rule of activeRules) {
    const message = await checkRule(rule, value);
    if (stale()) return latestValidation ?? true; // 过期:不写 error,等最新一次
    if (message !== null) { error.value = message; return false; }
  }
  if (stale()) return latestValidation ?? true;
  error.value = "";
  return true;
}

为什么用递增序号而不是随机 token:序号每次 +1,比较是单调的,不会出现「两次随机数相同」的极端情况;调试时还能直接从日志看出先后顺序。随机 token 的唯一优势是跨实例唯一,而校验序号本来就是每个 FormItem 实例自己的。

三个细节:

  1. 序号在函数入口自增,每次校验拿到自己的 seq;
  2. await 之后先检查 stale(),过期就立即返回,不碰 error;
  3. 过期调用返回最新一次校验的 Promise,而不是 false——否则上层 Form.validate() 会把一次已经过期的失败当成最终结论。

clearValidate 与 resetField 也要让在途校验作废:

function clearValidate() {
  validateSeq += 1;
  latestValidation = Promise.resolve(true);
  error.value = "";
}

为什么过期调用不能直接返回 false

Form.validate() 是逐字段 await field.validate() 的:

for (const field of fields) {
  const ok = await field.validate();
  if (!ok) return false;
}

如果过期调用返回 false,表单会在「用户已经改好」的情况下判为校验失败,提交被拦住。返回最新一次的结果,语义才是「以最后一次输入为准」。

这也解释了为什么 latestValidation 要保存一个 Promise 而不是一个布尔值:过期调用发生时,最新一次校验可能还没结束,只能等它。保存布尔值会在「最新还没回来」时给出旧结论。

测试:两条用例锁住竞态

it("旧值延迟返回,不覆盖新值", async () => {
  const rules = {
    name: [{
      message: "不能为 bad",
      validator: (v) => new Promise((resolve) => {
        setTimeout(() => resolve(v === "bad" ? "不能为 bad" : true), v === "bad" ? 60 : 5);
      }),
    }],
  };
  const { wrapper, model } = mountForm({ rules });
  const input = wrapper.find("input");
  await input.setValue("bad");
  await input.setValue("good");
  await new Promise((r) => setTimeout(r, 100));
  await flushPromises();
  expect(model.name).toBe("good");
  expect(wrapper.find(".rn-form-item__error").exists()).toBe(false);
});

第二条针对 clearValidate:输入 bad 后立刻清空校验,等 100ms,错误不应出现。两条用例在 0.2.30 上都是红的——旧结果会写回。

注意等待时间要大于最长规则的延迟,否则测的是「还没返回」,不是「返回后被忽略」。测试里的延迟不要用真实接口的随机耗时;固定 60ms / 5ms 才能稳定复现「先发后到」。

为什么要在每次 input 都校验,而不是等 blur 再校验?因为表单的即时反馈是这类规则的价值所在;等到 blur 才查重,用户已经填完下一项了。代价就是每次输入都可能发请求,竞态窗口成倍增加——这也是序号必须做在组件层,而不是让业务自己防抖的原因。

我以为是 A,实测是 B

第一处:我以为 await 的顺序能保证「后发起的先写」——只要用户改得快,新校验就会后完成。实测不是:规则延迟由值决定(bad 800ms、good 20ms),先发起的反而后完成,await 只保证单次调用内部的顺序,不保证多次调用之间的顺序。

第二处:我以为 clearValidate() 能把界面清干净。实测它只清了 error,在途校验回来照样写——用户点了「清除校验」,半秒后错误又出现。

第三处:我以为加防抖就能解决。防抖减少调用次数,但不能保证最后一次调用最后返回;只要规则延迟不同,竞态仍在。序号是必须的,防抖只是可选优化。两者解决的不是同一个问题:防抖控制「发多少次」,序号控制「哪次算数」。

第四处:我以为过期的调用返回 false 无所谓。实测表单级 validate() 会拿这个 false 当最终结果,把已经合法的表单判失败——这是比「错误文案残留」更严重的问题。

换成另一种实现

方案能解决什么问题
防抖减少请求次数不保证返回顺序
取消请求(AbortController)旧请求真的停下校验器要支持 signal;纯 Promise 规则无法取消
序号 / token(现方案)旧结果不写界面旧请求仍在跑,浪费一次计算
只保留最后一次 Promise上层拿到最新结论需要维护 latest 引用,逻辑略绕
校验结果带 value 对比值不同就丢弃值相同但规则变化时仍会误判

第三行是本次采用的:校验器是用户传进来的函数,组件无法强制它支持取消;序号是唯一不依赖校验器实现的方案,同步/异步规则都能用。第四行是配套:过期调用要等最新结果,不能自己编一个 false。

边界

  • 同步规则:await 一个非 Promise 值也会让出微任务,序号逻辑同样成立,不会误伤。
  • 多字段并发:序号是每个 FormItem 实例自己的,字段之间互不影响。
  • 组件卸载:卸载后 error 写入的是已销毁的 ref,不会报错但也没意义;序号方案天然安静。
  • 校验器自带缓存:如果校验器内部按参数缓存结果,序号管不到缓存返回的旧值;缓存 key 要带上值或版本。
  • 表单级 validate:它逐字段 await,字段内部的过期结果已经归一到最新,表单结论不会被旧值带偏。
  • 规则动态变化:rules 变了但值没变时,序号不增加,旧校验仍可能写回;如果业务会在校验期间换规则,需要把规则版本也纳入 token。
  • 异步规则抛错:catch 里同样要先判断 stale(),否则旧规则的异常也会写回错误文案。
  • validate() 的返回值:过期调用返回最新结果,意味着一次调用可能等两次规则的时间;表单提交的 loading 要按最长链路准备,不能假设「调用返回=本次规则跑完」。

结果

0.2.31 发布:

  • FormItem.validate 增加校验序号,过期结果不写 error,并返回最新一次校验的结果;
  • clearValidate / resetField 递增序号,让在途校验作废;
  • 新增「异步校验」示例(admin 延迟 300ms 失败,带当前值回显);
  • 单测 937 → 939,新增「旧值延迟返回」「clearValidate 后延迟返回」两条;
  • 真机 10/10(共 11 张修复前后对照图):0.2.30 在值改成 good 后仍显示「不能为 bad」、清空校验后错误又回来;0.2.31 两处都为空。

0.2.30:初始空值,无错误

输入 bad,800ms 的校验挂起,界面暂时没有错误

改成 good 后:值已是 good,错误却是「不能为 bad」

点清除校验并等待:旧校验把错误又写了回来

再输入 good:错误清空,但这是新校验的结果,不是修好了竞态

0.2.31:同样的初始状态

输入 bad,校验挂起

改成 good 后:错误保持为空,旧结果被丢弃

清除校验后等待:错误没有回来

再输入 good:仍然无错误

线上示例(0.2.31):输入 alice 后错误清空,admin 才失败

结论

异步校验不是「写完 validator 就完了」,它有三个必须处理的时刻:结果回来时,值可能已经变了;用户可能已经点了清除;上层可能正在等一个最终结论。

三条规则:

  1. 每次校验带序号,await 之后先判断是否过期;
  2. 过期调用不写状态,并返回最新一次校验的结果;
  3. clearValidate / resetField 也要递增序号,否则「清除」只是暂时的。

防抖和取消请求都能减少浪费,但都不能替代序号——顺序问题只能由顺序标记解决。竞态不会报错,只会让界面偶尔「抽风」;这类 bug 只能靠序号和用例提前挡住。

上线前可以按这张清单过一遍:1)慢规则返回时,值是否已经变了;2)clearValidate 后旧结果是否会回来;3)过期调用返回 false 会不会误伤提交;4)多规则串行时是否共用了旧 value;5)组件卸载后结果写到哪里。这五条里,前两条是用户能看见的,后三条是上线后才会在日志里发现的。


组件解剖 · 系列目录

  • Table:虚拟滚动的三个硬约束
  • Transfer:三态复选框的三个 bug
  • Select:可搜索下拉的键盘、ARIA 与滚动
  • Carousel:自动播放的暂停机制与播报时机
  • 验证码:v-model 的三种假同步
  • Form / FormItem(本篇):异步校验的竞态与序号

在线示例:ui.ruanno.top/components/… 源码:gitee.com/ruanno-top/…