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 不会立即执行切换。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置被动健康检查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通