Nginx rewrite配合proxy_pass参数丢失的根本原因是rewrite不自动保留$query_string，必须显式拼接$args或用last跳转至独立location处理；同时需确保proxy_pass以/结尾，否则参数可能被截断。
Linux 下 Nginx 使用 rewrite 配合 proxy_pass 时参数丢失，根本原因在于 rewrite 改写 URI 后若未显式保留或重建 query string（即 ?key=value），Nginx 默认不会自动携带原始参数转发。这不是 bug，而是行为设计——rewrite 重写的是整个 URI，而 query string 是否保留取决于重写规则是否包含它。
确保 rewrite 规则显式保留 $args
rewrite 指令本身不自动继承原始参数，必须在替换目标中手动拼接 $args（代表原始查询字符串）。否则，即使 location 匹配成功，转发到后端的 URI 也会丢失所有 GET 参数。
- ❌ 错误写法（丢参数）：
rewrite ^/old/(.*)$ /new/$1;→ 不带$args，转发为/new/path，无 ?a=1&b=2 - ✅ 正确写法（保留参数）：
rewrite ^/old/(.*)$ /new/$1?$args;→ 显式追加$args，转发为/new/path?a=1&b=2 - ⚠️ 注意：如果原始请求没有参数，
$args为空，结果是/new/path?（末尾多一个问号）。可用if判断规避，但更推荐用last+ 独立 location 方案（见下条）
用 last 跳转 + 独立 location 处理转发
rewrite 的 last 标志会让 Nginx 停止当前 location 匹配，用新 URI 重新发起 location 查找。这样可把参数保留逻辑交给后续 location 的 proxy_pass 自动处理，避免手动拼接出错。
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
- 配置示例：
location /old/ {<br> rewrite ^/old/(.*)$ /new/$1 last;<br>}<br>location /new/ {<br> proxy_pass http://backend/;<br>} - 优势：/old/api?id=123 经 rewrite 变成 /new/api?id=123，再由第二个 location 的
proxy_pass http://backend/;（带尾斜杠）完整透传路径与参数 - 关键点：第二个 location 的
proxy_pass必须以/结尾，否则参数仍可能丢失
避免 rewrite 导致 POST 数据丢失
rewrite 会触发内部重定向，对 POST 请求默认转为 GET，导致请求体（body）丢失。这不是参数问题，而是 HTTP 方法变更引发的数据清空。
- ❌ 不要对 POST 接口用普通 rewrite：
rewrite ^/v1/submit$ /v2/submit?_migrated=1;→ 方法变 GET，body 消失 - ✅ 改用 307 临时重定向（保持方法和 body）：
rewrite ^/v1/submit$ /v2/submit?_migrated=1 redirect;<br>error_page 307 = @post_proxy;<br>location @post_proxy {<br> proxy_pass http://backend/v2/submit;<br> proxy_method POST;<br>}
或更直接：用return 307替代 rewrite - 替代方案：不用 rewrite，改用
map或if + proxy_pass在原 location 内完成路径映射，绕过重写流程
检查 proxy_pass 末尾斜杠是否一致
即使 rewrite 正确，若 proxy_pass 配置不当，参数仍会丢失。核心规则：
- 当
proxy_pass值以/结尾（如http://upstream/），Nginx 会剥离 location 前缀，并将原始 URI（含完整 path + args）拼接到该路径后转发 - 当不以
/结尾（如http://upstream），Nginx 把整个原始 URI（包括 location 前缀）作为路径转发，容易导致后端路由不匹配，部分框架会忽略或截断 query string - 验证方式：在 location 中加
proxy_set_header X-Original-Args $args;，后端打印该 header 即可确认参数是否送达
