Nginx可通过map+log_format+access_log的if条件组合实现仅记录4xx/5xx错误请求：在http块定义$loggable映射变量匹配4/5开头状态码，配置error_only日志格式，server中用access_log path format if=$loggable启用条件记录。

在 Nginx 中，access_log 本身不支持直接的“条件记录”（比如只记录 4xx/5xx），但可以通过 map 指令 + log_format + access_log 的条件开关 组合实现“仅记录错误请求”的效果——本质是将非错误请求的日志路径设为 off，让其不写入任何 access 日志文件。

1. 定义错误状态码的映射变量

在 http 块中使用 map 创建一个变量（如 $loggable），根据响应状态码决定是否记录：

http {
    map $status $loggable {
        ~^[45]  1;   # 匹配以 4 或 5 开头的状态码（400–499, 500–599）
        default 0;
    }
}

说明：
• ~^[45] 是正则匹配，比逐个写 400 1; 401 1; ... 更简洁可靠；
• default 0 表示其他状态（如 200、301、304）不记录；
• 变量名（$loggable）需唯一，避免与已有变量冲突。

2. 自定义日志格式（可选但推荐）

为便于识别错误上下文，建议定义精简清晰的错误专用日志格式：

Web Accessibility (WCAG 2 AA))

将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。

下载

log_format error_only '$remote_addr - $remote_user [$time_local] '
                      '"$request" $status $body_bytes_sent '
                      '"$http_referer" "$http_user_agent" '
                      'rt=$request_time uct="$upstream_connect_time" '
                      'uht="$upstream_header_time" urt="$upstream_response_time"';

说明：
• 保留关键字段：客户端 IP、时间、请求行、状态码、响应体大小、Referer、UA；
• 加入性能相关变量（如 $request_time, $upstream_response_time），方便排查慢请求或上游异常。

3. 在 server 或 location 中启用条件 access_log

在对应作用域（如 server 块）中，用 access_log 的第三个参数指定“开启条件”：

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/error_only.log error_only if=$loggable;

# 其他配置...

}

说明：
• if=$loggable 表示仅当 $loggable 值为非空且非 0（即为 1）时才写日志；
• 日志文件路径可独立命名（如 error_only.log），避免和常规 access 日志混用；
• 注意：该 if 是 access_log 指令的内置开关，不是 rewrite 模块的 if，语法安全。

4. 验证与注意事项

• 重启 Nginx 后，发送测试请求：
  – curl -I http://example.com/404 → 应出现在日志中；
  – curl -I http://example.com/（返回 200）→ 不应出现。

• 关键限制：
  – if= 条件仅支持变量值为 0/""（不记录）或非零/非空（记录），不支持复杂表达式；
  – map 必须定义在 http 块，不能放在 server 内；
  – 状态码变量 $status 是响应发出后才确定的，因此该方案准确反映实际返回状态。

不复杂但容易忽略：map 变量必须在 http 级定义，且 if= 后面只能跟变量名，不能跟表达式。