Nginx全局块5个高危参数错误：①worker_processes在容器中用auto导致进程超发；②worker_connections过高但系统限制未调优；③keepalive_timeout设0或过大且缺keepalive_requests限制；④client_max_body_size缺失致上传返回413却无提示；⑤log_format缺request_time等时延字段，无法定位慢请求瓶颈。
全局块（main context）是 Nginx 配置的顶层作用域，直接影响整个服务的稳定性、资源调度和安全基线。很多线上故障并非出在 location 或 upstream，而是全局参数设置失当——低流量时毫无征兆，高并发或异常场景下突然爆发。下面这 5 个参数错误，在生产环境中出现频率高、影响隐蔽、排查耗时长。
worker_processes 配置失当：容器里写 auto 就等于失控
在 Docker 或 Kubernetes 环境中，直接写 worker_processes auto; 是常见错误。Nginx 启动时读取的是宿主机的 CPU 核心数，而非容器实际分配的 CPU 配额。结果可能是：1 核配额的 Pod 启动了 32 个 worker 进程，引发严重争抢；或 8 核宿主机上运行多个容器，全部用 auto，导致整体超发。
- 容器环境应显式指定数值，例如 worker_processes 2;，并结合 resources.limits.cpu 调整
- 若需动态适配，可用 worker_processes $nginx_pid; 配合启动脚本计算
- 始终配合 worker_cpu_affinity auto; 提升缓存局部性（仅限 Linux）
worker_connections 过高却无配套调优：连接数≠吞吐量
盲目将 worker_connections 65535; 写死，却不调整系统级限制，会导致 accept 队列溢出、连接被丢弃。Nginx 实际能承载的并发连接数受限于：min(系统文件描述符上限, net.core.somaxconn, worker_connections × worker_processes)。
- 检查系统限制：ulimit -n 和 sysctl net.core.somaxconn
- 在 nginx.conf 中补充：events { use epoll; multi_accept on; }
- 避免单 worker 设置过高（如 > 10240），否则可能因锁竞争降低性能
keepalive_timeout 设为 0 或过大：不是越长越好
keepalive_timeout 0; 表示禁用长连接，对 HTTP/1.1 客户端极不友好；而设为 keepalive_timeout 3600; 又会大量占用 worker 连接槽位，尤其在移动端弱网环境下易堆积空闲连接。
- 推荐值：keepalive_timeout 60s 60s;（后一个为 send_timeout，防慢客户端占坑）
- 对 API 接口可进一步缩短至 15–30s；对静态资源可放宽至 120s
- 必须配合 keepalive_requests 100; 限制单连接请求数，防资源耗尽
client_max_body_size 缺失或过小：上传失败无声无息
未配置该指令时，默认值仅 1MB。用户上传 2MB 图片或 PDF 时，Nginx 直接返回 413 Request Entity Too Large，但前端常忽略该状态码，表现为“提交无响应”或“卡住”，排查时容易误判为后端超时。
- 根据业务明确设定，如：client_max_body_size 50m;（含附件的管理后台）
- 若需差异化控制，应在 server 或 location 块中覆盖，全局值作为兜底
- 注意与后端框架（如 Spring Boot 的
spring.servlet.context-path）的 body size 配置对齐
log_format 未包含关键时延字段：排障像蒙眼开车
默认 log_format combined 不记录任何时间维度，无法区分问题是出在 Nginx 自身、网络链路还是后端服务。一次慢请求，你只能看到 status 和 bytes，却不知道延迟发生在哪一环。
- 强制启用四维时延日志：log_format detail '... rt=$request_time uct=$upstream_connect_time uht=$upstream_header_time urt=$upstream_response_time';
- 搭配 access_log /path detail buffer=32k flush=5s; 减少 I/O 压力
- 通过分析字段组合快速定位瓶颈，例如 rt 高但 urt 正常 → Nginx 到客户端发送慢
