Nginx 基础配置中如何利用 location 排除特定文件日志

Nginx中排除特定文件日志记录的核心是location块配合access_log off指令，精准匹配路径或扩展名并关闭日志，需确保其定义在通用location之前以避免被覆盖。

在 Nginx 基础配置中，排除特定文件的日志记录，核心是利用 location 块配合 access_log off 指令，让匹配到的请求不写入 access 日志。这不是禁止访问，而是静默处理——请求仍可正常响应，但不留下访问痕迹。

用 location 匹配并关闭日志

对静态资源（如图标、健康检查探针、监控埋点等）频繁请求会造成日志膨胀，影响分析效率。推荐做法是：在 server 块内添加独立的 location，精准匹配目标路径或扩展名，并显式关闭日志：

1. 匹配常见静态资源扩展名（不区分大小写）：

   location ~* .(ico|gif|jpg|png|css|js|woff2?|ttf|eot|svg)$ {

   access_log off;

   }

2. 匹配特定健康检查路径：

   location = /healthz {

   access_log off;

   return 200 'OK';

   }

3. 匹配所有 robots.txt 和 favicon.ico（精确或前缀）：

   location = /robots.txt { access_log off; }

   location = /favicon.ico { access_log off; }

注意 location 优先级和位置

access_log 是 location 级指令，生效依赖匹配顺序。必须确保这些“关日志”的 location 在通用日志规则（如 location / { ... }）之前定义，否则会被覆盖。Nginx 匹配规则优先级为：

精确匹配（=） > 前缀匹配（^~） > 正则匹配（~ / ~*，按配置顺序） > 通用匹配（/）。

1. 把 access_log off 的 location 放在 server 块靠前位置，尤其是放在 location / 之前
2. 避免用 location ~ .js$ 这类宽泛正则去关日志，若后续还有更具体的正则（如 location ~ ^/admin/.*.js$），可能因顺序问题失效
3. 不建议在 location / 内用 if 判断关日志——if 在 location 中受限且易出错

补充：全局日志过滤的替代方案

如果需更细粒度控制（例如仅对某类 User-Agent 或状态码跳过记录），可用 map 指令构造日志开关变量：

1. 在 http 块顶部定义：

   map $request_uri $loggable {

   default 1;

   ~*/healthz 0;

   ~*.(ico|gif)$ 0;

   }

2. 在 server 或 location 中引用：

   access_log /var/log/nginx/access.log main if=$loggable;

3. 该方式灵活，但 map 需定义在 http 级，且变量只在 access_log 的 if 参数中有效

关键不是“删日志”，而是从源头控制哪些不该记。location + access_log off 是最直接、低开销、也最可控的方式。