数据校验Validation
你可能会说
用户乱填也能提交成功，怎么在保存之前先拦住？
数据校验是在使用输入前检查其格式、范围和业务规则的步骤例如，必填项可在用户离开字段时提示，跨字段规则通常在提交时统一检查。前端提示帮助用户及时纠正，但可能被绕过；后端仍须重新校验并返回具体字段错误。
你可以这样告诉 AI Agent
报名接口现在会接受不合法的年龄。请保留前端的即时提示，并在服务端补上类型和范围校验。用一个合法值和“二十”各提交一次：前者应创建记录，后者应返回可读错误且不写入数据库。
什么时候用
- 在后端检查类型、必填、范围、长度和允许值一眼看清字段规则email必填 · 邮箱格式price数字 · 大于 0roleuser / admin
- 返回字段级错误，让前端知道该在输入框旁提示什么错误要指向具体字段商品价格-3输入框下方价格必须大于 0
- 先校验，再执行业务和数据库写入校验通过才写数据库收到输入→规则检查→写入数据库
- 尽量使用框架的 schema 校验能力，规则集中在一处规则集中在一份 Schemaemail: string().email()price: number().positive()role: enum(["user", "admin"])
什么时候不用
- 只做前端校验：请求可以绕过页面直接发到接口页面检查可以被绕过跳过表单→直接请求 API→后端仍需校验
- 校验失败仍按成功结果返回：状态码和响应体应遵守 API 约定，前端也要解析业务结果状态码与结果互相矛盾HTTP200 OK响应内容error: invalid email前端很容易把失败当成功
- 把技术堆栈和数据库报错原样展示给用户不要把内部报错丢给用户PrismaClientKnownRequestErrorat node_modules/runtime/library.js:129:42页面应该显示：暂时无法保存，请稍后重试
- 在用户不知情时修正关键输入，例如把负价格自动改成正数不要擅自修改关键数据用户输入价格 -99 → 系统擅自改成价格 99应明确拒绝并让用户确认
组成结构 · Anatomy
原始输入→校验规则→通过或字段错误
来自表单、URL、请求头或第三方系统，都不能默认可信
定义字段类型、是否必填、范围、长度和允许值
通过后只说明格式符合规则；仍要检查权限、业务条件和输出场景
典型使用场景
注册邮箱和密码
注册校验在字段旁说明怎样修改
创建账号
邮箱格式不完整 · 密码至少 8 位
创建商品价格
商品价格拒绝不合理数值
校验结果价格必须大于 0
文章标题长度
文章标题输入时显示长度限制
当前56 字上限40 字
API 请求体 schema
请求体 Schema集中检查 API 字段
email✓ stringage✕ 应为 1–120role✓ user
失败时按 API 约定返回 400 或 422 及字段级错误
延伸阅读 · 权威出处
快速练习