React / 系统课时

校验用户输入

校验用户输入

本课建立一套可复用的服务端校验流程,覆盖必填项、邮箱格式和备注长度。完成后,表单即使被绕过浏览器限制直接提交,服务器也能返回稳定、可预测的校验结果。

学习目标

  • 在服务端区分必填、格式和业务约束
  • 将原始表单值转换为稳定的校验输入
  • 返回结构化错误而不是拼接一条模糊消息

校验顺序

校验应先处理类型与空值,再检查格式,最后检查依赖业务数据的约束。这个顺序可以避免对无效值继续执行昂贵查询,也能让错误信息更准确。例如邮箱为空时应先返回“请输入邮箱”,而不是“邮箱格式不正确”。

客户端校验用于尽早提示,服务端校验负责最终安全边界。required、输入类型和前端脚本都可能被绕过,因此服务端必须独立完成同样或更严格的检查。

主示例:返回结构化校验结果

下面两个文件组成一个可运行示例。为了聚焦校验,本课先把错误对象整体显示出来;下一课再把错误精确放到各字段下方。

ts
// app/signup/actions.ts
'use server'

export type SignupState = {
  errors: {
    name?: string[]
    email?: string[]
    note?: string[]
  }
  values: {
    name: string
    email: string
    note: string
  }
}

const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/

export async function submitSignup(
  _previousState: SignupState,
  formData: FormData,
): Promise<SignupState> {
  const values = {
    name: String(formData.get('name') ?? '').trim(),
    email: String(formData.get('email') ?? '').trim().toLowerCase(),
    note: String(formData.get('note') ?? '').trim(),
  }

  const errors: SignupState['errors'] = {}

  if (!values.name) {
    errors.name = ['请输入姓名']
  } else if (values.name.length > 40) {
    errors.name = ['姓名不能超过 40 个字符']
  }

  if (!values.email) {
    errors.email = ['请输入邮箱']
  } else if (!emailPattern.test(values.email)) {
    errors.email = ['请输入有效的邮箱地址']
  }

  if (values.note.length > 200) {
    errors.note = ['备注不能超过 200 个字符']
  }

  return { errors, values }
}
tsx
// app/signup/signup-form.tsx
'use client'

import { useActionState } from 'react'
import {
  submitSignup,
  type SignupState,
} from './actions'

const initialSignupState: SignupState = {
  errors: {},
  values: { name: '', email: '', note: '' },
}

export function SignupForm() {
  const [state, formAction] = useActionState(
    submitSignup,
    initialSignupState,
  )

  return (
    <form action={formAction} noValidate>
      <label htmlFor="name">姓名</label>
      <input id="name" name="name" defaultValue={state.values.name} />

      <label htmlFor="email">邮箱</label>
      <input id="email" name="email" defaultValue={state.values.email} />

      <label htmlFor="note">备注</label>
      <textarea id="note" name="note" defaultValue={state.values.note} />

      <button type="submit">提交</button>

      <pre>{JSON.stringify(state.errors, null, 2)}</pre>
    </form>
  )
}

// app/signup/page.tsx
import { SignupForm } from './signup-form'

export default function SignupPage() {
  return (
    <main>
      <h1>用户登记</h1>
      <SignupForm />
    </main>
  )
}

预期结果

json
{
  "name": ["请输入姓名"],
  "email": ["请输入有效的邮箱地址"],
  "note": ["备注不能超过 200 个字符"]
}

当姓名为空、邮箱填写为 invalid-email、备注超过 200 个字符时,页面中的 pre 会显示上述结构。noValidate 只用于演示服务端结果,生产页面仍可保留浏览器校验以改善体验。

必填、格式与业务约束

必填校验只回答“有没有值”;格式校验回答“值的形状是否可接受”;业务约束则回答“当前用户是否允许这样做”。例如邮箱格式正确,不代表它尚未注册;库存数量是整数,也不代表库存足够。

业务约束通常需要访问数据库,并应在真正写入时再次由唯一索引、外键或事务保证。不要只依赖写入前查询,因为并发请求可能同时通过检查。

错误返回策略

已知错误应返回普通、可序列化状态,例如字段错误、业务提示和用户刚输入的安全值。未知错误不应伪装成“参数错误”,应记录日志并交给错误边界处理,以免隐藏系统故障。

密码、令牌、银行卡号等敏感值不要放进返回状态,也不要用 defaultValue 回填。返回状态会参与页面渲染,必须只包含允许暴露给当前用户的信息。

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

目录与阅读设置

阅读设置

17

记录一个想法

校验用户输入

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

登录哪都通