NGINX配置需求：上游FCGI连接被拒绝时，重试指定时长后再返回502错误

你遇到的问题核心在于用错了指令集——你之前尝试的都是proxy_*系列参数，但你的场景是通过fastcgi_pass转发请求，这些proxy指令对fastcgi场景完全不生效！

要实现“重试上游20秒再返回502”的需求，你需要使用NGINX专门针对fastcgi的重试控制指令，下面是具体的解决方案：

关键指令说明 #

针对fastcgi场景，你需要用到这几个核心指令：

• fastcgi_next_upstream：指定哪些错误/状态下，NGINX会尝试连接下一个上游服务器（包括连接失败、超时等）
• fastcgi_next_upstream_timeout：设置重试的总时长上限，这里你可以设为20秒
• fastcgi_next_upstream_tries：设置重试的总次数上限（可以和时长二选一，或者配合使用，比如设一个较大的次数，让时长限制优先生效）
• fastcgi_connect_timeout：单个上游连接的超时时间，建议设短一点（比如2秒），避免单次连接等待太久拖慢重试节奏

修改后的完整配置 #

把这些指令添加到你的location ~ \.fcgi$块中，最终的fastcgi location块应该是这样：

location ~ \.fcgi$ {
    root /usr/share/nginx/html_live/;
    fastcgi_keep_conn on;
    fastcgi_pass backend_nomad_internal2;
    fastcgi_index index.html;
    fastcgi_split_path_info ^(.*cgi)(/.*)$;
    fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;
    fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
    include fastcgi_params;

    # 新增的重试控制指令
    fastcgi_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
    fastcgi_next_upstream_timeout 20s;  # 总重试时长上限20秒
    fastcgi_next_upstream_tries 0;      # 0表示不限制重试次数，由时长控制
    fastcgi_connect_timeout 2s;         # 单个连接超时2秒，快速失败后重试下一个上游
}

配置生效逻辑 #

1. 当某个上游FCGI服务器拒绝连接时，NGINX会触发fastcgi_next_upstream的条件，立即尝试连接上游池中的下一个服务器
2. 如果所有上游都不可用，NGINX会循环重试，直到达到fastcgi_next_upstream_timeout设置的20秒上限
3. 只有当20秒内所有重试都失败时，NGINX才会返回502错误给客户端

注意事项 #

• 把fastcgi_next_upstream_tries设为0表示不限制重试次数，完全由总时长控制，这样能更好地匹配你“最多等20秒”的需求
• 保留fastcgi_keep_conn on是正确的，它能让NGINX和FCGI服务器保持长连接，减少重启恢复后的连接开销
• 不需要额外配置健康检查（比如ngx_http_upstream_module的健康检查），因为你的场景是短暂的重启不可用，重试机制已经足够覆盖

备注：内容来源于stack exchange，提问作者JPBro