必须先执行 nginx -t 校验配置语法，确认“syntax is ok”和“test is successful”同时出现后，再 reload；-t 能提前暴露端口占用、路径错误、权限不足等运行时问题，避免 reload 静默失效或服务中断。
平滑重载前必须做语法校验，否则 reload 可能静默失败、旧配置意外失效，甚至导致服务中断。校验不是走形式，而是重载能否成功的第一道防线。
为什么 nginx -t 是不可跳过的前置动作
nginx -s reload 并不会跳过语法检查——它内部会尝试加载新配置；但一旦失败，只报错退出，旧配置仍运行，表面看“没中断”，实则新配置完全未生效。更危险的是：某些错误（如 include 路径不存在、端口被占、SSL 文件权限不足）会导致 reload 命令不报错却实际未更新 worker 进程，业务看似正常，但新规则（比如新 server_name 或 rewrite）根本不起作用。
执行 nginx -t 的正确姿势
- 默认路径下直接运行：nginx -t，输出必须同时包含 syntax is ok 和 test is successful 才算通过
- 若使用非标准配置路径（如拆分到 /etc/nginx/conf.d/），需显式指定：nginx -t -c /etc/nginx/nginx.conf
- 校验时会真实读取所有 include 文件、检查证书路径可读性、验证监听端口是否可用——所以它能提前暴露 bind() failed、PEM_read_bio_X509_AUX failed 等线上高频问题
常见校验失败场景与快速应对
- Address already in use：端口被其他进程占用，用 ss -tlnp | grep :80 查定位并释放
- Permission denied：私钥文件权限过大（如 644），改为 chmod 600 /path/to/key.pem
- open() "/xxx" failed (2: No such file)：include 路径写错或文件未上传，检查路径拼写和文件是否存在
- invalid number of arguments in "proxy_pass" directive：配置语法笔误，重点检查 rewrite、proxy_pass、return 等易错指令的空格与引号
把校验纳入操作闭环，避免人为遗漏
- 在脚本中强制串联：nginx -t && nginx -s reload，确保仅当校验通过才触发重载
- CI/CD 流水线中加入 nginx -t -c $CONFIG_PATH 步骤，阻断非法配置上线
- 修改完配置后，养成习惯：先 nginx -t，再 systemctl reload nginx，最后立刻验证效果
