用户名输入
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);
}),
}],
};
操作序列:
- 输入
bad,触发一次 800ms 的校验; - 立刻全选改成
good,触发一次 20ms 的校验; good的结果先回来,清空错误;- 800ms 后
bad的结果回来,把「不能为 bad」写了回去。
这条规则可以直接放进任何 Vue 3 表单复现。这类规则在业务里很常见:用户名查重、优惠券可用性、邀请码校验、手机号归属地——接口越慢,窗口越大。用户一边等一边改,旧结果就落在了新输入上。
实测日志(浏览器 performance.now(),单位毫秒):
| 时刻 | 事件 |
|---|---|
| 2786ms | good 校验开始 |
| 2878ms | good 校验返回 true,错误清空 |
| 3300ms | bad 校验返回「不能为 bad」,错误重新出现 |
从 bad 到 good 只有两次输入,竞态已经出现;真实用户连续输入十几次时,窗口只会更多。从「值已经是 good」到「错误又出现」,中间隔了 422ms。用户看到的是:先好了,又坏了。422ms 足够让人再看一眼输入框,然后怀疑自己是不是没改成功。
0.2.31 前后的对照:
| 操作 | 0.2.30 | 0.2.31 |
|---|---|---|
| 输入 bad → 改 good | 错误「不能为 bad」残留 | 无错误 |
| 校验挂起数 | 1 | 1 |
| 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 实例自己的。
三个细节:
- 序号在函数入口自增,每次校验拿到自己的
seq; - await 之后先检查
stale(),过期就立即返回,不碰error; - 过期调用返回最新一次校验的 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 两处都为空。
结论
异步校验不是「写完 validator 就完了」,它有三个必须处理的时刻:结果回来时,值可能已经变了;用户可能已经点了清除;上层可能正在等一个最终结论。
三条规则:
- 每次校验带序号,
await之后先判断是否过期; - 过期调用不写状态,并返回最新一次校验的结果;
clearValidate/resetField也要递增序号,否则「清除」只是暂时的。
防抖和取消请求都能减少浪费,但都不能替代序号——顺序问题只能由顺序标记解决。竞态不会报错,只会让界面偶尔「抽风」;这类 bug 只能靠序号和用例提前挡住。
上线前可以按这张清单过一遍:1)慢规则返回时,值是否已经变了;2)clearValidate 后旧结果是否会回来;3)过期调用返回 false 会不会误伤提交;4)多规则串行时是否共用了旧 value;5)组件卸载后结果写到哪里。这五条里,前两条是用户能看见的,后三条是上线后才会在日志里发现的。
组件解剖 · 系列目录
- Table:虚拟滚动的三个硬约束
- Transfer:三态复选框的三个 bug
- Select:可搜索下拉的键盘、ARIA 与滚动
- Carousel:自动播放的暂停机制与播报时机
- 验证码:v-model 的三种假同步
- Form / FormItem(本篇):异步校验的竞态与序号