Nginx 的 Event Loop 是每个 worker 进程内自主运行的同步主循环,基于非阻塞 I/O 与 epoll 等系统调用实现高效事件调度,无多线程、无线程切换、无锁竞争,通过就绪队列顺序执行 handler,统一管理定时器与连接生命周期。

Nginx 的 Event Loop 不是传统意义上的单线程 JS 式事件循环,而是每个 worker 进程内自主运行的同步主循环,靠非阻塞 I/O 与操作系统事件通知机制协同,实现万级连接的高效调度。
worker 进程内只有一个执行流
每个 worker 是独立的 Unix 进程,内部无多线程、无线程切换、无锁竞争。它持续运行一个 for(;;) 循环,核心动作只有三步:等待事件、搬运就绪项、顺序调用 handler。
- 调用 epoll_wait(Linux)等系统调用,批量获取当前就绪的 fd(如新连接、数据可读、写缓冲区空闲)
- 超时时间由定时器系统动态计算,兼顾响应延迟与 CPU 节能
- 返回后不直接处理业务,只把内核返回的事件“翻译”为 ngx_event_t *,填入本地就绪队列
事件注册是按需、分阶段绑定的
handler 不是一次性全局注册,而是在连接生命周期的关键节点动态挂载,确保逻辑与状态严格对应。
- 监听 socket 初始化时,注册读事件,handler 设为 ngx_event_accept,专用于 accept 新连接
- accept 成功后,在 ngx_event_accept 内部为该连接的读事件绑定 HTTP 请求解析函数(如 ngx_http_process_request_line)
- 需要发送响应时,才为写事件注册 handler(如 ngx_http_writer),并可能触发 epoll_ctl(EPOLL_CTL_MOD)
- 所有注册都通过 ngx_event_t 结构体完成:handler 存函数指针,data 存 connection 或 request 指针,回调时上下文完整
回调执行完全同步、可控、无中断
就绪队列里的事件不是并发执行,而是由主循环依次调用 ev->handler(ev),整个过程在单线程上下文中阻塞完成。
- 遍历队列时会过滤过期事件(通过 ev->instance 标志识别 stale event)
- 每个 handler 执行完毕前,worker 不会处理下一个事件;但 handler 自身可决定是否继续注册新事件(如读完 header 后注册 body 读事件)
- 定时器到期、清理任务、连接关闭等也都走同一套循环路径,共享调度节奏
超时与连接状态解耦管理
超时不是每个连接独占计时器,而是统一由 worker 自有的最小堆(或红黑树)管理,事件循环周期性扫描触发。
- 新建连接或发起 upstream 时,调用 ngx_add_timer() 将其加入本地定时器堆,只存到期时间和回调函数指针
- 收到数据或响应完成时,调用 ngx_del_timer() 主动移除,避免误触发
- keepalive_timeout 到期后,回调 ngx_http_set_keepalive —— 关闭连接、回收内存、重置连接池,全程不阻塞其他请求
- 多 worker 下无跨进程同步开销,重启时 timer heap 自动销毁,无残留风险


















