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

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

在 Node.js + Express 构建的 RESTful API 中，为提升代码可维护性，常采用多层路由拆分策略：主应用路由（server.js）→ 模块级路由（如 /api/proyecto）→ 功能子路由（如 /:idProyecto/backlog）→ 具体操作路由（如 /listarBacklog）。但这种嵌套结构存在一个关键陷阱：Express 默认不会将父级路由中捕获的 URL 参数（如 :idProyecto）自动透传给子路由器。

例如，在 proyecto.js 中定义：

routerProyecto.use("/:idProyecto/backlog", routerBacklog);

该路由会匹配类似 /api/proyecto/123/backlog 的路径，并期望 :idProyecto（值为 "123"）可在后续处理中被读取。然而，若 backlog.js 中的 routerBacklog 初始化时未启用参数合并：

const routerBacklog = express.Router(); // ❌ 默认 mergeParams = false

则 req.params 将为空对象 {}，导致 req.params.idProyecto 为 undefined —— 这正是您日志中输出空 backlog 且控制台打印 req.params 为空的原因。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

✅ 正确做法是在创建子路由器时显式启用 mergeParams: true：

// backlog.js
const express = require('express');
const routerBacklog = express.Router({ mergeParams: true }); // ✅ 关键修复

routerBacklog.get("/listarBacklog", async (req, res) => {
  const { tokenProyePUCP } = req.cookies;
  const { idProyecto } = req.params; // 现在能正确获取到 "123"

  if (!idProyecto) {
    return res.status(400).json({ error: "Falta el parámetro idProyecto en la URL" });
  }

  try {
    const payload = jwt.verify(tokenProyePUCP, secret);
    const query = `CALL LISTAR_PRODUCT_BACKLOG_X_ID_PROYECTO(?);`;
    const [results] = await connection.query(query, [idProyecto]);

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

module.exports = routerBacklog;

⚠️ 注意事项：

• mergeParams: true 仅影响 req.params 的合并行为，不影响 req.query 或 req.body；
• 若子路由自身也定义了同名参数（如 routerBacklog.get('/:idProyecto/detalle', ...)），则子路由参数会覆盖父级参数；
• 不推荐在 URL 中过度嵌套动态段（如 /a/:idA/b/:idB/c/:idC），应权衡可读性与 REST 设计原则；合理使用 mergeParams 是解决深层嵌套参数需求的标准实践。

通过这一配置，idProyecto 将稳定注入 req.params，确保业务逻辑（如数据库查询）能可靠获取上下文标识符。