nginx 的 -t 参数用于语法与基础合法性校验但不加载配置；支持默认路径、自定义配置文件及安装前缀指定；成功显示“syntax is ok”和“test is successful”，失败提示具体错误位置；常配合 reload 使用，但无法检测 ssl 证书、后端可达性、rewrite 循环及权限等运行时问题。
Nginx 的 -t 参数用于检查配置文件的语法是否正确，同时验证配置项是否合法（如路径是否存在、端口是否被占用等基础校验），但不会真正加载配置或启动服务。
基本用法
执行以下命令即可进行测试：
-
nginx -t：使用默认配置路径（通常是/etc/nginx/nginx.conf） -
nginx -t -c /path/to/custom.conf：指定自定义配置文件路径 -
nginx -t -p /path/to/prefix/：指定 Nginx 安装前缀（影响日志路径、相对路径解析等）
常见输出含义
成功时显示：
nginx: the configuration file /etc/nginx/nginx.conf syntax is oknginx: configuration file /etc/nginx/nginx.conf test is successful
失败时会指出具体错误位置，例如：
nginx: [emerg] unknown directive "lsten" in /etc/nginx/conf.d/example.conf:10注意：[emerg] 表示紧急错误，lsten 是拼写错误（应为 listen），行号和文件路径有助于快速定位问题。
配合重载使用的典型流程
修改配置后，推荐按如下顺序操作，避免服务中断：
- 先运行
nginx -t确认语法无误 - 若通过，再执行
nginx -s reload或systemctl reload nginx - 如果
-t失败，切勿 reload，否则可能导致服务停止
注意事项
-t 不会检查所有运行时问题，例如：
- SSL 证书文件是否存在或格式是否正确（仅检查路径是否存在）
- upstream 后端服务器是否真实可达
- rewrite 规则在实际请求中是否产生循环或意外跳转
- 权限问题（如 worker 进程无法读取日志目录）通常在启动时才暴露
