Nginx 中 HTTP 代理怎么通过重写实现路径规范化-Nginx-PHP中文网

nginx http代理路径规范化核心是可控转换uri后再转发，关键取决于location匹配、proxy_pass结尾斜杠及rewrite flag组合；需避免last引发循环，推荐用map替代if，结合x-forwarded-prefix或proxy_rewrite提升健壮性。

nginx 中 http 代理怎么通过重写实现路径规范化

Nginx 中 HTTP 代理实现路径规范化，核心是让客户端请求的 URI 经过可控、可预测的转换后再转发给后端，避免路径错位、前缀残留或版本混乱等问题。这不单是“改个地址”，而是确保代理行为与后端路由契约一致。

重写发生在代理前，且只影响当前 location 内部的 $uri

rewrite 指令在 proxy_pass 执行之前运行，它修改的是 Nginx 内部的请求 URI（即 $uri 变量），但不会自动改变 proxy_pass 的目标地址——是否拼接、如何拼接，取决于 proxy_pass 末尾是否有斜杠，以及 rewrite 使用的 flag。

关键规则要对齐：location 匹配方式 + proxy_pass 结尾斜杠 + rewrite flag

若 location /api/ 配合 proxy_pass http://backend/（结尾带 /）：
Nginx 会把匹配到的 /api/ 前缀自动剥离，再把剩余路径拼到 http://backend/ 后面。此时 rewrite 通常不需要处理前缀剥离，除非你要做额外映射（比如加版本号）。
若 location /api/ 配合 proxy_pass http://backend（结尾无 /）：
整个原始路径（含 /api/）会被原样转发。这时必须用 rewrite 显式去掉前缀，并配合 break 终止重写流程，否则可能触发重复匹配。

常见写法示例：

去除 /api/v1/ 前缀，转发至后端根路径

Nginx Hosting
通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载
```
location ^~ /api/v1/ {
    rewrite ^/api/v1/(.*)$ /$1 break;
    proxy_pass http://backend;
}
```

统一补全 /v2/ 前缀（如所有请求走 v2 接口）

location / {
    rewrite ^/(.*)$ /v2/$1 break;
    proxy_pass http://backend;
}

按 query 参数动态切换路径（推荐用 map 替代 if）

map $arg_env $backend_path {
    default   "/prod";
    "test"    "/test";
    "dev"     "/dev";
}
server {
    location / {
        rewrite ^/(.*)$ $backend_path/$1 break;
        proxy_pass http://backend;
    }
}

别踩这些坑

last 在 proxy_pass 前容易引发循环：它会让 Nginx 重新匹配 location，如果新 URI 又命中当前块，就会无限重试。改用 break 更安全。
rewrite_log on 配合 error_log ... notice 能看清每步重写结果，调试时必开。
多条 rewrite 要注意顺序：前面改过的 $uri 会影响后面规则的正则匹配，必要时用 return 404 或 rewrite ... break 提前退出。
静态资源用 alias 时，rewrite 后的路径必须和 alias 目录结构严格对应，否则 404。