Express路由含斜杠的参数导致404问题如何解决？

这个问题我之前也碰到过，本质是Express默认的路由参数匹配规则是[^\/]+——也就是不会匹配斜杠字符，所以当你的name参数里包含转义后的%2F（解码后是/）时，Express会把斜杠后面的内容当成新的路径段，自然找不到对应的路由，返回404。下面给你几个实用的解决办法：

方法一：使用通配符路由（*） #

把路由改成通配符格式，让它匹配id之后的所有内容，然后在处理函数里提取这部分作为name参数。注意要把这个路由放在所有更具体的路由之后，避免覆盖其他路由。

示例代码：

// 确保这个路由在 /api/parent/:id/xxx 这类具体路由之后
app.get('/api/parent/:id/*', (req, res) => {
  const id = req.params.id;
  // req.params[0] 就是通配符*匹配到的所有内容，包含所有斜杠
  const name = req.params[0];
  
  // 如果你需要手动解码（Express默认会自动解码，一般不需要）
  // const decodedName = decodeURIComponent(name);
  
  res.json({ id, name });
});

调用路径可以直接用api/parent/19/alex%20%21/2，后端能正确捕获到name为alex !/2。

方法二：自定义路由参数的正则表达式 #

Express允许给路由参数指定正则匹配规则，我们可以把name参数的规则改成匹配任意字符（包括斜杠），这样就能正确捕获包含斜杠的参数。同样要注意路由顺序，放在具体路由之后。

示例代码：

// 使用(.+)正则匹配任意非空字符（包括斜杠）
app.get('/api/parent/:id/:name(.+)', (req, res) => {
  const { id, name } = req.params;
  
  // 同样，Express会自动解码参数，无需额外处理
  res.json({ id, name });
});

这个方法和通配符类似，但更明确地指定了name参数的位置，可读性更好。

方法三：将参数移到查询字符串 #

如果不想修改现有路由结构，可以让客户端把包含特殊字符的name参数放在查询字符串里，后端通过req.query获取。

示例代码：

app.get('/api/parent/:id', (req, res) => {
  const id = req.params.id;
  // 从查询字符串获取name参数
  const name = req.query.name;
  
  res.json({ id, name });
});

客户端调用路径改为api/parent/19?name=alex%20%21%2F2，后端就能正确拿到name参数，这种方式不会触发路由匹配问题，适合参数可能包含多种特殊字符的场景。

注意事项 #

• Express默认会自动解码路由参数和查询字符串，所以%2F会被转成/，不需要手动调用decodeURIComponent，除非你有特殊的编码需求。
• 无论用哪种方法，都要注意路由的顺序：更具体的路由（比如/api/parent/:id/profile）要放在能匹配斜杠的路由之前，避免被提前匹配。
• 如果参数用于文件操作等场景，要做好安全校验，防止路径遍历攻击。

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