Node.js Express服务器有效路由返回404？尾斜杠问题求解

问题场景 #

我正在使用Express构建Node.js服务器，定义了如下路由：

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

app.get('/api', (req, res) => {
  res.send('API Route');
});

app.get('/home', (req, res) => {
  res.send('Home Route');
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

访问http://localhost:3000/home或http://localhost:3000/api能得到预期响应，但访问带尾斜杠的http://localhost:3000/home/时会返回404错误。不想通过重复定义带尾斜杠的路由来解决，请问有什么高效处理方式？

解决方案 #

1. 启用默认的宽松路由匹配（推荐）

Express默认关闭strict routing选项，原本就支持同时匹配带或不带尾斜杠的请求。如果你的项目里这个规则没生效，显式设置即可：

// 创建app实例时显式关闭strict routing
const app = express({ strict: false });

设置后，/home和/home/会被视为同一个路由，无需额外定义。

2. 用正则语法匹配可选尾斜杠

如果只想针对特定路由做适配，可以在路由路径末尾加?（正则语法中表示前面的字符可选）：

app.get('/home/?', (req, res) => {
  res.send('Home Route');
});
app.get('/api/?', (req, res) => {
  res.send('API Route');
});

这样单个路由就能同时匹配带或不带尾斜杠的请求。

3. 全局中间件统一重定向

如果想统一URL规范（比如强制所有非根路径不带尾斜杠），可以添加一个全局中间件，自动将带尾斜杠的请求重定向到不带的版本：

app.use((req, res, next) => {
  // 排除根路径"/"，只处理带尾斜杠的子路径
  if (req.path.endsWith('/') && req.path.length > 1) {
    // 拼接新路径，保留查询参数
    const newPath = req.path.slice(0, -1) + req.search;
    // 301永久重定向，利于SEO
    res.redirect(301, newPath);
  } else {
    next();
  }
});

这个方法既解决了404问题，还能统一站点的URL格式。

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