Vue / 系统课时
同步与异步校验
同步与异步校验
表单校验需要同时处理本地规则、跨字段关系和服务端约束,还要保证异步请求返回乱序时不会覆盖最新结果。本节用一个完整 Vue 3 示例建立分层校验流程,并把错误稳定定位到具体字段。
学习目标
- 区分字段同步规则、跨字段校验和服务端异步校验
- 防止异步校验竞态,让旧请求不能覆盖新输入结果
- 在提交时统一收集错误,并把焦点定位到第一个失败字段
先确定校验顺序
同步规则应先执行,因为它成本最低,能快速拦截空值、长度和格式问题。跨字段规则依赖多个表单值,例如确认密码必须与密码一致。只有前两层通过后,才值得请求服务端检查用户名占用、优惠码有效性等业务约束。

用一份错误映射承载所有结果
错误状态最好按字段名存储,例如 Partial<Record<keyof FormModel, string>>。无论错误来自同步规则、跨字段还是服务端,都写回同一个映射,模板只负责展示,不需要知道错误来源。
下面的组件包含用户名必填与长度校验、密码确认的跨字段校验,以及模拟服务端用户名占用检查。异步部分使用递增序号避免竞态:输入变化后,较早请求即使更晚返回,也不能覆盖最新结果。
<script setup lang="ts">
import { nextTick, reactive, ref } from 'vue'
interface FormModel {
username: string
password: string
confirmPassword: string
}
type FieldName = keyof FormModel
type Errors = Partial<Record<FieldName, string>>
const form = reactive<FormModel>({
username: '',
password: '',
confirmPassword: '',
})
const errors = reactive<Errors>({})
const usernameInput = ref<HTMLInputElement | null>(null)
const passwordInput = ref<HTMLInputElement | null>(null)
const confirmInput = ref<HTMLInputElement | null>(null)
let usernameRequestId = 0
function validateSync(): boolean {
errors.username = form.username.trim().length >= 3 ? '' : '用户名至少 3 个字符'
errors.password = form.password.length >= 8 ? '' : '密码至少 8 个字符'
errors.confirmPassword =
form.confirmPassword === form.password ? '' : '两次密码不一致'
return !Object.values(errors).some(Boolean)
}
async function checkUsernameOnServer(name: string): Promise<boolean> {
await new Promise((resolve) => setTimeout(resolve, 120))
return name.toLowerCase() !== 'admin'
}
async function validateUsernameAsync(): Promise<boolean> {
const name = form.username.trim()
if (name.length < 3) return false
const requestId = ++usernameRequestId
const available = await checkUsernameOnServer(name)
// 只有最后一次请求可以更新当前错误状态。
if (requestId !== usernameRequestId) return false
errors.username = available ? '' : '用户名已被占用'
return available
}
async function focusFirstError() {
await nextTick()
const order: Array<[FieldName, HTMLInputElement | null]> = [
['username', usernameInput.value],
['password', passwordInput.value],
['confirmPassword', confirmInput.value],
]
order.find(([field]) => errors[field])?.[1]?.focus()
}
async function submit() {
if (!validateSync()) {
await focusFirstError()
return
}
if (!(await validateUsernameAsync())) {
await focusFirstError()
return
}
console.log('VALID', JSON.stringify(form))
}
</script>
<template>
<form @submit.prevent="submit">
<input ref="usernameInput" v-model="form.username" @blur="validateUsernameAsync" />
<p v-if="errors.username">{{ errors.username }}</p>
<input ref="passwordInput" v-model="form.password" type="password" />
<p v-if="errors.password">{{ errors.password }}</p>
<input ref="confirmInput" v-model="form.confirmPassword" type="password" />
<p v-if="errors.confirmPassword">{{ errors.confirmPassword }}</p>
<button type="submit">注册</button>
</form>
</template>预期结果
用户名少于 3 个字符时显示“用户名至少 3 个字符”。
用户名为 admin 时,异步校验后显示“用户名已被占用”。
两次密码不一致时显示“两次密码不一致”。
输入可用用户名且两次密码均不少于 8 个字符并一致时,控制台输出:
VALID {"username":"<VALUE>","password":"<VALUE>","confirmPassword":"<VALUE>"}<VALUE> 代表用户实际输入,运行时会不同。示例中的服务端校验用延时函数模拟;接入真实接口时只需替换 checkUsernameOnServer,竞态保护逻辑仍然适用。
处理异步校验竞态
典型竞态是用户先输入 admin,立刻改成 alice,但 admin 的请求最后才返回。如果不判断请求是否仍然对应当前输入,旧响应会把“用户名已占用”写回最新状态。递增请求序号、AbortController 或请求库的取消能力都可以解决这个问题。
提交按钮还应防止重复提交,但“提交中的禁用状态”和“字段异步校验状态”最好分开维护。前者控制整个提交事务,后者只表示某个字段正在验证,职责混在一起会导致按钮状态和错误状态难以判断。
让错误定位服务于用户修正
提交失败时,不要只弹一个“校验失败”提示。页面应保留字段旁错误文本,并把焦点移动到第一个失败字段。长表单还可以先滚动到错误区域,再聚焦输入控件;对于标签页或折叠面板,则要先展开包含错误的容器。
服务端最终提交仍可能返回业务错误,例如用户名在校验后被他人抢占。此时不要把它当作系统异常,而应把后端可归属到字段的错误重新写回 errors.username,让用户在原位置修正。
同步校验负责快速反馈,跨字段校验负责表达表单内部约束,异步校验负责确认服务端事实。三者共享统一错误映射,并通过竞态保护与焦点定位串成一条稳定的修正路径。