nginx可通过map指令配合access_log的if参数实现条件日志记录；先用map定义逻辑变量（如排除健康检查、404响应等），再在access_log中指定if=$变量名，仅当变量值非空且非0时写入日志。
Nginx 本身不支持在 log_format 或 access_log 指令中直接使用 if 来动态开关日志记录，但可以通过巧妙利用 map 指令配合 access_log 的条件参数，实现“选择性记日志”——即只对满足特定条件的请求写入访问日志。
用 map 构建日志开关变量
map 是 Nginx 中用于条件映射的高效模块，它在请求处理早期就完成变量计算，且支持嵌套逻辑，是替代 if 实现条件判断的推荐方式。例如，想只记录非健康检查（如非 /health）且状态码不是 404 的请求：
map $request_uri $loggable {
default 1;
~^/health 0;
}
map $status $loggable_by_status {
~^[4]04 0;
default $loggable; # 继承上一步结果
}
这里定义了两个层级的判断：先排除健康检查路径，再排除 404 响应。最终 $loggable_by_status 为 1 时才记日志。
在 access_log 中启用条件记录
Nginx 1.7.0+ 支持给 access_log 指令附加一个“条件变量”，只有该变量非空且非 0（字符串或数字）时，才写入该条日志：
- 在
http或server块中配置：access_log /var/log/nginx/access.log main if=$loggable_by_status; - 注意：
if=后面必须是变量名，不能带$，也不能是表达式 - 多个
access_log行可共存，例如同时保留全量日志和筛选后日志
常见实用场景与写法示例
以下是一些高频需求的 map 写法，可直接复用或组合：
-
仅记录 POST 请求：
map $request_method $log_post { POST 1; default 0; } -
排除爬虫 UA：
map $http_user_agent $log_human { "~*curl|wget|monitor" 0; default 1; } -
按响应时间阈值记录慢请求：
map $request_time $log_slow { "~^[1-9][0-9]*\.[0-9]+" 1; default 0; }（记录耗时 ≥1s 的请求） -
结合 IP 白名单：
map $remote_addr $log_internal { 192.168.1.0/24 1; default 0; }
注意事项与避坑提示
直接在 location 中用 if + access_log 是无效的，因为 access_log 不支持在 if 块内重定义；而 map 必须定义在 http 块顶层，不能嵌套在 server 内（除非用 include 分离）；另外，map 中的正则匹配性能良好，但避免过度复杂模式。
本质上，这是用声明式变量代替命令式判断，既安全又高效。只要理清条件逻辑、拆解成独立 map 步骤，就能精准控制哪些请求进日志文件。
