启用 Nginx 调试日志需编译时加 --with-debug 选项，并在配置中设置 error_log ... debug；仅编译启用不够，还需配置生效、重载服务，且不可在生产环境全局使用。
在 Nginx 源码编译时开启调试日志（debug log），核心是启用 --with-debug 编译选项，并确保运行时配置正确。默认情况下，Nginx 不包含调试日志功能，必须显式编译进模块。
编译时启用调试支持
进入 Nginx 源码目录后，在执行 ./configure 时添加：
-
--with-debug：这是最关键的选项，它会定义NGX_DEBUG宏，使日志级别debug可用，并启用相关调试代码路径 - 可选但推荐：
--error-log-path=logs/error.log明确指定错误日志位置，方便后续验证 debug 日志是否生效 - 其他常用选项（如
--prefix、--user等）按需保留，不影响 debug 功能
示例命令：
编译安装并验证模块是否生效
执行标准编译流程：
make && make install- 安装完成后，检查二进制文件是否链接了调试符号（非必需，但有助于调试）：
file /usr/local/nginx/sbin/nginx—— 若含not stripped，说明符号未被剥离，gdb 调试更友好 - 运行
/usr/local/nginx/sbin/nginx -V 2>&1 | grep -o with-debug，输出with-debug即表示编译成功启用了调试支持
Nginx 配置中启用 debug 日志级别
仅编译开启还不够，还需在配置中将日志级别设为 debug：
- 在
nginx.conf的main或http块中设置：
error_log logs/error.log debug; - 注意：
debug级别日志量极大，**切勿在生产环境全局启用**；可限定作用域，例如：
location /api/ { error_log logs/api_debug.log debug; } - 若使用
systemd管理，确保启动用户有写入日志目录的权限，否则 debug 日志可能无法落盘
常见问题与提示
开启后仍看不到 debug 日志？检查以下几点：
- 确认 Nginx 是你刚编译安装的版本（
nginx -V），而非系统包管理器安装的预编译版（通常不含 debug） -
error_log指令必须放在能生效的作用域（如http、server、location），且不能被更低优先级的同名指令覆盖 - 首次启用 debug 后需重载或重启：
nginx -s reload或nginx -s stop && nginx - 部分调试信息（如 event 模块细节）还需配合环境变量：
NGX_DEBUG_CONNECTION=1或NGX_DEBUG_EVENT=1，再启动 Nginx
