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 回填。返回状态会参与页面渲染,必须只包含允许暴露给当前用户的信息。
按自己的节奏,确认真正理解。