ngx_event_no_timers_left

1 定义

ngx_event_no_timers_left 函数 定义在 ./nginx-1.24.0/src/event/ngx_event_timer.c

ngx_int_tngx_event_no_timers_left(void){ngx_event_t*ev;ngx_rbtree_node_t*node,*root,*sentinel;sentinel=ngx_event_timer_rbtree.sentinel;root=ngx_event_timer_rbtree.root;if(root==sentinel){returnNGX_OK;}for(node=ngx_rbtree_min(root,sentinel);node;node=ngx_rbtree_next(&ngx_event_timer_rbtree,node)){ev=ngx_rbtree_data(node,ngx_event_t,timer);if(!ev->cancelable){returnNGX_AGAIN;}}/* only cancelable timers left */returnNGX_OK;}

ngx_event_no_timers_left 函数的作用是 检查全局定时器红黑树中是否还剩下不可取消的定时器。 如果树为空或所有定时器都是可取消的，返回 `NGX_OK`； 只要存在任何一个不可取消的定时器，就返回 `NGX_AGAIN`。 该函数主要用于 worker 进程优雅退出等场景，确保关键超时事件不会被遗漏。

2 详解

1 函数签名

ngx_int_tngx_event_no_timers_left(void)

返回值 NGX_OK → 条件满足，可以继续（没有不可取消的定时器）。 NGX_AGAIN → 条件不满足，需要等待或重试（仍有不可取消的定时器）。

参数 void 该函数不接受任何参数，因为它直接操作全局唯一的定时器红黑树

2 逻辑流程

1 局部变量 2 检查红黑树是否为空 3 遍历红黑树 4 返回 NGX_OK

1 局部变量

{ngx_event_t*ev;ngx_rbtree_node_t*node,*root,*sentinel;sentinel=ngx_event_timer_rbtree.sentinel;root=ngx_event_timer_rbtree.root;

从全局定时器红黑树结构 ngx_event_timer_rbtree 中取出哨兵节点指针， 赋值给局部变量 sentinel。 获取定时器红黑树的根节点指针，存入 root

2 检查红黑树是否为空

if(root==sentinel){returnNGX_OK;}

检查根节点是否等于哨兵节点， 即判断定时器红黑树是否为空 若树为空，立即返回 NGX_OK

3 遍历红黑树

for(node=ngx_rbtree_min(root,sentinel);node;node=ngx_rbtree_next(&ngx_event_timer_rbtree,node)){ev=ngx_rbtree_data(node,ngx_event_t,timer);if(!ev->cancelable){returnNGX_AGAIN;}}

#1 初始化 for 循环，设置游标 node 为红黑树的最小节点 ngx_rbtree_min(root, sentinel) 返回以 root 为根的子树中键值最小的节点（不考虑哨兵）。 在定时器红黑树中，节点的键是超时时间戳（ngx_msec_t），因此最小节点对应最早超时的事件。 遍历从这里开始，完全符合时间顺序。 ngx_rbtree_next 是 Nginx 提供的红黑树辅助函数， 它接收整棵树和当前节点，返回按时间戳升序的下一个定时器节点。y 使用这个函数能按时间顺序依次检查每个定时器， 保证如果存在不可取消的事件，一定是按它们超时的先后顺序被检查到。

#2 通过红黑树节点 node，反推出包含该节点的 ngx_event_t 结构体的地址

#3 检查当前定时器事件的 cancelable 字段是否为 0 ev->cancelable 是 Nginx 事件系统为定时器引入的一个标志位（unsigned cancelable:1;）。 如果值为 1，表示该定时器是可取消的（例如客户端连接空闲超时关闭），在 worker 退出时可以安全丢弃； 如果值为 0，表示该定时器不可取消，必须等待其触发并执行回调 条件 !ev->cancelable 为真时， 意味着找到至少一个不可取消的定时器 立即返回 NGX_AGAIN，向调用者表明“仍有不可取消的定时器存在”

4 返回 NGX_OK

/* only cancelable timers left */returnNGX_OK;}

返回 NGX_OK，表示“没有不可取消的定时器剩余”