Nginx配置检查测试

引言

改完Nginx配置直接reload最容易踩坑：语法错、证书路径错、端口被占会导致Nginx起不来甚至站点全挂。规范流程是先检查语法，通过后再平滑重载，出问题能快速回退。

语法检查

nginx -t

检查默认配置文件语法，输出syntax ok和test is successful才说明配置无误。

指定配置文件检查

nginx -t -c /etc/nginx/nginx.conf

自定义路径时用-c指定，避免检查错文件。

平滑重载

nginx -s reload

不中断现有连接重新加载配置，改动生效不宕机。

查看编译参数和版本

nginx -V

大写V看版本和编译模块，确认是否包含ssl、gzip、stream等模块。

打印生效配置

nginx -T

大写T会把所有include进来的配置打印出来，排查重复server或覆盖时用。

出错常见原因

• 括号不配对、分号漏写；
• 证书key路径不存在或权限600不对；
• listen端口已被其他进程占用；
• upstream后端地址写错；
• include路径下的文件本身语法错。

注意事项

• 永远先-t再reload，禁止跳过检查；
• 改配置前备份原文件，出错可立刻回退；
• -T输出很长，重定向到文件再查；
• reload失败先看error.log定位行号；
• 生产环境改完curl本机验证再放行；
• 多台机器逐台灰度，不要一次全改。

总结

nginx -t检查语法，-c指定文件，-s reload平滑生效，-V看编译模块，-T打印完整配置。铁律是先检查通过再重载，改前备份、出错看error.log、本机curl验证后再上线，生产逐台灰度，避免一次改全量导致整站不可用。