可通过Nginx的map指令配合access_log off实现精准日志过滤，即定义$log_flag变量为0时（IP在黑名单或请求为健康检查路径）不记录日志，仅当其为1时才写入access.log，从而从源头减少日志体积和I/O压力。
可以通过 Nginx 的 map 指令配合 access_log off 实现精准日志过滤，既不记录特定 IP，也不记录健康检查请求，从源头减少日志体积和 I/O 压力。
用 map 定义不记录的条件
在 http 块中定义一个变量，标识哪些请求不应写入 access log：
map $remote_addr $loggable {
default 1;
192.168.1.100 0; # 屏蔽单个运维 IP
10.0.0.0/8 0; # 屏蔽整个内网段
127.0.0.1 0;
}
map $request_uri $health_check {
~^/health$ 0;
~^/ping$ 0;
~^/actuator/health 0;
default 1;
}
map $loggable $health_check $log_flag {
0 0 0;
0 1 0;
1 0 0;
1 1 1;
}
上面三重映射确保：只要 IP 在黑名单中 或 请求路径匹配健康检查，$log_flag 就为 0，表示不记录。
在 server 或 location 中关闭日志输出
在对应 server 或 location 块中使用 access_log off 配合变量判断：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/access.log main if=$log_flag;
location / {
proxy_pass http://backend;
}}
if=$log_flag 表示仅当 $log_flag 为 1 时才写日志。这是最轻量、最推荐的方式，无需 rewrite 或 return 干扰业务流程。
补充建议：避免常见陷阱
- 不要用 if + return 444 来“拦截”健康检查再记日志 —— 这样仍会触发日志（除非额外加 if），且可能干扰监控探活逻辑；
- 不要在 location 中重复定义 map —— map 必须在 http 块顶层定义，否则报错；
-
正则匹配注意大小写：Nginx 默认区分大小写，如需忽略，用
~*替代~； - 测试配置前先 nginx -t，尤其 map 多层嵌套容易漏 default 或写错分号。
验证是否生效
发送测试请求并观察日志变化：
curl -I http://localhost/health curl -I http://localhost/ tail -f /var/log/nginx/access.log
正常情况下，第一行不会出现在日志里，第二行会记录。也可用 awk '{print $1,$7}' /var/log/nginx/access.log | head 快速核对 IP 和 URI 是否已过滤。
不复杂但容易忽略的是：map 变量的求值发生在日志写入前，且只依赖请求阶段已知字段（如 $remote_addr、$request_uri），因此稳定可靠，适合生产环境长期使用。
