应严格限制 debug 日志范围与生命周期：仅临时启用、按 server/location 作用域配置、配合 logrotate 轮转、监控磁盘、快速关闭并清理。
将 error_log 级别设为 debug 会显著增加日志量，尤其在高并发或复杂模块（如 Lua、OpenResty、SSL、upstream）启用时，极易导致磁盘写满、I/O 压力飙升甚至服务卡顿。排查核心不是“怎么查日志”，而是“如何精准控制 debug 日志的输出范围和生命周期”。
确认 debug 日志是否真的必要
debug 级别日志不用于日常运维，仅用于临时定位特定问题。上线环境严禁长期开启。排查前先问自己：
- 当前遇到的具体问题是哪一类？（例如：SSL 握手失败、rewrite 不生效、upstream 转发异常）
- 是否有更轻量的方式复现和验证？（比如用
curl -v、tcpdump、strace或模块专属调试指令） - 能否只对某一个 server 块或 location 块开启 debug，而非全局？
使用作用域限定缩小 debug 输出范围
Nginx 支持按 server、location、http 块分别设置 error_log，优先级从高到低。应避免在 http 块直接写 error_log /path/debug.log debug。
推荐做法：
- 在出问题的
server块内单独配置：error_log /var/log/nginx/debug-example.com.log debug; - 若问题集中在某个接口，进一步缩小到
location：location /api/v1/test { error_log /var/log/nginx/debug-api.log debug; ... } - 配合
pid或请求特征（如特定 header、IP）用map+log_subrequest on按需触发（需自定义模块支持，OpenResty 更灵活）
限制日志文件大小与轮转，防止磁盘打爆
即使限定了作用域，debug 日志仍可能快速增长。必须搭配日志切割：
- 使用
logrotate配置强制轮转（示例）：/var/log/nginx/debug-*.log { daily missingok rotate 3 compress delaycompress } - 在 Nginx 配置中启用内置轮转（需 reload）：
error_log /var/log/nginx/debug.log debug; # reload 后自动重开新文件 - 加监控：用
inotifywait或 Prometheus + node_exporter 监控日志目录大小，超阈值告警并自动 reload 或暂停 debug
快速关闭 debug 并清理残留
一旦获取到关键线索，立刻停用 debug：
- 将对应
error_log行注释或降级为info/warn，执行nginx -t && nginx -s reload - 注意：reload 不会自动清空正在写的 debug 文件，需手动
truncate -s 0 /path/to/debug.log或rm（确保无进程 hold 句柄） - 检查是否有多处配置重复开启 debug（搜索整个 conf 目录：
grep -r "error_log.*debug" /etc/nginx/）
不复杂但容易忽略：debug 日志本身是诊断工具，不是运行依赖。用完即关，范围越小越好，轮转越稳越好。
