Nginx可通过location块独立配置access_log，实现按路径（如/api/、/static/、/admin/）分类记录日志；需在各location中显式声明access_log并配合log_format定制格式，同时用access_log off避免重复写入，确保目录权限正确。
在 Nginx 中，可以通过 location 块配合 access_log 指令，为不同路径（如 /api/、/static/、/admin/）单独记录访问日志，实现日志分类管理。关键在于：每个 location 可独立指定日志文件路径和日志格式，且子路径的日志配置会覆盖上级（如 server 块中全局设置）。
按路径前缀分离日志（最常用）
利用 location ^~ 或 location ~ 匹配路径前缀或正则，为不同业务区域分配独立日志文件：
-
location ^~ /api/：匹配所有以/api/开头的请求（不区分大小写，高效，无正则开销） -
location ^~ /static/：专用于静态资源，便于后续分析缓存命中率或带宽消耗 -
location ~* \.(js|css|png|jpg|gif)$：用正则匹配后缀，适合细粒度控制（注意优先级高于^~）
示例配置：
log_format api_json '{"time":"$time_iso8601","host":"$host","uri":"$uri","status":$status,"body_bytes":$body_bytes_sent,"user_agent":"$http_user_agent"}';
log_format static_short '$remote_addr - [$time_local] "$request" $status $body_bytes_sent';
<p>server {
listen 80;
server_name example.com;</p><pre class="brush:php;toolbar:false;"># 全局默认日志（兜底）
access_log /var/log/nginx/access.log main;
location ^~ /api/ {
proxy_pass http://backend_api;
access_log /var/log/nginx/api_access.log api_json;
}
location ^~ /static/ {
alias /data/www/static/;
access_log /var/log/nginx/static_access.log static_short;
}
location /admin/ {
auth_basic "Admin Area";
auth_basic_user_file /etc/nginx/.htpasswd;
access_log /var/log/nginx/admin_access.log;
}}
避免日志重复写入
Nginx 默认会将请求写入**最内层匹配的 access_log**，但若父块（如 server）也启用了日志，且子 location 未显式关闭，则请求可能被记录两次。解决方法：
Accessibility Review
下载
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
- 在需要独立日志的
location中，用access_log off;关闭继承的日志（适用于仅需特定路径记录） - 或在
server块中不设access_log，只在各location显式声明——更清晰可控 - 注意：
access_log off必须写在具体location内，不能放在http或server级别来“禁用所有”
结合日志格式提升可读性与分析效率
为不同路径定义专用 log_format，让日志内容贴合业务场景：
-
API 日志：包含响应状态、耗时（
$request_time）、请求体大小（$request_length）、用户标识（$http_x_user_id）等，适配 JSON 格式供 ELK 或 Loki 采集 -
静态资源日志：精简字段，突出
$bytes_sent和$status，方便统计流量与 404 情况 -
敏感路径（如登录、支付）：可增加
$http_referer和$http_x_forwarded_for，辅助安全审计
记得在 http 块中提前定义格式，并确保日志目录存在、Nginx 用户有写入权限（如 chown www-data:www-data /var/log/nginx/）。
验证与调试技巧
配置生效后，快速确认是否按预期分流：
- 执行
nginx -t检查语法；nginx -s reload重载配置 - 用
curl http://example.com/api/v1/users和curl http://example.com/static/logo.png分别触发请求 - 实时监控对应日志文件：
tail -f /var/log/nginx/api_access.log和tail -f /var/log/nginx/static_access.log，观察是否各自写入 - 若某路径没日志，检查
location是否被更高优先级规则拦截（如正则~ \.php$覆盖了/api/下的 PHP 路由）
