ajp_next_upstream

`ajp_next_upstream` 指令控制当 AJP 服务器未能正确响应时 NGINX 的行为,决定是重试还是将请求转发给下一个 upstream 服务器。

语法ajp_next_upstream [error | timeout | invalid_header |http_502 | http_503 | http_504];
默认值error;
上下文http, server, location
参数1+

说明

ajp_next_upstream 指令用于在 NGINX 配置中代理使用 AJP (Apache JServ Protocol) 的请求。AJP 用于在 Web 服务器与应用服务器之间通信,例如当 NGINX 与 Tomcat 对接时。该指令指定在当前 AJP 服务器出现错误时,NGINX 应在何种条件下尝试将请求转发到 upstream 块中的下一个服务器。该指令接受的参数可以包括表示超时、连接失败或其他错误的各种状态码。

当请求因这些指定条件之一失败时,NGINX 会自动使用 upstream 块中列出的下一个 upstream 服务器重试该请求。ajp_next_upstream 的行为对于确保应用请求可靠处理至关重要,尤其是在有多个后端服务器的环境中。通过指定哪些错误类型应触发重试,可以对该指令进行细粒度调整,以在性能与可靠性之间取得平衡,使管理员能够根据其应用需求的具体情况配置代理策略。

当与 connection pooling 和 keep-alive 设置结合使用以通过减少建立新连接的开销来提高性能时,ajp_next_upstream 指令尤为有用。然而,应谨慎使用它,因为在某些错误条件下不恰当的重试可能导致客户端等待时间延长并可能使 upstream 服务器过载。

配置示例

http {
    upstream tomcats {
        server 127.0.0.1:8009;
        keepalive 10;
    }

    server {
        listen 80;

        location / {
            ajp_invalidate_headers on;
            ajp_pass tomcats;
            ajp_next_upstream error timeout;
        }
    }
}

确保上游服务器已正确配置为在 AJP 端口上监听。

过多的重试可能导致客户端等待时间延长,如果管理不当,还可能使后端服务器过载。

在选择状态码时要谨慎;不小心包含过多条件可能会影响性能。

← 返回所有指令