Web 服务器与网关 / 系统课时
配置被动健康检查
配置被动健康检查
本课学习 Nginx 如何通过代理请求结果判断后端节点是否异常,并使用 max_fails、fail_timeout 和重试规则减少故障节点对业务的影响。
学习目标
- 理解 Nginx 被动健康检查的触发条件。
- 掌握 max_fails 和 fail_timeout 的配置方式。
- 了解自动重试对非幂等请求的风险。
理解被动健康检查机制
Nginx 开源版默认采用被动健康检查,也就是在真实转发请求过程中观察后端响应。如果某个节点连续出现失败,Nginx 会在指定时间内降低该节点的使用频率。
max_fails 表示允许失败次数,fail_timeout 同时定义失败统计窗口和节点暂时不可用时间。当节点恢复后,Nginx 会重新尝试发送请求。

配置失败检测规则
下面配置表示节点连续失败 3 次后,在 30 秒内不再发送请求。
nginx
http {
upstream app_backend {
# 失败次数达到阈值后暂时摘除
server 10.0.0.10:8080 max_fails=3 fail_timeout=30s;
server 10.0.0.11:8080;
}
server {
listen <PORT>;
location /api/ {
proxy_pass http://app_backend;
proxy_next_upstream error timeout http_502 http_503 http_504;
}
}
}预期结果
text
当 10.0.0.10 连续出现连接错误、超时或指定错误响应时,Nginx 暂时减少向该节点转发请求。控制代理重试行为
proxy_next_upstream 决定哪些情况允许切换到下一个 upstream 节点。常见条件包括连接失败、超时和部分服务端错误。
重试机制适合查询接口等幂等请求,例如 GET 查询。对于创建订单、支付等非幂等请求,自动重试可能导致业务重复执行,需要结合请求幂等设计。
nginx
location /orders/ {
proxy_pass http://app_backend;
# 创建类接口通常避免自动重试
proxy_next_upstream off;
}预期结果
text
订单请求失败时,Nginx 不会自动发送第二次请求,避免重复创建业务数据。排查健康检查失效问题
当异常节点没有被摘除时,需要检查失败类型是否匹配规则。默认情况下,并不是所有 HTTP 状态码都会触发节点失败统计。
同时要确认后端响应时间是否超过超时设置。如果请求一直等待而没有达到失败条件,Nginx 不会立即执行切换。
按自己的节奏,确认真正理解。