Node.js路由匹配name参数失效，但id参数正常，原因何在？

本地基于MySQL搭建后端，使用Node.js的路由模块实现接口，整体数据库连接及其他查询均正常，但以下匹配name参数的路由无法返回正确结果：

router.get("/:users/:name", (req, res) => {
  const { name } = req.params;
  console.log(req.params);
  mysqlConnection.query(
    "SELECT * FROM user WHERE name = ?",
    [name],
    (error, rows, fields) => {
      console.log(rows);
      console.log(error);
      if (!error) {
        res.json(rows);
      } else {
        console.log(error);
      }
    }
  );
});

而匹配id参数的对应路由却能正常运行：

router.get("/:users/:id", (req, res) => {
  const { id } = req.params;
  mysqlConnection.query(
    "select * from user where id = ?",
    [id],
    (error, rows, fields) => {
      if (!error) {
        res.json(rows);
      } else {
        console.log(error);
      }
    }
  );
});

使用Postman测试，示例请求为localhost:8080/users/name，尝试直接拼接SQL字符串的写法后仍无效：

router.get("/:users/:name", (req, res) => {
  const { name } = req.params;
  console.log(req.params);
  mysqlConnection.query(
    `SELECT * FROM user WHERE name = '${name}'`,
    (error, rows, fields) => {
      console.log(rows);
      console.log(error);
      if (!error) {
        res.json(rows);
      } else {
        console.log(error);
      }
    }
  );
});

问题原因及解决方案 #

1. 路由匹配顺序冲突（最可能原因） #

/:users/:id和/:users/:name的路由规则完全一致，都是/[任意字符串]/[任意字符串]。Node.js路由模块（如Express）会按定义顺序匹配路由，先定义的路由会拦截所有符合该模式的请求。比如如果/:users/:id先定义，所有/users/xxx的请求都会进入id路由处理，不管xxx是id还是name，导致name路由永远不会被触发。

解决办法：

• 修改路由路径，明确区分两类请求：

  // 查询id的路由
  router.get("/users/id/:id", (req, res) => { /* ... */ });
  // 查询name的路由
  router.get("/users/name/:name", (req, res) => { /* ... */ });
  

• 若要保留原路径结构，可在id路由中判断参数是否为数字（通常id是数值类型），非数字则移交后续路由处理：

  router.get("/:users/:id", (req, res, next) => {
    const { id } = req.params;
    // 判断是否为数字id
    if (!isNaN(id)) {
      // 执行id查询逻辑
      mysqlConnection.query(/* ... */);
    } else {
      // 不是数字，交给下一个路由（name路由）处理
      next();
    }
  });
  // 确保name路由在id路由之后定义
  router.get("/:users/:name", (req, res) => { /* ... */ });
  

2. 数据库查询匹配问题 #

• 检查数据库中是否存在对应name的记录，测试时使用确定存在的name值发送请求。
• 注意数据库字段的大小写敏感性：若name字段区分大小写，需确保请求的name值与数据库存储的完全一致（比如带空格的"张三 "和无空格的"张三"会匹配失败）。

3. 调试路由匹配情况 #

在两个路由的处理函数开头添加日志，确认请求是否进入目标路由：

// id路由中添加
console.log("进入id路由，参数：", req.params);
// name路由中添加
console.log("进入name路由，参数：", req.params);

通过日志可明确请求被哪个路由处理，快速定位问题。

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