nginx中proxy_pass配合rewrite实现路径重写转发的核心是：rewrite在proxy_pass前执行，且proxy_pass末尾斜杠决定路径拼接方式——有/则去除location前缀，无/则保留完整uri。
Nginx 中用 proxy_pass 配合 rewrite 实现路径重写转发，核心在于理解两者的执行顺序和路径处理逻辑：rewrite 在 proxy_pass 之前执行，且 proxy_pass 的 URL 结尾斜杠（/）会直接影响路径拼接行为。
rewrite 修改请求路径，再由 proxy_pass 转发
当需要把客户端请求的路径改写后再转发给后端时，先用 rewrite 指令修改 $request_uri 或 URI，再交给 proxy_pass。注意 rewrite 默认是内部重定向（不跳转），适合做透明转发。
- 使用
break终止后续 rewrite，并立即用当前 URI 进行 proxy_pass - 使用
last会重新匹配 location，适合多级重写（但要防循环） - 避免用
redirect或permanent，它们会返回 302/301，不是代理转发
proxy_pass 末尾斜杠决定路径替换方式
这是最容易出错的地方：
-
proxy_pass http://backend;（无结尾/）：整个原始 URI（含 location 匹配部分）原样拼到后端地址后 -
proxy_pass http://backend/;（有结尾/）：location 匹配前缀被**完全去除**，只把剩余路径拼到后端根路径
例如：location /api/ { proxy_pass http://127.0.0.1:8000/; }，访问 /api/users 会转发为 http://127.0.0.1:8000/users；若写成 proxy_pass http://127.0.0.1:8000;，则转发为 http://127.0.0.1:8000/api/users。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
典型场景：去掉前缀并重写路径
比如前端请求 /v1/auth/login，需转发到后端 http://svc-auth/login，且统一把 /v1/ 去掉：
location ^~ /v1/ {
rewrite ^/v1/(.*)$ /$1 break;
proxy_pass http://svc-auth;
}
这里 rewrite 把 /v1/auth/login → /auth/login，然后 proxy_pass 不带尾部 /，所以最终发往 http://svc-auth/auth/login。若后端只认 /login，可再加一层 rewrite：
location ^~ /v1/auth/ {
rewrite ^/v1/auth/(.*)$ /$1 break;
proxy_pass http://svc-auth;
}
替代方案：用 proxy_rewrite 或 map + proxy_pass（更清晰）
复杂路径映射建议避免嵌套 rewrite，改用 map 提前定义目标路径：
map $request_uri $backend_path {
~^/v1/users/(.*)$ /users/$1;
~^/v1/orders/(.*)$ /orders/$1;
default /404;
}
server {
location /v1/ {
proxy_pass http://backend$backend_path;
}
}
这样逻辑分离，可读性和维护性更好，也避免 rewrite 执行顺序带来的歧义。
