使用 nginx -t 命令可以验证 nginx 配置文件的语法正确性,包括健康检查相关的指令。该工具会解析配置文件并报告任何语法错误或警告,确保配置在重启或重载前是有效的。

如何检查 upstream 中的健康检查配置
对于基于 upstream 模块的健康检查,nginx -t 会验证 server 指令中的 max_fails、fail_timeout 等参数是否合法。这些参数定义了后端服务器被视为不可用的条件。

worker_processes 1;
events {
worker_connections 1024;
}
http {
upstream backend {
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 {
listen 80;
location / {
proxy_pass http://backend;
}
}
}
运行 nginx -t 后,如果配置无误,将输出 syntax is ok 和 test is successful。若 max_fails 设置为负数或非数字,则会报错。
如何检查 stream 模块中的健康检查配置
在 stream 模块中,健康检查同样通过 upstream 块定义。nginx -t 会验证 stream 上下文下的 upstream 指令及其子指令的合法性。这包括 TCP/UDP 代理场景下的后端服务器状态监控参数。

stream {
upstream backend_stream {
server 192.168.1.10:9090 max_fails=3 fail_timeout=30s;
server 192.168.1.11:9090 max_fails=3 fail_timeout=30s;
}
server {
listen 9090;
proxy_pass backend_stream;
}
}
同样,执行 nginx -t 会检查 stream 块内的语法。如果 proxy_pass 指向的 upstream 名称不存在或拼写错误,nginx -t 会明确指出该错误,防止因配置错误导致服务无法启动。
当 max_fails 设置为 0 时行为如何
当 max_fails 设置为 0 时,Nginx 会禁用对该后端服务器的失败次数统计,即认为该服务器始终可用,不会将其标记为不可用。这在需要强制流量分发到特定服务器时非常有用。


















