Nginx 中 proxy_pass 如何实现多路径匹配分发逻辑-Nginx-PHP中文网

nginx 的 proxy_pass 不支持动态多路径分发，依赖 location 匹配规则实现路由；常用方式包括前缀匹配（如 /api/v1/→用户服务）、正则匹配（如 /product/123→商品服务）和 map 指令条件分发（如按 $arg_version 选择后端）。

nginx 中 proxy_pass 如何实现多路径匹配分发逻辑

Nginx 的 proxy_pass 本身不直接支持“多路径匹配分发”这种动态路由逻辑，它依赖 location 块的匹配规则来决定将哪些请求交给哪个后端。真正的分发逻辑由 location 的匹配顺序、正则表达式、前缀长度和修饰符共同控制，proxy_pass 只负责把匹配到的请求转发过去。

用 location 精确匹配不同路径前缀

这是最常用也最可靠的方式。Nginx 按照最长前缀匹配原则选择 location 块，因此要把更具体的路径写在前面。

/api/v1/ → 转发到用户服务
/api/v2/ → 转发到订单服务
/static/ → 本地文件服务（不走 proxy_pass）

配置示例：

location /api/v1/ {
    proxy_pass http://users-backend/;
}
location /api/v2/ {
    proxy_pass http://orders-backend/;
}
location /static/ {
    alias /var/www/static/;
}

注意：proxy_pass 后带斜杠（http://backend/）时，会自动去除匹配到的前缀再拼接；不带斜杠（http://backend）则原样保留路径，容易出错，建议统一加尾部斜杠。

用正则 location 实现灵活路径分发

当路径规则复杂（如含 ID、版本号、可选参数），可用 ~ 或 ~* 开头的正则匹配。

/product/123 → 转发到商品服务
/user/profile?uid=456 → 转发到用户服务（query string 自动透传）

示例：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

location ~ ^/product/(\d+)$ {
    proxy_pass http://product-service/product/$1;
}
location ~* ^/user/(profile|settings) {
    proxy_pass http://user-service$request_uri;
}

注意：$request_uri 保留原始 URI（含 query string）；$uri 不含 query string；使用捕获组时确保 proxy_pass 中引用正确，避免路径重复或缺失。

用 map 指令做条件化后端选择（高级场景）

当分发逻辑依赖请求头、参数或变量时，map 是更清晰的解耦方式。

根据 Host 头指向不同集群
根据 Cookie 中的灰度标识分流
根据 $args 中的 version=v2 切后端

示例：

map $arg_version $backend {
    default     "http://v1-api";
    "v2"        "http://v2-api";
    "beta"      "http://beta-api";
}
server {
    location /api/ {
        proxy_pass $backend;
    }
}

注意：map 必须定义在 http 块内，且变量值必须是合法 URL；不支持嵌套或复杂逻辑，复杂判断建议交由上游网关处理。