nginx 不支持直接按状态码条件写日志，但可通过 map 模块映射 $status 为标记变量（如 $log_4xx），再在 server 块中用 access_log path format if=$var 实现按状态码分离日志。
Nginx 本身不支持直接按 HTTP 状态码（如 200、404、500）自动分流写入不同日志文件——它没有内置的 if $status == 404 { access_log error404.log; } 这类条件日志指令。但可以通过配合 map 模块 + 自定义 log_format + 多 access_log 指令，在 server 或 location 级别实现「按状态码分离日志」的效果。
✅ 核心思路：用 map 预分类，再绑定不同 access_log
Nginx 的 map 指令可在 http 块中根据 $status 动态生成一个变量（比如 $log_target），然后在 access_log 中引用该变量作为日志路径的一部分。由于 Nginx 不允许 access_log 路径含未解析变量（如 $log_target），实际做法是为每类关键状态码单独声明一条 access_log 指令，并配合 if= 条件（需启用 ngx_http_map_module 和注意版本兼容性）或更稳妥的「空日志 + 过滤写入」策略。
但更稳定、广泛兼容的做法是：
为每个目标状态码组，定义独立的 log_format + 对应的 access_log，并用 map 将状态码映射到布尔标记，再用 if 判断是否记录（仅限支持 if 的上下文，如 location）；或更推荐：使用外部日志切割/分析工具事后分离。
不过，生产中最实用、零依赖、100% 兼容的方案是下面这个：
? 方法一：用 map + 多 access_log（推荐｜兼容所有主流版本）
步骤 1：在 http{} 块中定义状态码分组映射
http {
# 定义状态码分类标签（用于后续判断）
map $status $log_2xx { default ""; ~^[2] "2xx"; }
map $status $log_4xx { default ""; ~^[4] "4xx"; }
map $status $log_5xx { default ""; ~^[5] "5xx"; }
map $status $log_other { default ""; ~^[13] "13xx"; }
# 可选：定义更细粒度（如单独抓 404）
map $status $log_404 { default ""; ~^404 "404"; }
# 自定义日志格式（可复用同一格式，也可差异化）
log_format detailed '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" "$http_x_forwarded_for"';
# 全局默认访问日志（可保留，也可关闭）
access_log /var/log/nginx/access.log detailed;
}
步骤 2：在 server 或 location 中启用条件日志输出
⚠️ 注意：access_log 指令不支持直接 if= 语法，但你可以用如下技巧——
为每个类别声明一条 access_log，并利用 map 变量作文件名的一部分（Nginx 1.7.0+ 支持变量路径）：
server {
listen 80;
server_name example.com;
# ✅ 关键：Nginx 1.7.0+ 支持 access_log 路径含变量（需确保版本 ≥1.7）
access_log /var/log/nginx/status-2xx.log detailed if=$log_2xx;
access_log /var/log/nginx/status-4xx.log detailed if=$log_4xx;
access_log /var/log/nginx/status-5xx.log detailed if=$log_5xx;
access_log /var/log/nginx/status-404.log detailed if=$log_404;
# 原始全量日志可继续保留，或设为 off
# access_log off;
location / {
root /usr/share/nginx/html;
index index.html;
}
}
✅ 效果：
- 所有 2xx 响应会额外写入
/var/log/nginx/status-2xx.log - 所有 404 单独写入
/var/log/nginx/status-404.log - 其他状态码同理，互不干扰
-
if=$log_2xx表示：仅当$log_2xx非空字符串时才记录（map 已设为空字符串为 default）
? 验证方式：请求一个不存在页面（触发 404），检查
status-404.log是否新增一行；请求正常页面，看status-2xx.log是否增长。
? 方法二：用日志轮转工具事后分离（适合旧版 Nginx 或审计场景）
如果 Nginx 版本 access_log ... if= 不可用，则改用：
- 保持单个 access.log 输出完整日志（含
$status字段） - 每天用
logrotate或脚本 +awk按状态码拆分：
# 示例：从 access.log 提取全部 500 错误并追加到专用文件
awk '$9 == 500 {print}' /var/log/nginx/access.log >> /var/log/nginx/500-errors.log
# 清空原日志（或配合 logrotate 归档后处理）
搭配 cron 每分钟或每小时执行，即可近实时分离。
⚠️ 注意事项
-
if=条件日志功能需 Nginx ≥ 1.7.0，且编译时未禁用--without-http-map-module - 日志路径目录（如
/var/log/nginx/）必须提前创建并赋予 nginx worker 用户（通常是nginx或www-data）写权限 - 不建议在高并发场景下开启过多
access_log行——每条都是独立文件 I/O，可能影响性能 -
map是延迟计算的，只在日志写入前求值，开销极小
✅ 总结：三步到位
- 在
http{}块用map把$status映射成语义化标记（如$log_4xx） - 在
server{}或location{}中，为每类状态码加一行access_log path format if=$var - 重启 Nginx 并测试对应状态码请求，确认日志落点正确
这样就实现了「不同状态码进不同文件」，无需外部脚本，也无需修改应用层。
