nginx -t仅检查语法，不检测端口占用；启动失败需查error.log末尾报错，再用ss或netstat定位占用进程并停服或改端口。
配置语法检查本身不能发现端口被占用问题，因为 nginx -t 只校验配置文件格式和指令合法性，不检测运行时资源冲突。真正提示“端口被占”的线索，一定出现在启动失败后的错误日志里，而不是 -t 的输出中。
先确认 nginx -t 是否通过
这是排查的第一步，但只是基础门槛：
- 执行
nginx -t或nginx -t -c /path/to/nginx.conf（指定配置路径） - 若报错如
unexpected "}"、unknown directive "stream"，说明配置有硬伤，必须先修复语法或模块缺失问题 - 若显示
syntax is ok且test is successful，说明配置无误，问题大概率出在运行环境——比如端口、权限、路径等
看 error.log 最后几行锁定真实原因
即使 -t 通过，启动仍可能失败。关键线索藏在错误日志末尾：
- 宝塔用户：打开 /www/wwwlogs/nginx_error.log
- 源码编译用户：查看 /usr/local/nginx/logs/error.log
- 重点关注最后 5～10 行，典型报错包括：
–bind() to 0.0.0.0:80 failed (98: Address already in use)
–open() "/var/log/nginx/access.log" failed (13: Permission denied)
–SSL_CTX_use_PrivateKey_file(...) failed（私钥路径错或权限过宽）
查端口占用的实操命令
发现 Address already in use 后，立即定位谁在抢端口：
- Linux（通用）：
ss -tuln | grep ':80'或lsof -i :80 - Linux（需 root 权限才显示 PID 和进程名）：
sudo lsof -i :80 - Windows：
netstat -ano | findstr :80，再用任务管理器根据 PID 找进程 - 常见抢占者：IIS（w3wp.exe / W3SVC）、Apache（httpd）、另一个 Nginx 实例、Caddy、甚至 Windows 自带的 softwareupdate 或 Hyper-V
解决端口冲突的常用方式
确认占用者后，按实际场景选择处理路径：
- 停掉无关服务：
– Linux 停 Apache：sudo systemctl stop apache2
– Windows 停 IIS：net stop w3svc或在服务管理器中停止 “World Wide Web Publishing Service” - 改 Nginx 监听端口（适合开发或测试）：
在 server 块中把listen 80;改为listen 8080;，保存后nginx -s reload - 保留原端口但让 Nginx 以 root 运行（Linux 必须；Windows 需“以管理员身份运行”）：
普通用户无法绑定 1–1023 端口，Nginx 主进程必须由 root 启动才能监听 80/443
