Nginx 中 proxy_next_upstream 指令有什么作用？

推荐答案

proxy_next_upstream 指令用于控制 Nginx 在什么情况下将请求转发到下一个上游服务器。当上游服务器返回特定的错误或超时时，Nginx 会根据该指令的配置决定是否尝试将请求转发到下一个可用的上游服务器。

本题详细解读

1. 指令作用

proxy_next_upstream 指令的主要作用是定义在什么情况下 Nginx 会将请求转发到下一个上游服务器。默认情况下，Nginx 会在上游服务器返回错误、超时或无法连接时，尝试将请求转发到下一个服务器。

2. 指令语法

proxy_next_upstream error | timeout | invalid_header | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | non_idempotent | off ...;

• error：上游服务器发生错误时（如连接错误、读取错误等）。
• timeout：上游服务器响应超时。
• invalid_header：上游服务器返回无效的响应头。
• http_500：上游服务器返回 500 状态码。
• http_502：上游服务器返回 502 状态码。
• http_503：上游服务器返回 503 状态码。
• http_504：上游服务器返回 504 状态码。
• http_403：上游服务器返回 403 状态码。
• http_404：上游服务器返回 404 状态码。
• http_429：上游服务器返回 429 状态码。
• non_idempotent：允许对非幂等请求（如 POST 请求）进行重试。
• off：禁用 proxy_next_upstream 功能。

3. 使用场景

• 负载均衡：在负载均衡场景中，当某个上游服务器不可用时，Nginx 可以根据 proxy_next_upstream 的配置将请求转发到其他可用的服务器，从而提高系统的可用性。
• 错误处理：当上游服务器返回特定的错误状态码时，Nginx 可以将请求转发到下一个服务器，避免用户看到错误页面。

4. 示例配置

// www.javascriptcn.com code example
upstream backend {
    server backend1.example.com;
    server backend2.example.com;
}

server {
    location / {
        proxy_pass http://backend;
        proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
    }
}

在这个示例中，如果 backend1.example.com 返回 500、502、503 或 504 状态码，或者发生连接错误或超时，Nginx 会将请求转发到 backend2.example.com。

5. 注意事项

• 幂等性：默认情况下，Nginx 不会对非幂等请求（如 POST 请求）进行重试，除非显式配置了 non_idempotent 选项。
• 性能影响：频繁的重试可能会增加上游服务器的负载，因此需要根据实际情况合理配置 proxy_next_upstream。