在 Express 中使用嵌套路由（如 /api/proyecto/:idProyecto/backlog）时，子路由器默认无法访问父路由器定义的 URL 参数；需显式启用 mergeParams: true 选项才能继承并解析上级路由参数。

在 express 中使用嵌套路由（如 `/api/proyecto/:idproyecto/backlog`）时，子路由器默认无法访问父路由器定义的 url 参数；需显式启用 `mergeparams: true` 选项才能继承并解析上级路由参数。

在 Express 应用中，当采用模块化路由设计（即“路由器中的路由器”），例如将 /api/proyecto/:idProyecto/backlog 拆分为：

• 主路由：/api/proyecto → routerProyecto
• 子路由：/:idProyecto/backlog → routerBacklog

此时，:idProyecto 是在 routerProyecto 中定义的父级路径参数，而 routerBacklog 默认不会自动继承该参数——即使路径匹配成功，req.params.idProyecto 也会为 undefined，导致后续逻辑（如数据库查询）失效。

✅ 正确做法：在创建子路由器时，显式传入 { mergeParams: true } 选项：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

// backlog.js
const express = require('express');
const routerBacklog = express.Router({ mergeParams: true }); // ? 关键配置！

routerBacklog.get('/listarBacklog', async (req, res) => {
  const { tokenProyePUCP } = req.cookies;

  try {
    const payload = jwt.verify(tokenProyePUCP, secret);
    const { idProyecto } = req.params; // ✅ 现在可正确获取

    console.log(`Recibida solicitud para proyecto ID: ${idProyecto}`);

    const query = 'CALL LISTAR_PRODUCT_BACKLOG_X_ID_PROYECTO(?);';
    const [results] = await connection.query(query, [idProyecto]);

    res.status(200).json({
      backlog: results[0],
      message: 'Backlog obtenido exitosamente'
    });
  } catch (err) {
    if (err.name === 'JsonWebTokenError') {
      return res.status(401).send('Token inválido: ' + err.message);
    }
    console.error('Error al obtener el backlog:', err);
    res.status(500).send('Error interno del servidor');
  }
});

module.exports = routerBacklog;

⚠️ 注意事项：

• mergeParams: true 仅影响 req.params 的合并，不影响 req.query 或 req.body；
• 若子路由自身也定义了同名参数（如 /:idProyecto/:itemId），则子路由参数会覆盖父路由同名参数；
• 不建议在路径中间使用动态参数作为“分隔符”（如 /a/:id/b/c），虽技术可行，但易降低可读性；更推荐语义化设计，例如 /api/proyectos/:id/backlog（复数资源名 + 单数 ID）；
• 始终对 req.params 做存在性和类型校验（尤其涉及数据库操作时），避免 SQL 异常或空值错误。

? 总结：嵌套路由是 Express 推荐的模块化实践，但 mergeParams: true 是打通参数链路的必要开关。漏掉它，就会出现“控制台打印空对象、接口返回空数据却无报错”的典型静默失败现象——务必在初始化子 Router 实例时主动声明。