Nginx可通过map指令配合access_log条件控制实现健康检查请求不记录日志：在http块中用map定义$log_health变量匹配/health、/ping等路径并设为0，其余为1；在server或location中配置access_log third parameter为该变量，仅当值为非0时写入日志。
在 Nginx 中，可以通过 map 指令配合 log_not_found off 和 access_log 的条件控制，实现对内部健康检查请求（如 /health、/ping）不记录访问日志，同时确保其他正常请求照常记录。关键在于：用 map 提取并标记健康检查请求，再在 access_log 指令中通过变量控制是否写入日志。
定义健康检查请求的匹配规则
在 http 块中使用 map 创建一个布尔型变量（如 $log_health），当请求 URI 匹配健康检查路径时设为 0（表示不记录），其余设为 1（记录）：
示例：
http {
map $request_uri $log_health {
default 1;
~^/health$ 0;
~^/ping$ 0;
~^/api/health.* 0;
~^/readyz$ 0;
~^/livez$ 0;
}
}
注意：map 是按顺序匹配第一个满足的规则；正则以 ~ 开头（区分大小写），~* 可忽略大小写；路径建议用精确前缀或锚定正则，避免误伤。
在 server 或 location 中启用条件日志
在对应 server 或 location 块中，把 access_log 的第三个参数设为刚才定义的变量：
access_log /var/log/nginx/access.log main $log_health;- 当
$log_health为 0 时，Nginx 不写入该条日志；为非 0（如 1）时才记录 - 变量值必须是数字或空字符串；不能是字符串 "0" 或 "off"
补充建议：避免干扰 upstream 健康检查
如果健康检查由 Nginx 自身的 upstream 模块发起（如 health_check 指令），这些请求默认带有特殊头部（如 User-Agent: nginx-upstream-check），也可用 map 基于 $http_user_agent 或 $sent_http_content_type 进一步过滤：
map $http_user_agent $log_upstream_check {
default 1;
"~*nginx-upstream-check" 0;
}
然后合并逻辑（例如用 map 嵌套或组合多个变量）——但更推荐统一用 URI 规则，简洁可靠。
验证与调试技巧
启用后可快速验证是否生效：
- 发送健康检查请求：
curl -I http://your-domain/health，确认返回 200 且日志文件无新增行 - 发送普通请求：
curl -I http://your-domain/，确认日志中有对应记录 - 查看 Nginx 错误日志：
tail -f /var/log/nginx/error.log，排查map变量未定义或语法错误 - 用
nginx -t测试配置有效性，避免 reload 失败
