在 nginx 中，可以通过在 `http`、`server` 或 `location` 块中分别配置 `error_log` 指令来重写不同作用域的日志级别。nginx 采用就近原则，即子作用域的配置会覆盖父作用域的设置。例如，可以在全局设置较低的记录级别以节省磁盘空间，而在特定的 `server` 或 `location` 块中提高级别以捕获更详细的调试信息。
如何在 http 和 server 块中分别设置 error_log
要实现不同作用域的重写，需要在对应的配置块中显式声明 `error_log` 指令。默认情况下，如果未在 `server` 块中指定 `error_log`，它将继承 `http` 块中的设置。通过在 `server` 块中添加新的 `error_log` 指令，可以覆盖该虚拟主机范围内的日志路径和级别。这种机制允许管理员针对不同的站点或应用模块独立调整日志详细程度。
events {
worker_connections 1024;
}
http {
# 全局错误日志，级别为 warn
error_log /var/log/nginx/error.log warn;
server {
listen 80;
server_name example.com;
# 覆盖 server 级别的日志，级别为 info
error_log /var/log/nginx/example.com.error.log info;
location / {
proxy_pass http://backend;
}
}
server {
listen 80;
server_name api.example.com;
# 覆盖 server 级别的日志，级别为 error
error_log /var/log/nginx/api.example.com.error.log error;
location / {
proxy_pass http://api_backend;
}
}
}
上述配置中，`example.com` 站点的日志将记录 `info` 级别及以上的消息，而 `api.example.com` 站点仅记录 `error` 级别及以上的消息。全局的 `warn` 级别仅作为未明确指定 `error_log` 的子块的默认值。实际运行时，Nginx 主进程会根据请求匹配的服务器块，将日志写入对应的文件，并应用该块定义的级别过滤。
如何在 location 块中进一步细化 error_log
除了 `server` 级别，`location` 块也可以独立配置 `error_log`。这在需要针对特定 URL 路径进行精细化调试时非常有用。例如，可以为一个高流量的公开页面保持默认的警告级别，而为一个内部调试接口开启 debug 级别。`location` 级别的配置优先级高于 `server` 和 `http` 级别，确保最具体的规则生效。
http {
error_log /var/log/nginx/error.log warn;
server {
listen 80;
server_name example.com;
error_log /var/log/nginx/example.com.error.log info;
location /public {
# 使用默认继承的 info 级别
root /var/www/html;
}
location /debug {
# 覆盖为 debug 级别，需编译时启用 --with-debug
error_log /var/log/nginx/debug.error.log debug;
return 200 "Debug info";
}
location /api {
# 覆盖为 error 级别，减少噪音
error_log /var/log/nginx/api.error.log error;
proxy_pass http://backend;
}
}
}
在这个示例中，访问 `/debug` 路径时，Nginx 会将相关日志写入 `/var/log/nginx/debug.error.log`，并且只记录 `debug` 级别的信息。这要求 Nginx 在编译时启用了 `--with-debug` 选项，否则 `debug` 级别不会输出任何内容。其他路径如 `/public` 和 `/api` 则分别继承 `server` 级别的 `info` 和覆盖为 `error` 级别。这种分层配置策略使得日志管理既灵活又高效，避免了全量开启 debug 日志带来的性能损耗和存储压力。
基于 error_log 指令的路径参数对日志轮转的影响
当在不同作用域重写 `error_log` 时，指定的日志文件路径决定了日志轮转（log rotation）的管理方式。每个作用域配置的独立路径都会生成独立的日志文件，这意味着系统管理员需要为每个文件配置相应的轮转策略。如果多个作用域共享同一个日志文件路径，Nginx 会将所有级别的日志追加到该文件中，此时级别过滤仅在内存中进行，磁盘上仍保留所有记录。因此，在重写日志级别时，通常建议同时指定独立的路径，以便通过 logrotate 等工具单独管理不同重要性的日志文件，防止关键错误日志被大量普通信息淹没。
