express-validator报错req.checkBody is not a function求助

你碰到的这个问题几乎可以确定是express-validator版本不兼容搞的鬼！

早期的express-validator（v3及更早版本）是通过app.use(expressValidator())挂载到Express实例上，这样就能直接在请求对象req上调用checkBody()这类方法。但从v4版本开始，这个库做了彻底的API重构，不再把验证方法挂载到req上了，所以你再调用req.checkBody就会触发“不是函数”的报错。

下面给你两个可行的解决方案，按需选择：

方案一：回退到旧版本（不用改现有代码） #

如果不想折腾修改验证逻辑，直接装回v3.x版本就行：

npm uninstall express-validator
npm install express-validator@3.2.1 --save

安装完成后，你原来写的app.use(expressValidator({ errorFormatter: ... }))配置，还有req.checkBody()相关调用，就能恢复正常工作了。

方案二：升级到新版本（推荐，适配最新生态） #

要是想用上新版本的特性，就得调整代码逻辑，改用路由级中间件的方式来做验证。给你举个简单的示例：

1. 先安装最新版：

npm install express-validator --save

2. 在需要验证的路由文件里引入对应的方法：

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

3. 把原来的req.checkBody()验证逻辑替换成路由中间件，比如验证用户名和邮箱：

app.post('/your-form-path',
  // 定义验证规则
  body('username').notEmpty().withMessage('用户名不能为空'),
  body('email').isEmail().withMessage('请输入有效的邮箱地址'),
  (req, res) => {
    // 捕获验证错误
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
      return res.status(400).json({ errors: errors.array() });
    }

    // 验证通过，处理后续业务逻辑
    res.send('表单验证成功！');
  }
);

注意哦，新版本里不需要再在app.js里用app.use(expressValidator())来启用了，直接在需要验证的路由上添加中间件就行。

内容的提问来源于stack exchange，提问作者J.G.Sable