如何在Node.js的Express路由参数中传入完整URL避免被截断

问题根因 #

YouTube链接中的?是HTTP标准规定的路径与查询参数分隔符，Express默认的路由参数匹配逻辑会在识别到?时终止参数捕获，?后的v=iik25wqIuFo会被解析为当前请求的查询参数存入req.query，因此你通过req.params.id只能拿到?之前的部分内容。

解决方案 #

提供两种可直接落地的方案，按需选择：

方案1：URL编码传参（兼容性最高，推荐使用）

• 传入参数前，将完整YouTube链接通过encodeURIComponent()转义，转义后?、=、/等特殊字符会被替换为URL安全编码，不会被识别为分隔符。例如原链接转义后为https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Diik25wqIuFo，直接作为id参数传入路由即可。
• 后端拿到req.params.id后，调用decodeURIComponent()即可还原为原始完整链接，传入下载逻辑即可。

方案2：修改路由匹配规则

调整路由定义为通配符匹配模式，让路由参数可以捕获所有后续字符，无需编码即可拿到完整链接：

// 原路由改为带通配符的匹配规则
app.get('/download/video/:id(*)', function (req, res) {
  const youtubeLink = req.params.id
  res.send('Downloading ' + youtubeLink)
  // 调用下载函数
  downloadvideo(youtubeLink)
})

字幕、播放列表的路由可以按照同样规则修改，将:id替换为:id(*)即可。

代码优化提示 #

你当前代码中将app.use(express.urlencoded({ extended: true }))写在了请求处理函数内部，属于错误用法。中间件需要全局注册或者路由前置注册，不要放在单次请求的处理逻辑中，建议调整为全局注册：

const app = express();
// 全局注册参数解析中间件
app.use(express.urlencoded({ extended: true }));

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