nginx error_log配置遵循分层覆盖原则：全局（main）设error级守底线，server块按业务重要性差异化设warn或error级，location内可临时启用debug或关闭日志，避免泛滥与遗漏。
全局与局部 error_log 配置的关键不是统一设级，而是分层覆盖、按需收放：全局守住底线，局部精准提级，避免日志泛滥或关键线索丢失。
全局只设 error 级，专守 master 进程异常
在 nginx.conf 最外层（main 上下文）配置：
- error_log /var/log/nginx/global_error.log error; —— 仅记录端口占用、fork 失败、配置加载崩溃等停服级问题
- 不设 info、notice 或 warn：这些级别会在 reload 时刷出大量生命周期日志，干扰判断且无业务价值
- 路径建议独立，不与 server 日志混用，便于快速定位 Nginx 自身故障
server 块按业务重要性差异化设置
HTTP 层错误（如 502/504、证书过期、重定向循环）发生在 server 或 location 内，这里才是调优主战场：
- 核心 API 服务：error_log /var/log/nginx/api_error.log warn; —— 捕获 upstream refused、client sent too large body 等高价值预警，日增通常 ≤50MB
- 静态资源或健康检查接口：error_log /var/log/nginx/static_error.log error; —— 只记真实失败，屏蔽 404、favicon.ico 找不到等冗余事件
- 完全不需要错误日志的 location（如 /ping）可设为 error_log off;
location 内支持临时降级或定向 debug
调试时无需开放全站日志，而是“打点式”捕获：
- 缩小范围：location /v1/users { error_log /var/log/nginx/user_debug.log debug; }
- 加条件限制（仅限 location 内）：if ($http_x_debug = "1") { error_log /var/log/nginx/trace.log debug; }
- debug 必须满足两个前提：Nginx 编译含 --with-debug（用
nginx -V | grep with-debug验证），且日志路径必须写入独立磁盘分区（如/mnt/ssd/）
验证是否生效，别只看配置
改完配置后，实际日志输出常被覆盖而不自知：
- 运行
grep -r "error_log" /etc/nginx/ --include="*.conf" | grep -v "#"查看各层级声明位置 - 若某 server 块内有独立 error_log 行，则该站点完全忽略全局设置
- 若全局和 server 都没配，Nginx 使用编译默认值 error
- 结合
iostat -x 1和df -h /var/log观察 IO 负载与日志增长，warn 级下日增超 50MB 就该收缩范围
