Express路由配置可选参数后无参数请求返回404问题求助

我明白你遇到的问题了——当不传:param参数时，请求/api/system/versionInfo会返回404，这是因为Express的路由匹配逻辑在处理可选参数时的行为和你预期的不一样。接下来我会告诉你问题所在，以及两种可行的解决办法。

问题根源 #

当你使用'/api/:param?'作为挂载路径时，Express会把这个路径当作一个“前缀”来匹配：

• 当你请求/api/test/system/versionInfo时，:param会被匹配为test，剩下的/system/versionInfo会交给apiRoutes处理，刚好匹配你定义的路由。
• 但当你请求/api/system/versionInfo时，Express会把system当作:param的值，剩下的/versionInfo根本不存在于你的apiRoutes里，所以就返回了404。

另外还有一个容易忽略的小细节：你的apiRoutes里的路由没有以/开头，比如'system/versionInfo'，这样的路径在挂载时会和前缀直接拼接（比如变成/api/:param?system/versionInfo），容易引发路径匹配混乱，建议统一改成以/开头的路径。

解决方案一：注册两个挂载路径 #

最简单的方式是分别注册带参数和不带参数的两个挂载路径，让两种请求都能命中对应的路由：

const express = require('express');
const bodyParser = require('body-parser');
const apiRoutes = require('./routes/apiRoutes');
const app = express();
const port = process.env.PORT || 3000;

// 先注册不带参数的/api路径
app.use(
  '/api',
  bodyParser.json({ limit: '50mb' }),
  bodyParser.urlencoded({ extended: false, parameterLimit: 50000 }),
  apiRoutes,
);

// 再注册带可选参数的/api/:param路径
app.use(
  '/api/:param',
  bodyParser.json({ limit: '50mb' }),
  bodyParser.urlencoded({ extended: false, parameterLimit: 50000 }),
  apiRoutes,
);

const server = app.listen(port, () => {
  console.log(`Server is started on port *:${port}`);
});

同时记得修改apiRoutes里的路由，加上开头的/：

router.get('/system/versionInfo', async (req, res) => {
  console.log('return Version info');
  res.send('Version info'); // 别忘了返回响应，不然请求会一直挂起
});
router.get('/system/info', async (req, res) => {
  console.log('return system info');
  res.send('System info');
});

这样不管是/api/system/versionInfo还是/api/test/system/versionInfo，都能正确匹配到对应的路由，而且req.params.param在不传的时候是undefined，传的时候就是对应的参数值。

解决方案二：使用正则表达式匹配路径 #

如果你不想写重复的中间件代码，可以用正则表达式来定义挂载路径，一次性匹配带参数和不带参数的情况：

const express = require('express');
const bodyParser = require('body-parser');
const apiRoutes = require('./routes/apiRoutes');
const app = express();
const port = process.env.PORT || 3000;

// 正则表达式匹配/api 或者/api/xxx（xxx是任意非斜杠的字符串）
app.use(
  /^\/api(?:\/[^\/]+)?/,
  bodyParser.json({ limit: '50mb' }),
  bodyParser.urlencoded({ extended: false, parameterLimit: 50000 }),
  apiRoutes,
);

const server = app.listen(port, () => {
  console.log(`Server is started on port *:${port}`);
});

同样需要确保apiRoutes里的路由以/开头，这样就能正常匹配所有预期的请求了。

两种方案都能解决你的问题，第一种更直观易懂，第二种更简洁，你可以根据自己的需求选择。

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