Nginx 中 location 和 proxy_pass 的 URI 处理方式

在 Nginx 中，location 和 proxy_pass 的 URI 处理方式主要取决于 proxy_pass 指令中目标 URL 的写法以及是否包含 URI 部分。Nginx 提供了几种不同的 URI 处理方式，具体可以分为以下几种情况：

1. 直接转发，不修改 URI

当 proxy_pass 的目标地址不包含 URI 部分（即只有协议、主机和端口，例如 http://backend 或 http://10.5.140.191:8000），Nginx 会将客户端请求的完整 URI 直接传递给后端服务器。

特点：

• 客户端请求的 URI 保持不变，完整地转发到后端。
• 适用于大多数简单的代理场景。

例子：

server {
    listen 80;
    server_name example.com;

    location /b-aiops-ml/v1/ {
        proxy_pass http://10.5.140.191:8000;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/api/test
• 转发到后端：http://10.5.140.191:8000/b-aiops-ml/v1/api/test
• 说明：客户端的完整 URI /b-aiops-ml/v1/api/test 被直接传递到后端服务器。

2. 替换 URI 部分

当 proxy_pass 的目标地址包含 URI 部分（例如 http://backend/newpath/），Nginx 会将 location 匹配的 URI 前缀替换为 proxy_pass 中指定的 URI。

特点：

• location 匹配的 URI 前缀会被替换为 proxy_pass 中指定的 URI。
• 客户端请求 URI 的剩余部分会追加到 proxy_pass 的 URI 后。

例子：

server {
    listen 80;
    server_name example.com;

    location /b-aiops-ml/v1/ {
        proxy_pass http://10.5.140.191:8000/api/;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/test
• 转发到后端：http://10.5.140.191:8000/api/test
• 说明：location 匹配的 /b-aiops-ml/v1/ 被替换为 proxy_pass 中的 /api/，剩余的 test 追加到后面。

注意：如果 proxy_pass 的 URI 以斜杠 / 结尾，Nginx 会保留客户端请求的路径部分；如果不以斜杠结尾，Nginx 会直接使用指定的 URI，忽略客户端请求的路径部分。

3. 精确匹配 URI

当 location 使用精确匹配（= 修饰符），Nginx 只会匹配完全相同的 URI，并将其转发到 proxy_pass 指定的地址。如果 proxy_pass 包含 URI，则会完全替换客户端的 URI。

特点：

• 仅匹配特定 URI，适用于特定的端点（如健康检查）。
• 如果 proxy_pass 指定了 URI，则客户端 URI 会被完全替换。

例子：

server {
    listen 80;
    server_name example.com;

    location = /b-aiops-ml/v1/health {
        proxy_pass http://10.5.140.191:8000/healthcheck;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/health
• 转发到后端：http://10.5.140.191:8000/healthcheck
• 说明：精确匹配 /b-aiops-ml/v1/health，将其替换为 /healthcheck，不保留任何额外的路径。

4. 使用 rewrite 指令改写 URI

通过结合 rewrite 指令，可以在转发之前对 URI 进行更复杂的重写，然后再通过 proxy_pass 转发到后端。

特点：

• rewrite 允许对 URI 进行正则表达式匹配和替换。
• 常用于需要复杂 URI 转换的场景。

例子：

server {
    listen 80;
    server_name example.com;

    location /b-aiops-ml/v1/ {
        rewrite ^/b-aiops-ml/v1/(.*)$ /api/v1/$1 break;
        proxy_pass http://10.5.140.191:8000;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/test
• 转发到后端：http://10.5.140.191:8000/api/v1/test
• 说明：rewrite 指令将 /b-aiops-ml/v1/ 重写为 /api/v1/，然后 proxy_pass 将处理后的 URI 转发到后端。

5. 不带斜杠的 proxy_pass（特殊情况）

如果 proxy_pass 的目标地址不以斜杠 / 结尾，Nginx 会直接使用指定的 URI，忽略客户端请求的路径部分。这种情况较为少见，通常用于完全重定向到固定路径。

例子：

server {
    listen 80;
    server_name example.com;

    location /b-aiops-ml/v1/ {
        proxy_pass http://10.5.140.191:8000/api;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/test
• 转发到后端：http://10.5.140.191:8000/api
• 说明：由于 proxy_pass 的 URI 是 /api（不以斜杠结尾），客户端的 /test 部分被忽略，后端接收到的 URI 固定为 /api。

6. 使用变量动态构建 URI

Nginx 允许在 proxy_pass 中使用变量（如 $uri 或 $request_uri）来动态构造后端的 URI。这种方式非常灵活，适用于需要动态调整 URI 的场景。

例子：

server {
    listen 80;
    server_name example.com;

    location /b-aiops-ml/v1/ {
        proxy_pass http://10.5.140.191:8000$uri;
        proxy_set_header Host $host;
    }
}

• 请求：http://example.com/b-aiops-ml/v1/test
• 转发到后端：http://10.5.140.191:8000/b-aiops-ml/v1/test
• 说明：$uri 包含客户端请求的规范化 URI（即 /b-aiops-ml/v1/test），直接附加到 proxy_pass 的目标地址后。

总结

以下是 location 和 proxy_pass URI 处理的主要方式及特点：

注意事项

• 斜杠的重要性：proxy_pass 目标地址是否以 / 结尾会显著影响 URI 处理行为。建议明确指定以避免歧义。
• 正则表达式：如果 location 使用正则表达式（如 ~ 或 ~*），需要特别注意 URI 的匹配顺序和优先级。
• 调试：使用 Nginx 的访问日志（access_log）和错误日志（error_log）来验证 URI 是否按预期转发。