JavaScript (Node.js) 中的数据验证：Joi、Yup、Zod

Node.js 中的数据验证：Joi、Yup 和 Zod——选择正确的工具

在现代 Node.js 的 Web 开发中，数据验证不仅仅是一种良好的实践，更是一种必要。没有它，您的服务器就有可能从客户端接收到不正确、恶意或仅仅是意外的数据。这可能导致应用程序逻辑错误、安全漏洞（SQL 注入、XSS）以及运行不稳定。在本文中，我们将分析 Node.js 环境中三个最流行的数据验证库：Joi、Yup 和 Zod。您将了解它们的特点、优势，并学会如何在实际中应用它们。

为什么需要服务器端验证？

许多开发者只依赖前端验证（例如，使用 HTML5 属性）。这是一个错误。客户端验证很容易被绕过（通过禁用 JavaScript 或使用 Postman/curl 发送请求）。服务器端验证是最后一道防线。它确保只有符合严格要求的数据才能进入您的业务逻辑和数据库：正确的类型、长度、格式（电子邮件、URL）、字段的必填性等。

1. Joi——久经考验的老将

Joi（通常与 Hapi.js 框架一起使用，但也与 Express/Koa 完美配合）是最强大、最灵活的库之一。它提供了丰富的 API 用于描述模式和错误消息。

安装：

npm install joi

使用 Joi 验证用户注册的示例：

const Joi = require('joi');

const schema = Joi.object({    username: Joi.string()        .alphanum()        .min(3)        .max(30)        .required()        .messages({            'string.min': '用户名至少应为 {#limit} 个字符',            'string.max': '用户名最多应为 {#limit} 个字符'        }),    password: Joi.string()        .pattern(new RegExp('^[a-zA-Z0-9]{3,30}$'))        .required(),    email: Joi.string()        .email({ minDomainSegments: 2, tlds: { allow: ['com', 'net', 'ru'] } })        .required(),    birth_year: Joi.number()        .integer()        .min(1900)        .max(2023)});

const validateUser = (data) => {    const { error, value } = schema.validate(data, { abortEarly: false });    if (error) {        // 返回所有错误        return { valid: false, errors: error.details.map(d => d.message) };    }    return { valid: true, data: value };};

// 调用示例const result = validateUser({    username: 'jo',    password: '123',    email: 'test@test',    birth_year: 1800});console.log(result.errors);// 输出：['用户名至少应为 3 个字符', '"password" length must be at least 3 characters long', '"email" must be a valid email', '"birth_year" must be less than or equal to 2023']

Joi 的优点：

• 大量内置验证器（电子邮件、URL、UUID、信用卡、电话等）。
• 支持条件验证（when、switch）。
• 出色的错误消息，支持翻译和自定义。
• 详细的文档。

Joi 的缺点：

• 库的大小（压缩后约 60 KB）。
• 对于简单模式，API 可能显得过于庞大。
• 与 TypeScript 的集成较复杂（需要额外的类型）。

2. Yup——简洁与组合

Yup 最初是为 React 中的表单验证而创建的（与 Formik 配合使用），但在服务器端也运行良好。它的主要优势是简洁且可读性强的语法，类似于 mongoose 模式。

安装：

npm install yup

使用 Yup 验证对象数组的示例：

const yup = require('yup');

cons