Express-validator 6.0.0 入门指南：轻松实现Express请求验证-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00889/article/details/148487523

Express-validator 6.0.0 入门指南：轻松实现Express请求验证

express-validator 项目地址: https://gitcode.com/gh_mirrors/exp/express-validator

什么是Express-validator

Express-validator是一个基于Express.js中间件的验证库，它封装了validator.js提供的强大验证和净化功能。这个库专门为Express应用程序设计，帮助开发者轻松处理HTTP请求参数的验证工作。

为什么需要请求验证

在Web开发中，客户端提交的数据往往不可信任。请求验证可以：

防止恶意或格式错误的数据进入系统
确保数据符合业务规则要求
提供清晰的错误反馈给前端
增强应用程序的安全性

安装指南

要使用express-validator 6.0.0版本，你需要：

确保已安装Node.js 6.0或更高版本
在项目目录下执行以下命令：

npm install --save express-validator

基础使用教程

1. 基本Express路由示例

首先，我们来看一个没有验证的简单用户创建路由：

const express = require('express');
const app = express();

app.use(express.json());
app.post('/user', (req, res) => {
  User.create({
    username: req.body.username,
    password: req.body.password
  }).then(user => res.json(user));
});

这段代码存在明显问题：它直接使用用户提交的数据，没有任何验证措施。

2. 添加请求验证

现在，我们使用express-validator来增强这个路由：

const { check, validationResult } = require('express-validator');

app.post('/user', [
  // 验证用户名必须是邮箱格式
  check('username').isEmail(),
  // 验证密码长度至少5个字符
  check('password').isLength({ min: 5 })
], (req, res) => {
  // 获取验证结果
  const errors = validationResult(req);
  
  // 如果有错误，返回400状态码和错误详情
  if (!errors.isEmpty()) {
    return res.status(400).json({ errors: errors.array() });
  }

  // 验证通过，创建用户
  User.create({
    username: req.body.username,
    password: req.body.password
  }).then(user => res.json(user));
});

3. 验证失败响应示例

当验证失败时，服务器会返回如下格式的JSON响应：

{
  "errors": [{
    "location": "body",
    "msg": "Invalid value",
    "param": "username"
  }]
}

这个响应包含了：

错误发生的位置（请求体）
错误信息
出错的参数名

核心概念解析

验证链(Validation Chain)

check()函数创建一个验证链，可以添加多个验证条件：

check('username')
  .isEmail()
  .withMessage('必须是有效的邮箱地址')
  .notEmpty()
  .withMessage('邮箱不能为空')

验证结果处理

validationResult(req)返回的结果对象提供了多种方法：

isEmpty()：检查是否有错误
array()：获取所有错误数组
mapped()：获取按字段名组织的错误对象

常用验证方法

express-validator提供了丰富的验证方法，以下是一些常用示例：

字符串验证：
- isEmail()：验证邮箱格式
- isLength({ min:5, max:20 })：验证长度范围
- contains('example')：验证包含特定文本
数字验证：
- isInt()：验证整数
- isFloat()：验证浮点数
- isIn([1, 2, 3])：验证值在指定范围内
其他验证：
- equals('confirmPassword')：验证两个字段值相等
- isURL()：验证URL格式
- isUUID()：验证UUID格式