Nginx在Debian上的错误排查方法有哪些

Nginx 在 Debian 上的系统化错误排查

一 快速定位流程

• 确认服务状态与端口：使用 systemctl status nginx 查看是否运行；用 ss -tlnp | grep ‘:80|:443’ 检查是否监听 80/443。
• 语法与包含文件校验：执行 nginx -t，它会解析主配置及所有 include 文件并报告语法或权限问题。
• 查看错误与访问日志：优先看 /var/log/nginx/error.log 与 /var/log/nginx/access.log，定位错误码、请求 URI、上游信息等线索。
• 查看系统侧日志：用 journalctl -xe 与 tail -f /var/log/syslog 捕捉服务启动失败、权限、资源等系统级报错。
• 本机连通性自检：执行 curl -Iv http://127.0.0.1/ 或针对具体 server_name 测试，排除应用层问题。
• 防火墙与安全策略：检查 ufw status，必要时放行 80/tcp 与 443/tcp；如使用云厂商安全组，同步放通。
• 变更生效：修复后先 nginx -t，再 systemctl reload nginx 或 restart。

二 常见错误场景与对策

三 日志与网络诊断

• 日志位置与实时查看：Nginx 默认日志在 /var/log/nginx/access.log 与 /var/log/nginx/error.log；可用 tail -f /var/log/nginx/error.log 实时跟踪。
• 关联日志定位：
  • PHP 错误：检查 /var/log/php-fpm.log 或 /var/log/php/*-fpm.log（版本不同路径不同）。
  • 数据库错误：检查 /var/log/mysql/error.log。
• 网络与连接诊断：
  • 连接状态：ss -tlnp | grep nginx；外部连通：ping / curl；
  • 抓包分析：tcpdump -i any -nn port 80 or 443；
  • 防火墙与安全组：Debian 常见 ufw allow 80,443/tcp；云上需同步放通安全组规则。

四 配置变更与维护

• 安全变更流程：修改配置后先 nginx -t 校验，再 systemctl reload nginx 热加载，避免中断现网连接。
• 日志轮转与清理：使用 logrotate 管理 /var/log/nginx/*.log，设置按大小/时间轮转与压缩，防止磁盘被日志占满。
• 极端崩溃与核心转储：在 events/http 段设置 worker_rlimit_core 500m; 并确保目录可写；崩溃后用 gdb /usr/sbin/nginx core.pid 分析；生产环境谨慎开启。
• 版本与依赖：保持系统与 Nginx 更新（apt update && apt upgrade），必要时修复依赖（apt-get install -f）。

五 一键排查命令清单

• 服务与端口：
  • systemctl status nginx
  • ss -tlnp | grep ‘:80|:443’
• 配置与语法：
  • nginx -t
  • systemctl reload nginx
• 日志与系统：
  • tail -f /var/log/nginx/error.log /var/log/nginx/access.log
  • journalctl -xe
  • tail -f /var/log/syslog
• 连通与网络：
  • curl -Iv http://127.0.0.1/
  • ping 目标域名或 IP
  • tcpdump -i any -nn port 80 or 443
• 防火墙：
  • ufw status
  • ufw allow 80/tcp
  • ufw allow 443/tcp