禁用/api路径的access_log off可显著提升吞吐量，因其避免了日志格式化、系统调用、磁盘I/O及缓冲区管理等开销；实测5k+ QPS下CPU降12%～18%，P99延迟降约7ms。
直接在 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 环境），效果显著。
Web Accessibility (WCAG 2 AA))
下载
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
正确配置方式（推荐）
在对应 server 块内，明确定义 /api 路径的 location，并关闭日志：
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 仍正常工作
替代方案：需要日志又想减负？
如果业务强依赖 /api 的基础统计（如 QPS、状态码分布），但不想写磁盘，可用零日志开销方案：
- 启用
stub_status模块暴露实时指标，配合 Prometheus 抓取 - 用 OpenResty + lua-resty-metrics 在内存中聚合计数，定时上报
- 后端服务自身打结构化日志，Nginx 层专注转发与防护
