Nginx 配置校验

先 nginx -t -c /etc/nginx/nginx.conf 测试，输出 syntax is ok / test is successful 才 nginx -s reload。不要跳过 -t 直接 reload，语法错会拒载旧配置仍生效，容易误判。

多半是指令拼错或对应模块没加载（如 stream 模块没编进 nginx）。用 nginx -V 看编译参数是否含 --with-stream，缺则重新编译或换等效配置。

upstream 里的域名 nginx 解析不到。常见于上游域名拼错、DNS 不通、或 upstream 里写了 IP 又写了端口。用 dig 确认域名能解析，或直接用 IP。

端口被占用。用 ss -tlnp | grep :80 看谁占着；常见是另一个 nginx 实例、Apache、或上次进程未退出。杀掉旧进程或改监听端口。

诚实说明：浏览器不能替你测你服务器的 nginx 配置。这个工具生成正确的 nginx -t 测试命令 + 常见错误对照表，复制到你的服务器执行，得到真实校验结果。不做「点击即测」假承诺。

生成测试命令

输入配置路径，生成测试与转储命令。

配置文件路径

报错	原因	处置
`unknown directive`	指令拼错 / 模块未加载	查拼写；`nginx -V` 看编译参数是否含该模块
`directive is not allowed here`	指令放错上下文	http / server / location 层级搞错，挪到正确块
`host not found in upstream`	upstream 域名解析失败	`dig` 确认域名；直接用 IP 或修 DNS
`emerg bind() failed`	端口被占用	`ss -tlnp \\| grep :80` 找占用者
`conflicting server name`	server_name 重复	两个 server 块同名，合并或改名
`"upstream" directive is not allowed here`	upstream 放错块	upstream 必须在 http 层，不能进 server