Nginx 用 map 指令实现原生日志降载：按路径过滤静态资源、分层采样、保底记录异常与关键行为，并结合 time_iso8601 实现自动按天轮转，所有 map 必须置于 http 块内且 if= 后值须为整数 0 或 1。
用 map 指令控制 access_log 是否写入，是 Nginx 原生、零依赖的日志降载方案。它不靠外部脚本或定时清理，在请求进入阶段就决定“这条要不要记”，从源头减少磁盘 I/O 和文件增长，特别适合静态资源服务（如图片、JS、CSS）这类高 QPS、低业务价值的流量。
按路径过滤低价值静态请求
静态资源访问量大但调试价值低，可直接跳过记录。例如忽略所有 .js、.css、.png 等后缀请求：
- 在
http块中定义映射：
map $request_uri $log_static {
~*\.(js|css|png|jpg|gif|woff2|svg|ico)$ 0;
default 1;
}
- 在
server或location中启用条件日志：
access_log /var/log/nginx/access.log main if=$log_static;
这样，所有静态资源请求都不会写入主日志，而 HTML、API 等关键路径仍全量保留。
分层采样：高频静态资源按比例记录
若需保留部分静态请求用于容量分析，可用哈希逻辑实现稳定抽样。比如对图片请求固定采样 2%：
- 基于客户端 IP 做 CRC32 哈希再取模，确保同一用户行为可复现：
map $remote_addr $sample_img {
~^(?<ip>\d+\.\d+\.\d+\.\d+)$ $ip;
default "";
}
map $sample_img $log_img {
~^$ 0; # 空值不记录
~^(?<hash>[0-9a-fA-F]{8})$ $hash;
default "";
}
map $log_img $log_flag {
~^[0-1]$ 1; # 哈希前两位为 00–19 → 约 2%
default 0;
}</hash></ip>
- 搭配
access_log ... if=$log_flag即可生效
保底记录异常与关键行为
即使做了降采样，5xx 错误、404 频次突增、或特定 UA（如监控探针）仍需全量捕获，避免掩盖问题：
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
- 组合多个条件生成最终开关变量：
map $status $error_flag {
~^[5] 1;
~^[4] 0;
default 0;
}
map $request_uri $health_flag {
~^/healthz 1;
default 0;
}
map $error_flag $log_final {
1 1; # 5xx 强制记录
default $log_flag; # 其他走采样逻辑
}
map $health_flag $log_final {
1 1; # 健康检查强制记录
}
注意：多个 map 同名变量会按定义顺序覆盖，最后定义的生效；也可用 if + set 辅助，但 map 更轻量、更安全。
配合按天分割避免单文件膨胀
即使采样后日志量下降，长期运行仍可能产生大文件。利用 time_iso8601 提取日期，让日志自动按天轮转：
- 定义日期变量：
map $time_iso8601 $logdate {
~^(?<ymd>\d{4}-\d{2}-\d{2}) $ymd;
default "unknown";
}</ymd>
- 日志路径中嵌入变量：
access_log /var/log/nginx/access-$logdate.log main if=$log_final;
无需 logrotate 或重启 Nginx，每天零点起新文件自动生效，也方便后续按日期归档或清理。
不复杂但容易忽略：所有 map 必须放在 http 块内，且 if= 后的变量值只能是整数 0 或 1；布尔值写成字符串（如 "0"）会导致失效。
