必须先验证nginx -V含--with-debug，再在main上下文配置error_log /var/log/nginx/error.log debug；日志量极大，仅限临时精准诊断，需确保路径权限且不可用syslog或stderr。
要在 Nginx 中开启 debug 级别错误日志用于排查疑难问题，核心是两步：编译时启用 debug 日志支持（若未预编译）、运行时配置正确的日志级别和输出目标。很多发行版的预装 Nginx 默认不带 --with-debug，直接改配置会无效。
确认 Nginx 是否支持 debug 日志
执行以下命令检查 debug 支持是否已编译进当前 Nginx：
nginx -V 2>&1 | grep -o with-debug
若无输出，说明不支持 —— 需要重新编译或换用含 debug 的包（如 Ubuntu 的 nginx-full 或 CentOS 的 nginx-debug 包）。
常见解决方式：
- Ubuntu/Debian：安装
nginx-full（它默认含 debug 模块），而非nginx-light - CentOS/RHEL：启用 EPEL 源后安装
nginx-debug或手动编译（加--with-debug） - Docker 用户：优先选用官方
nginx:alpine或nginx:mainline镜像，它们通常支持 debug
配置 error_log 开启 debug 级别
在 nginx.conf 的全局块（main 上下文）中设置，不能放在 server 或 location 块内：
error_log /var/log/nginx/error.log debug;
注意要点：
- debug 日志量极大，仅临时开启，排查完务必降级为
error或warn - 日志路径需确保 Nginx worker 进程有写权限（通常是
www-data或nginx用户） - 若使用
syslog或stderr，debug 不生效 —— 必须指向具体文件路径
重启并验证 debug 日志是否生效
执行以下操作确认日志已进入 debug 模式：
- 先测试配置：
nginx -t - 重载服务：
nginx -s reload（避免中断连接） - 触发一个请求（比如访问任意 URL），然后实时观察日志：
tail -f /var/log/nginx/error.log
看到类似 http header: "Host: example.com"、rewrite phase: 0、access phase: 2 等详细处理阶段输出，即表示 debug 已生效。
高效定位问题的小技巧
debug 日志信息密集，建议配合过滤使用：
- 按模块过滤：如只看重写相关
grep 'rewrite\|http_rewrite' /var/log/nginx/error.log - 按客户端 IP 追踪：
grep '192.168.1.100' /var/log/nginx/error.log - 结合
strace查系统调用（如怀疑文件权限或 upstream 连接阻塞） - 临时加
echo指令（需ngx_http_echo_module）辅助验证请求流转
