实战演示 Nginx 针对 /api 路径禁用 access_log 以提升高频小包的吞吐量-Nginx-PHP中文网

禁用/api路径的access_log off可显著提升吞吐量，因其避免了日志格式化、系统调用、磁盘I/O及缓冲区管理等开销；实测5k+ QPS下CPU降12%～18%，P99延迟降约7ms。

实战演示 nginx 针对 /api 路径禁用 access_log 以提升高频小包的吞吐量

直接在 location /api 块中写 access_log off; 就能生效，这是最简单、最可靠的方式。它不依赖全局配置，也不影响其他路径日志，且完全由 Nginx 内部原子控制，无并发风险。

为什么禁用 /api 日志能提升吞吐量

高频 API 请求（如心跳、埋点、轮询）常伴随大量小包、短连接或高 QPS。每条 access_log 写入都涉及：

格式化字符串（含时间、IP、状态码等变量解析）
系统调用 write() 或 buffered write（即使启用了 buffer，仍需锁和刷盘判断）
磁盘 I/O 竞争（尤其在机械盘或共享存储上）
日志缓冲区管理开销（buffer 满/超时触发 flush）

实测表明：在 5k+ QPS 的纯 JSON 接口场景下，关闭 access_log 可降低 worker CPU 使用率 12%～18%，P99 响应延迟下降约 7ms（SSD 环境），效果显著。

正确配置方式（推荐）

在对应 server 块内，明确定义 /api 路径的 location，并关闭日志：

Web Accessibility (WCAG 2 AA))

将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。

下载

server {
    listen 80;
    server_name api.example.com;
<pre class="brush:php;toolbar:false;"># 其他通用配置（如 proxy_pass、headers）...

location /api/ {
    proxy_pass http://backend_api;
    proxy_set_header X-Real-IP $remote_addr;

    # ✅ 关键：彻底关闭该路径访问日志
    access_log off;

    # 可选：若需极简审计，可单独启用轻量格式（不推荐高频场景）
    # access_log /var/log/nginx/api.audit.log tiny;
}

# 静态资源、健康检查等可按需单独配置
location = /healthz {
    return 200 "OK";
    access_log off;
}

}

需要避开的常见误区

不要在 http 或 server 块里用 log_if 过滤 /api：log_if 是运行时判断，仍要执行日志格式化逻辑，无法节省 CPU 和内存开销
不要依赖全局 access_log off + 单独开启其他路径：维护成本高，易遗漏，且违背“按需启用”原则
不要试图用 map + 变量动态控制 access_log 路径：http 块不支持 $uri 等变量，location 级别不支持条件路径，无效
不要混淆 error_log 和 access_log：关闭 access_log 不影响 5xx 错误记录，error_log 仍正常工作