Express中路由参数base未出现在req.params的原因排查

问题场景 #

我编写了如下基础Express应用：

const express = require('express');
const cors = require('cors');
const app = express();
const router = express.Router();
const port = 3000;

app.use(express.json());
app.use(cors());

router.get("/:uuid", (req, res) => {
    res.json(req.params);
});

// 强制所有请求提供"base"参数。
app.use("/:base", router);

// 验证base参数是否存在的中间件。
app.use((req, res, next) => {
    if(!req.params.base) return res.status(400).json({
        error: "No base provided."
    });
    next();
});

app.listen(port);

向/foo/bar发起请求时，返回结果始终为：

{
    "uuid": "bar"
}

base参数始终不会出现在req.params中，但我确认Express能接收到该参数——因为当参数未提供时，验证中间件会返回错误。这是为什么？

核心原因 #

1. 子路由默认不合并父路由参数
   Express的Router对象默认不会将父路由（也就是挂载时的/:base）的路径参数合并到自身的req.params里。子路由只能访问自己定义的路径参数（这里的uuid），所以在router的处理函数里拿不到base。

2. 验证中间件未被执行
   当请求/foo/bar时，会优先匹配到app.use("/:base", router)，router内部的GET /:uuid会直接处理请求并返回响应，后面的验证中间件根本没机会运行。你看到验证中间件生效的场景，是请求没匹配到router的情况（比如直接请求/bar），这时候才会走到验证中间件，检测到没有base参数并返回错误。

解决方案 #

1. 让子路由获取父路由参数

创建Router时开启mergeParams: true选项，这样父路由的参数会被合并到子路由的req.params中：

// 创建router时添加mergeParams配置
const router = express.Router({ mergeParams: true });

router.get("/:uuid", (req, res) => {
    // 现在req.params同时包含base和uuid
    res.json(req.params);
});

app.use("/:base", router);

此时请求/foo/bar会返回：

{
    "base": "foo",
    "uuid": "bar"
}

2. 确保验证中间件生效

如果要让所有请求都经过base参数验证，需要调整中间件顺序，把验证逻辑放到router挂载之前，或者直接整合到父路由的挂载逻辑里：

// 方式一：把验证逻辑放到父路由挂载点
app.use("/:base", (req, res, next) => {
    if(!req.params.base) {
        return res.status(400).json({ error: "No base provided." });
    }
    next();
}, router);

// 方式二：全局验证（需手动解析URL）
app.use((req, res, next) => {
    const base = req.path.split('/')[1];
    if(!base) {
        return res.status(400).json({ error: "No base provided." });
    }
    next();
});
app.use("/:base", router);

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