在 nginx 中配置 upstream 实现故障转移，核心在于使用 upstream 模块定义后端服务器组，并配合 proxy_pass 指令将请求转发给该组。nginx 默认采用轮询（round robin）或 ip hash 等负载均衡策略，当某台后端服务器因连接超时或返回错误状态码（如 502、504）时，nginx 会自动将该请求转发给组内其他健康的服务器，从而实现高可用。
如何配置基础负载均衡与故障转移参数
要实现基础的故障转移，需要在 nginx.conf 的 http 块中定义 upstream 块，并在其中列出所有后端服务器的地址。通过设置 max_fails 和 fail_timeout 参数，可以控制 Nginx 判定服务器故障的频率和时间窗口。例如，如果一台服务器在 fail_timeout 时间内连续失败 max_fails 次，Nginx 会在接下来的 fail_timeout 时间内不再向该服务器发送请求，而是将其标记为不可用，直到时间窗口结束重新尝试。
events {
worker_connections 1024;
}
http {
upstream backend_pool {
# 定义后端服务器列表
server 192.168.1.10:8080 max_fails=3 fail_timeout=30s;
server 192.168.1.11:8080 max_fails=3 fail_timeout=30s;
server 192.168.1.12:8080 max_fails=3 fail_timeout=30s;
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_pool;
# 可选：指定哪些 HTTP 状态码视为失败
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}
}
}
上述配置中，max_fails=3 表示允许的最大失败次数，fail_timeout=30s 表示失败后的冷却时间。当任意一台服务器连续三次响应错误或超时，Nginx 将在 30 秒内忽略该服务器，并将流量分配给其余两台。这种机制确保了单点故障不会导致整个服务不可用。
如何结合健康检查与权重实现更精细的控制
除了基础的故障转移，还可以通过设置 weight 参数来调整不同服务器的负载比例，或者使用第三方模块（如 nginx-upstream-check-module）进行主动健康检查。在标准 Nginx 中，虽然缺乏主动探测能力，但可以通过 proxy_next_upstream 指令细化触发故障转移的条件。例如，仅当发生网络错误或特定 HTTP 错误时才进行转移，而避免因为业务逻辑错误（如 404）导致的无效重试。
# 假设我们有一个主备场景，主服务器权重高，备用服务器权重低
upstream backend_pool {
server 192.168.1.10:8080 weight=5 max_fails=3 fail_timeout=30s; # 主节点
server 192.168.1.11:8080 weight=1 max_fails=3 fail_timeout=30s; # 备节点
server 192.168.1.12:8080 backup; # 备份节点，仅在主备都不可用时启用
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_pool;
proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
}
}
在此配置中，weight=5 和 weight=1 使得主节点承担大部分流量，而备用节点仅在必要时介入。backup 标志的服务器在所有非备份服务器都不可用时才会被激活。这种组合配置不仅实现了故障转移，还优化了资源利用率。当主节点发生故障时，流量会平滑过渡到备用节点，确保服务连续性。
当所有后端服务器均不可用时 Nginx 的行为是什么
如果 upstream 组中的所有服务器都被标记为不可用（例如，由于持续的高错误率或手动下线），Nginx 将无法找到可用的后端节点来处理请求。此时，Nginx 会直接返回一个 502 Bad Gateway 或 504 Gateway Timeout 错误给客户端，具体取决于 proxy_next_upstream 的配置和超时设置。为了提升用户体验，可以配置自定义的错误页面或使用 error_page 指令提供友好的提示信息。
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_pool;
proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
}
# 自定义错误页面
error_page 502 503 504 /custom_error.html;
location = /custom_error.html {
root /usr/share/nginx/html;
internal;
}
}
在这种情况下，即使所有后端都宕机，用户看到的也不是默认的 Nginx 错误页，而是预先准备好的 custom_error.html。这有助于维护品牌形象，并告知用户系统正在维护或暂时不可用。同时，Nginx 会定期重新检测后端服务器的状态，一旦有服务器恢复，流量将自动切回，无需人工干预。
