Nginx 用 map 指令动态控制 access_log，按条件触发日志写入而非全量记录；通过多层 map 匹配路径、UA、状态码等，构建布尔开关变量，最终以整数 0/1 控制是否落盘，支持热更新且无性能损耗。
用 map 指令动态控制 access_log，核心是让日志写入变成“按条件触发”，而不是全量记录。它不依赖外部工具或重启，直接在请求处理阶段就决定是否落盘，对反向代理场景（如 API 网关、静态资源分发）降低磁盘 I/O 和存储压力效果显著。
明确采样目标：哪些请求值得记？
反代流量中大量请求其实价值很低：健康检查探针、爬虫 UA、静态资源 404、内部监控心跳等。先识别这些低价值流量，再用 map 构建布尔标记：
- 匹配
/healthz或/ping路径，设为0 - 检测
$http_user_agent包含curl、Go-http-client或常见爬虫关键词，设为0 - 对
$status为404且 URI 是图片/JS/CSS 的请求，统一过滤 - 保留
5xx错误、登录/支付等关键路径，强制设为1（保底记录）
用 map 构建可复用的开关变量
map 必须定义在 http 块内，且只在被引用时计算，无性能损耗。一个典型配置如下：
map $request_uri $log_flag {
~^/healthz 0;
~^/ping 0;
~*\.(js|css|png|jpg|gif)$ 0;
default 1;
}
<p>map $http_user_agent $ua_flag {
~<em>(curl|Go-http-client|HeadlessChrome) 0;
~</em>Baiduspider 0;
default 1;
}</p><p>map $status $err_flag {
~^5 1; # 所有 5xx 强制记录
default 0;
}</p><h1>最终开关：任一保底条件满足即记录</h1><p>map $log_flag $final_log {
0 0;
1 $ua_flag; # 只有 log_flag=1 时才看 ua_flag
}</p><p>map $final_log $write_log {
0 0;
1 $err_flag; # err_flag=1 则最终为 1，否则沿用 final_log
}</p>
注意：access_log 的 if= 参数只接受整数 0 或 1，所以最终变量必须是纯数字类型。
Web Accessibility (WCAG 2 AA))
下载
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
搭配缓冲与分级日志提升实效性
光过滤还不够，写入方式也影响磁盘压力：
- 主日志保持默认格式，但加
buffer=64k flush=5s，减少小写入频次 - 采样日志单独输出，比如只记录
$remote_addr $request $status $request_time，体积更小 - 错误日志（
error_log）级别调至warn或error，避免info级别刷屏 - 禁用
log_not_found on，尤其反代静态服务时，大量 404 会快速填满磁盘
验证与热更新不中断业务
修改后无需 reload 全局配置，map 规则本身支持热生效。验证是否生效，可临时加一条测试规则：
map $remote_addr $test_log {
"127.0.0.1" 1;
default 0;
}
access_log /var/log/nginx/test.log main if=$test_log;
用 curl -H "Host: example.com" http://127.0.0.1 触发，观察日志是否写入。确认逻辑正确后再替换为生产规则。所有 map 变量都可在 log_format 中直接使用，便于后续做字段级采样分析。
