将完整URL作为路由参数传递的最佳解决方法

嘿，这个问题我之前做反向代理类项目的时候踩过好几次坑，太懂这种烦躁了！咱们拆解成两个问题来逐个解决：

首先得明白为啥会出现这种情况：绝大多数Web框架（比如Express、FastAPI）默认会把斜杠/当作路由的分隔符，而且会自动解码URL编码后的字符——这是符合HTTP规范的，但确实给我们传递完整URL当参数添了麻烦。

解决方案1：用正则路由匹配完整参数 #

不管你用什么框架，基本都支持用正则表达式来定义路由规则，让它能匹配包含斜杠的完整参数。举两个常用框架的例子：

Express 示例：

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

// 用(.*)正则匹配任意字符（包括斜杠）
app.get('/proxy/:targetUrl(.*)', (req, res) => {
  // req.params.targetUrl 是框架自动解码后的URL
  const decodedUrl = req.params.targetUrl;
  // 如果需要保留原始编码的内容，从req.originalUrl里截取
  const encodedUrl = req.originalUrl.split('/proxy/')[1];
  
  res.send({
    decoded_target: decodedUrl,
    encoded_target: encodedUrl
  });
});

app.listen(3000);

FastAPI 示例：

from fastapi import FastAPI, Path, Request

app = FastAPI()

# 用:path后缀告诉FastAPI匹配任意路径字符（包括斜杠）
@app.get("/proxy/{target_url:path}")
async def handle_proxy(target_url: str, request: Request):
    decoded_url = target_url
    # 从原始URL中提取编码后的参数部分
    encoded_url = request.url.path.split("/proxy/")[1]
    
    return {
        "decoded_target": decoded_url,
        "encoded_target": encoded_url
    }

解决方案2：禁止自动解码（部分框架支持） #

有些框架提供了配置项可以关闭自动解码，比如Express的queryparser配置，但注意这会影响整个应用的参数解析，谨慎使用：

app.use(express.urlencoded({ extended: true, decodeURIComponent: false }));

不过更稳妥的还是上面的“从原始URL截取”的方法，不会影响全局配置。

这个问题的核心是：问号?在HTTP协议里是查询字符串的分隔符，服务器会自动把问号后面的内容当作独立的查询参数，而不是路由参数的一部分。

解决步骤： #

1. 先对问号进行URL编码：把?转换成%3F，把=转换成%3D（如果有查询参数的话）。比如原本的https://example.com?foo=bar要编码成https%3A%2F%2Fexample.com%3Ffoo%3Dbar。
2. 结合正则路由匹配：用上面提到的正则路由规则，确保编码后的问号能被完整捕获到路由参数里，不会被服务器当作查询字符串分隔符。

举个实际请求的例子：
你需要发送的请求是：http://your-server.com/proxy/https%3A%2F%2Fexample.com%3Ffoo%3Dbar
这样路由参数就能完整拿到编码后的字符串，不管是解码还是保留编码都能自己处理。

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