Express路由如何完整捕获/check/路径后的URL（含查询串）

问题原因 #

Express 路由匹配逻辑默认会将请求URL中?后的内容识别为当前服务的查询参数，自动解析存入req.query，不会纳入路由路径匹配的req.params范围，因此用/check/:url*这类常规通配路由写法时，会丢失目标URL自带的查询串部分。

推荐实现方案 #

直接读取Express提供的只读原始请求URL属性做截取，无需客户端做额外编码适配，稳定性最高：

router.get('/check/*', (req, res) => {
  // 从原始请求URL中截掉/check/前缀，得到完整的目标URL（含?及后续查询参数）
  const targetUrl = req.originalUrl.replace(/^\/check\//, '');
  
  // 示例：传入https://example.com/?print=1时，targetUrl值就是完整的"https://example.com/?print=1"
  // 后续直接使用targetUrl发起健康探测即可
})

备选方案（需客户端配合） #

可以要求客户端传入目标URL时，先对完整URL做URL编码（将?编码为%3F、&编码为%26、/编码为%2F等），此时直接用单参数路由即可捕获：

router.get('/check/:encodedUrl', (req, res) => {
  // 解码得到原始目标URL
  const targetUrl = decodeURIComponent(req.params.encodedUrl);
})

该方案的缺点是需要调用方额外做编码处理，兼容性弱于第一种方案。

注意：不要使用req.url做截取，该属性可能被中间件改写，req.originalUrl为只读属性，始终保留最原始的请求路径，取值更可靠。

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