计算机网络 / 系统课时
写事件什么时候需要注册
写事件什么时候需要注册
非阻塞 socket 通常大部分时间都处于“可写”状态,因此把 EPOLLOUT 长期挂在兴趣列表上,默认水平触发模式下会让事件循环反复被唤醒。本节用“先写、写不动再订阅、写完立即取消”的模式处理发送缓冲区、部分写入和待发送队列。
学习目标
- 判断什么时候应该注册或取消
EPOLLOUT - 正确处理
send()的部分写入与EAGAIN - 避免可写事件长期就绪造成事件循环空转
为什么不能一直监听 EPOLLOUT
EPOLLOUT 的含义不是“现在可以一次写完所有数据”,而是当前写入通常不会立刻阻塞。对已建立的 TCP 连接,只要发送缓冲区还有空间,它往往长期成立。默认的水平触发模式下,如果业务没有待发送数据却仍监听 EPOLLOUT,epoll_wait() 会不断返回这个 fd,线程就会在无事可做时消耗 CPU。
边沿触发模式不会以同样方式持续重复通知,但长期订阅仍会扩大无效事件集合,并让“是否真的有待发送数据”与事件兴趣状态脱节。工程上仍应把 EPOLLOUT 当成发送受阻后的临时通知。

正确的注册时机
事件循环可以按下面的顺序处理一次业务发送:
- 有新数据时先直接调用非阻塞
send(),不要先注册EPOLLOUT。 - 如果返回正数,只移动已发送偏移;返回值小于待发送长度时,剩余部分继续保留。
- 如果返回
EAGAIN或EWOULDBLOCK,说明此刻发送缓冲区暂时没有足够空间。只有在发送队列仍非空时才把EPOLLOUT加入该 fd 的事件掩码。 - 收到
EPOLLOUT后再次发送,并持续处理部分写入,直到队列清空或再次遇到EAGAIN。 - 队列一旦清空,立即通过
EPOLL_CTL_MOD移除EPOLLOUT。
用程序观察开关过程
下面的 Linux 示例用 socketpair() 构造一对非阻塞流式 socket,先把发送端写到 EAGAIN,再模拟对端消费数据。脚本会编译并运行示例,可以直接看到 EPOLLOUT 从启用到取消的过程。
cat > epoll_out_demo.c <<'EOF'
#define _GNU_SOURCE
#include <sys/epoll.h>
#include <sys/socket.h>
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
static void die(const char *msg) {
perror(msg);
exit(EXIT_FAILURE);
}
static void mod_events(int epfd, int fd, uint32_t events) {
struct epoll_event ev = {.events = events, .data.fd = fd};
if (epoll_ctl(epfd, EPOLL_CTL_MOD, fd, &ev) == -1) die("epoll_ctl MOD");
}
int main(void) {
int sv[2];
if (socketpair(AF_UNIX, SOCK_STREAM | SOCK_NONBLOCK, 0, sv) == -1) die("socketpair");
int sndbuf = 4096;
if (setsockopt(sv[0], SOL_SOCKET, SO_SNDBUF, &sndbuf, sizeof(sndbuf)) == -1) die("setsockopt");
int epfd = epoll_create1(EPOLL_CLOEXEC);
if (epfd == -1) die("epoll_create1");
// 初始没有待发送数据,只订阅读事件。
struct epoll_event ev = {.events = EPOLLIN, .data.fd = sv[0]};
if (epoll_ctl(epfd, EPOLL_CTL_ADD, sv[0], &ev) == -1) die("epoll_ctl ADD");
char out[16384];
memset(out, 'x', sizeof(out));
size_t sent = 0;
const size_t target = 1024 * 1024;
int out_enabled = 0;
int out_seen = 0;
while (sent < target) {
size_t left = target - sent;
size_t chunk = left < sizeof(out) ? left : sizeof(out);
// 先乐观写;部分写入只推进已完成的偏移。
ssize_t n = send(sv[0], out, chunk, MSG_NOSIGNAL);
if (n > 0) {
sent += (size_t)n;
continue;
}
if (n == -1 && (errno == EAGAIN || errno == EWOULDBLOCK)) {
// 只有写到 EAGAIN 且仍有积压时才临时订阅 EPOLLOUT。
if (!out_enabled) {
mod_events(epfd, sv[0], EPOLLIN | EPOLLOUT);
out_enabled = 1;
puts("send blocked: enable EPOLLOUT");
}
// 模拟对端消费数据,为发送缓冲区重新腾出空间。
char drain[32768];
ssize_t r;
do {
r = recv(sv[1], drain, sizeof(drain), 0);
} while (r > 0);
if (r == -1 && errno != EAGAIN && errno != EWOULDBLOCK) die("recv");
struct epoll_event ready;
int nr = epoll_wait(epfd, &ready, 1, 1000);
if (nr == -1) die("epoll_wait");
if (nr == 0) {
fputs("timeout\n", stderr);
return EXIT_FAILURE;
}
if ((ready.events & EPOLLOUT) && !out_seen) {
puts("EPOLLOUT ready");
out_seen = 1;
}
continue;
}
die("send");
}
// 待发送队列清空后立即取消写兴趣,避免长期可写造成空转。
if (out_enabled) mod_events(epfd, sv[0], EPOLLIN);
puts("queue empty: disable EPOLLOUT");
close(epfd);
close(sv[0]);
close(sv[1]);
return 0;
}
EOF
gcc -O2 -Wall -Wextra epoll_out_demo.c -o epoll_out_demo
./epoll_out_demo预期输出:
send blocked: enable EPOLLOUT
EPOLLOUT ready
queue empty: disable EPOLLOUT内核实际发送缓冲区容量和每次 send() 写入的字节数可能不同,但只要发送量足够触发 EAGAIN,事件状态变化应保持上述顺序。
部分写入必须和队列状态绑定
真正的连接对象通常保存“缓冲块 + 当前偏移”。当 send() 返回 n > 0 时,只能认为前 n 字节已交给内核;若仍有剩余,应继续尝试,直到写完或遇到 EAGAIN。如果队列里还有下一块数据,也应按同一规则继续发送。
注册状态最好也放进连接对象,例如维护 write_interest_enabled,只在 false→true 或 true→false 时调用 epoll_ctl()。这样既能避免重复 MOD,也能保证“发送队列为空”与“没有监听 EPOLLOUT”始终一致。核心规则只有一句:有积压且已经写不动时才监听可写,积压清空后立刻取消。