Vue / 系统课时

同步与异步校验

同步与异步校验

表单校验需要同时处理本地规则、跨字段关系和服务端约束,还要保证异步请求返回乱序时不会覆盖最新结果。本节用一个完整 Vue 3 示例建立分层校验流程,并把错误稳定定位到具体字段。

学习目标

  • 区分字段同步规则、跨字段校验和服务端异步校验
  • 防止异步校验竞态,让旧请求不能覆盖新输入结果
  • 在提交时统一收集错误,并把焦点定位到第一个失败字段

先确定校验顺序

同步规则应先执行,因为它成本最低,能快速拦截空值、长度和格式问题。跨字段规则依赖多个表单值,例如确认密码必须与密码一致。只有前两层通过后,才值得请求服务端检查用户名占用、优惠码有效性等业务约束。

同步规则、跨字段规则与异步服务端校验流程

用一份错误映射承载所有结果

错误状态最好按字段名存储,例如 Partial<Record<keyof FormModel, string>>。无论错误来自同步规则、跨字段还是服务端,都写回同一个映射,模板只负责展示,不需要知道错误来源。

下面的组件包含用户名必填与长度校验、密码确认的跨字段校验,以及模拟服务端用户名占用检查。异步部分使用递增序号避免竞态:输入变化后,较早请求即使更晚返回,也不能覆盖最新结果。

vue
<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>

预期结果

text
用户名少于 3 个字符时显示“用户名至少 3 个字符”。
用户名为 admin 时,异步校验后显示“用户名已被占用”。
两次密码不一致时显示“两次密码不一致”。
输入可用用户名且两次密码均不少于 8 个字符并一致时,控制台输出:
VALID {"username":"<VALUE>","password":"<VALUE>","confirmPassword":"<VALUE>"}

<VALUE> 代表用户实际输入,运行时会不同。示例中的服务端校验用延时函数模拟;接入真实接口时只需替换 checkUsernameOnServer,竞态保护逻辑仍然适用。

处理异步校验竞态

典型竞态是用户先输入 admin,立刻改成 alice,但 admin 的请求最后才返回。如果不判断请求是否仍然对应当前输入,旧响应会把“用户名已占用”写回最新状态。递增请求序号、AbortController 或请求库的取消能力都可以解决这个问题。

提交按钮还应防止重复提交,但“提交中的禁用状态”和“字段异步校验状态”最好分开维护。前者控制整个提交事务,后者只表示某个字段正在验证,职责混在一起会导致按钮状态和错误状态难以判断。

让错误定位服务于用户修正

提交失败时,不要只弹一个“校验失败”提示。页面应保留字段旁错误文本,并把焦点移动到第一个失败字段。长表单还可以先滚动到错误区域,再聚焦输入控件;对于标签页或折叠面板,则要先展开包含错误的容器。

服务端最终提交仍可能返回业务错误,例如用户名在校验后被他人抢占。此时不要把它当作系统异常,而应把后端可归属到字段的错误重新写回 errors.username,让用户在原位置修正。

同步校验负责快速反馈,跨字段校验负责表达表单内部约束,异步校验负责确认服务端事实。三者共享统一错误映射,并通过竞态保护与焦点定位串成一条稳定的修正路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

同步与异步校验

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通