multi_accept 控制Nginx worker单次事件循环中accept调用次数:on时持续调用直至EAGAIN,off时仅调用一次;它不改变内核somaxconn,仅影响已就绪连接的批量获取效率。

multi_accept 的作用不是“单次最大化接收新连接”,而是控制一个事件循环中是否尽可能多地接受已就绪的连接。它的效果高度依赖底层系统行为和配置协同,并非独立调优项。
multi_accept 的真实行为
当 Nginx worker 进入一次事件循环(例如 epoll_wait 返回后),若 multi_accept on,它会持续调用 accept() 直到返回 EAGAIN(即内核已完成队列为空);若为 off,则只调用一次 accept() 就退出该轮处理。
这意味着:
• 它不改变内核 TCP 完成队列(net.core.somaxconn)大小
• 不影响新连接到达时能否被入队
• 仅影响 worker 在一次 epoll 事件触发后“取走多少个已就绪连接”
真正决定“单次能收多少连接”的关键参数
要让单个 worker 在一次事件循环中接收更多连接,需同时满足以下条件:
-
增大内核完成队列长度:通过
net.core.somaxconn(如设为 65535)和 Nginx 的listen ... backlog=65535,确保连接不会因队列满而丢弃 - 启用 multi_accept on:配合高 backlog,才能在一次事件中批量 accept
-
避免 accept 锁争用:设置
accept_mutex off(仅在 Linux 3.9+ + EPOLL 且无惊群问题时安全),允许多个 worker 并发 accept;但若只关注“单个 worker 单次吞吐”,此选项非必需 - 使用边缘触发(ET)模式:Nginx 默认在 epoll 下使用 ET,这天然鼓励一次性处理完就绪连接;无需手动配置,但需确认未被覆盖
典型高效配置示例
在 nginx.conf 的 events 块中:
use epoll;
worker_connections 10240;
multi_accept on;
accept_mutex off; # 仅当内核 ≥3.9 且确认无惊群风险时启用
}
并在 server 或 upstream 的 listen 指令中显式声明 backlog:
listen 80 backlog=65535;验证是否生效
可通过以下方式观察效果:
• 使用 ss -lnt 查看 Recv-Q 是否长期接近 backlog 值(说明队列有积压,multi_accept 有机会批量取)
• 配合 perf 或 eBPF 工具(如 bpftrace -e 'kprobe:sys_accept { @ = count(); }')统计单位时间内 accept 系统调用频次,开启 multi_accept 后单次事件循环内的调用次数应明显上升
• 对比 nginx -T 输出确认配置已加载











