Node.js Express带参数GET请求无法匹配预期路由问题排查

这不是框架bug，是你对Express路由匹配规则理解有误，核心原因是Express路由只匹配URL的路径部分，不包含查询字符串（?之后的内容）。

关键规则说明 #

• 访问http://localhost:3000/?name=NODE时，URL的路径部分是/，所以会匹配根路由/，查询参数name=NODE会被存放在req.query对象中，不会影响路由匹配逻辑。
• 访问http://localhost:3000/NODE时，URL的路径部分是/NODE，正好匹配动态路由/:name，此时NODE会被作为路径参数存放在req.params.name中。

示例代码验证 #

const express = require('express');
const app = express();

// 根路由：匹配路径为/的请求，无论是否带查询参数
app.get('/', (req, res) => {
  res.send(`根路由触发，查询参数：${JSON.stringify(req.query)}`);
});

// 动态路由：匹配路径为/xxx的请求，xxx会被解析为name参数
app.get('/:name', (req, res) => {
  res.send(`动态路由触发，路径参数name：${req.params.name}`);
});

app.listen(3000, () => {
  console.log('服务运行在 http://localhost:3000');
});

如何根据查询参数处理逻辑 #

如果需要基于查询参数name执行特定逻辑，无需修改路由结构，直接在根路由中判断req.query.name即可：

app.get('/', (req, res) => {
  const name = req.query.name;
  if (name) {
    res.send(`获取到查询参数name：${name}`);
  } else {
    res.send('根路由默认响应');
  }
});

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