在Express中获取中间件挂载点并实现路由查询验证

我明白你现在的瓶颈：用req.originalUrl去匹配带动态参数的路由模板（比如/users/:id）根本行不通，因为实际请求的URL是/users/123这种具体值，和你的schema键对不上。下面给你几个实用的解决方案，按推荐程度排序：

方案一：直接给路由绑定验证Schema（最推荐） #

这种方式最直观，也最容易维护——在定义路由的时候，就把对应的验证逻辑直接挂上去，不需要在全局中间件里猜路由。

步骤1：改造你的验证中间件为工厂函数 #

让它接收一个Schema，返回对应的验证中间件：

// validate.js
// 假设你用Joi或者其他验证库，这里替换成你实际的验证逻辑
const Joi = require('joi');

module.exports = (schema) => {
  return (req, res, next) => {
    // 验证查询参数
    const { error } = Joi.compile(schema).validate(req.query);
    if (error) {
      return res.status(400).json({ 
        error: '参数验证失败', 
        details: error.details.map(d => d.message) 
      });
    }
    next();
  };
};

步骤2：在路由定义时绑定Schema #

直接在每个路由的处理链里加入验证中间件：

const router = require('express-promise-router')();
const users = require('./users');
const validate = require('./validate');

// 定义各个路由对应的Schema
const schemas = {
  '/users': Joi.object({
    page: Joi.number().integer().min(1).default(1),
    limit: Joi.number().integer().min(1).max(50).default(10)
  }),
  '/users/:id': Joi.object({
    includePosts: Joi.boolean().default(false)
  })
};

// 给路由添加验证中间件
router.get('/users', validate(schemas['/users']), users.list);
router.get('/users/:id', validate(schemas['/users/:id']), users.get);

module.exports = router;

这种方式的好处是：路由和验证逻辑一一对应，一目了然，后期维护的时候改路由或者改Schema都很方便，完全不用处理动态路由匹配的问题。

方案二：用req.route.path获取路由模板（适合全局验证） #

如果你一定要用全局中间件来统一处理验证，可以利用Express提供的req.route.path——它会返回当前请求匹配的路由定义模板（比如/users/:id），而不是实际的请求URL。

步骤1：编写全局验证中间件 #

// validateMiddleware.js
const Joi = require('joi');

const schemas = {
  '/users': Joi.object({
    page: Joi.number().integer().min(1).default(1),
    limit: Joi.number().integer().min(1).max(50).default(10)
  }),
  '/users/:id': Joi.object({
    includePosts: Joi.boolean().default(false)
  })
};

module.exports = (req, res, next) => {
  // 获取当前路由的模板路径
  const routeTemplate = req.route.path;
  // 如果你的路由挂载了前缀（比如app.use('/api', router)），需要拼接baseUrl
  // const fullRouteTemplate = `${req.baseUrl}${routeTemplate}`;

  const schema = schemas[routeTemplate];
  if (!schema) {
    // 如果没有对应Schema，可以选择跳过验证或者返回错误
    return next();
    // 或者返回错误：return res.status(400).json({ error: '该路由无验证规则' });
  }

  // 执行验证
  const { error } = schema.validate(req.query);
  if (error) {
    return res.status(400).json({ 
      error: '参数验证失败', 
      details: error.details.map(d => d.message) 
    });
  }

  next();
};

步骤2：把中间件挂载到路由上 #

注意要把中间件放在所有路由定义之前，这样每个路由请求都会先经过验证：

const router = require('express-promise-router')();
const users = require('./users');
const validateMiddleware = require('./validateMiddleware');

// 先挂载验证中间件
router.use(validateMiddleware);

// 再定义路由
router.get('/users', users.list);
router.get('/users/:id', users.get);

module.exports = router;

这个方案的关键是req.route.path——它是Express在路由匹配成功后自动填充的，完全对应你定义路由时的模板字符串，完美解决动态参数的匹配问题。

方案三：用path-to-regexp手动匹配路由（适合复杂场景） #

如果上面两种方案都不满足你的需求（比如你需要在外部维护Schema映射），可以用Express内部依赖的path-to-regexp库，手动把实际URL和路由模板做匹配。

步骤1：安装依赖（如果没装的话） #

npm install path-to-regexp

步骤2：编写中间件 #

// validateMiddleware.js
const pathToRegexp = require('path-to-regexp');
const Joi = require('joi');

const schemas = {
  '/users': Joi.object({
    page: Joi.number().integer().min(1).default(1),
    limit: Joi.number().integer().min(1).max(50).default(10)
  }),
  '/users/:id': Joi.object({
    includePosts: Joi.boolean().default(false)
  })
};

module.exports = (req, res, next) => {
  // 去掉URL里的查询参数部分
  const cleanUrl = req.originalUrl.split('?')[0];
  let matchedSchema = null;

  // 遍历所有Schema的路由模板，匹配当前URL
  Object.entries(schemas).forEach(([routeTemplate, schema]) => {
    const regex = pathToRegexp(routeTemplate);
    if (regex.test(cleanUrl)) {
      matchedSchema = schema;
    }
  });

  if (!matchedSchema) {
    return next(); // 或者返回错误
  }

  const { error } = matchedSchema.validate(req.query);
  if (error) {
    return res.status(400).json({ 
      error: '参数验证失败', 
      details: error.details.map(d => d.message) 
    });
  }

  next();
};

这种方案灵活性最高，但需要注意路由模板的顺序——如果有多个模板能匹配同一个URL，会取最后一个匹配到的Schema。

内容的提问来源于stack exchange，提问作者serge1peshcoff