启用 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 功能

示例命令：

./configure --with-debug --prefix=/usr/local/nginx --error-log-path=logs/error.log

编译安装并验证模块是否生效

执行标准编译流程：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 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