静态资源日志应按需分流或关闭：高频低价值请求（如.js、.css、图片）宜禁用主日志，可用location匹配后缀+access_log off；需分析时可单独记录并精简格式；复杂路径推荐map变量控制；robots.txt等干扰请求应显式关闭日志。
静态资源访问日志不需要全量记录，核心是按需分流或关闭：高频但低业务价值的请求（如 .js、.css、图片）应避免写入主日志，既节省磁盘又提升分析效率。
直接关闭静态资源日志
最轻量的做法是在 location 块中匹配常见后缀，用 access_log off 彻底跳过记录：
- 在 server 或 http 块中添加如下配置：
location ~* \.(jpg|jpeg|png|gif|ico|css|js|woff|woff2|ttf|eot|svg|pdf)$ {
expires 1y;
add_header Cache-Control "public, immutable";
access_log off;
}
- ~* 表示大小写不敏感，能覆盖 JPG、PNG 等变体
- 不能在 if 块里写 access_log off —— Nginx 不支持该语法
- 此方式适用于纯托管静态文件、无需归档分析的场景
为静态资源单独记录日志
若需保留日志用于 CDN 回源分析、缓存命中率统计或故障回溯，建议分离存储并精简格式：
- 先在 http 块定义专用格式，例如：
log_format static '$time_local|$remote_addr|$request|$status|$body_bytes_sent|$http_referer|$request_time';
- 再在对应 location 中启用：
location ~* \.(js|css|png|jpg|woff2?)$ {
access_log /var/log/nginx/static_access.log static;
log_not_found off;
}
- log_not_found off 可防止 404 静态请求刷屏日志
- 竖线分隔便于后续用 awk 或脚本解析
- 独立路径方便配合 logrotate 按日轮转、压缩归档
用 map 实现更灵活的控制
当静态资源路径不规则（如带版本号的 /assets/v2.1.0/main.js）或需结合 URI 路径、查询参数判断时，map 更可靠：
- 在 http 块中定义映射变量：
map $uri $log_static {
~*\.(js|css|png|jpg|gif|woff2?)$ 0;
~*/static/ 0;
~*/api/ 1;
default 1;
}
- 然后在 server 块中按变量值开关日志：
access_log /var/log/nginx/access.log main if=$log_static;
- 这样只有 $log_static 为 1 的请求才记入主日志
- 比单纯后缀匹配更适应复杂路由结构
补充建议：排除干扰请求
有些请求虽带静态后缀，但不属于真实资源访问，应主动跳过：
- robots.txt、favicon.ico、健康检查路径（如 /healthz）可单独配置 access_log off
- 示例：
location = /robots.txt { access_log off; log_not_found off; return 200 "User-agent: *\nDisallow: /\n"; } - 避免这些高频低信息量请求污染日志或干扰统计
