proxy_pass是否透传路径参数取决于location与proxy_pass斜杠组合：不带斜杠时保留匹配前缀，带斜杠时截掉前缀；正则location必须显式写uri；rewrite需加?或break才能保留query string；推荐用proxy_set_header传递x-original-uri。
proxy_pass 本身默认就会透传完整请求路径（包括路径参数），但是否“正确透传”，取决于你 location 和 proxy_pass 的斜杠组合，以及是否覆盖了原始路径逻辑。真正影响路径参数能否到达后端的，不是“要不要透传”，而是“怎么截、怎么拼”。
看准 proxy_pass 末尾斜杠，决定路径怎么截
这是最核心的一条规则，直接控制路径参数是否被保留或被替换：
-
proxy_pass 不带斜杠（如
http://127.0.0.1:3000）→ location 匹配的部分原样保留，追加到目标地址后
例：location /api/ { proxy_pass http://127.0.0.1:3000; }，访问/api/v1/users?id=123→ 后端收到/api/v1/users?id=123 -
proxy_pass 带斜杠（如
http://127.0.0.1:3000/）→ location 匹配前缀被完全截掉，只把剩余路径拼到/后
例：location /api/ { proxy_pass http://127.0.0.1:3000/; }，访问/api/v1/users?id=123→ 后端收到/v1/users?id=123
正则 location 必须显式写全 proxy_pass URI
用 ~ 或 ~* 写正则匹配时，Nginx 不允许 proxy_pass 省略 URI 部分，否则会启动失败。路径参数能否透传，取决于你写的 URI 是否留出拼接空间：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- ✅ 正确写法：
location ~ ^/api/v(\d+)/(.*)$ { proxy_pass http://127.0.0.1:3000/$2; }
访问/api/v2/users?sort=name→ 后端收到/users?sort=name（$2捕获users，query string 自动带上） - ❌ 错误写法：
proxy_pass http://127.0.0.1:3000;（无 URI）→ Nginx 直接报错：”invalid URL prefix“
别让 rewrite 干扰 query string 透传
rewrite 默认会丢弃原始 query string，除非你显式加上 ? （问号结尾）或使用 break + proxy_pass 组合：
- 用
rewrite ... break;：重写路径后停止处理，proxy_pass 仍按原始 query string 转发
例：rewrite ^/old/(.*)$ /new/$1 break;+proxy_pass http://backend;→/old/users?id=1变成/new/users?id=1 - 用
rewrite ... last;：触发内部重定向，query string 会被重置为新路径的默认值（常丢失） - 安全做法：避免在 proxy_pass 前用 rewrite 改路径，优先靠 proxy_pass 斜杠规则解决；必须改时，加
?显式保留 query：rewrite ^/api/(.*)$ /$1? permanent;
确保后端能拿到原始请求路径（可选但推荐）
有些后端框架依赖 X-Original-URI 或 X-Forwarded-Uri 判断原始入口，尤其做路由重写或日志追踪时：
- 加一行头传递：
proxy_set_header X-Original-URI $request_uri;$request_uri包含完整路径 + query string（如/api/v1/users?id=123） - 注意：
$uri不带 query string，$args只有 query 部分，要完整路径请用$request_uri
