C / C++ / 系统课时
使用 epoll 管理连接
使用 epoll 管理连接
epoll 适合在单线程或少量 I/O 线程中同时管理大量文件描述符。本课用一个可运行的管道示例串起 epoll_create1、epoll_ctl 与 epoll_wait,重点掌握“注册关注事件、等待就绪、按返回事件分发处理”的完整闭环。
学习目标
- 能创建
epoll实例,并用epoll_ctl添加、修改和删除文件描述符。 - 能根据
epoll_wait返回的事件集合进行分发,而不是遍历全部连接。 - 能正确处理
EPOLLIN、EPOLLHUP、EPOLLERR等常见事件。
epoll 的管理模型
epoll 维护的是一组“需要关注的文件描述符及其事件”。程序先创建一个 epoll 实例,再通过 epoll_ctl 把 socket、管道等 fd 注册进去;随后 epoll_wait 只返回当前已经就绪的项,事件循环据此调用对应处理逻辑。

三个核心接口职责不同:epoll_create1(EPOLL_CLOEXEC) 创建实例;epoll_ctl 维护关注集合;epoll_wait 获取就绪事件。生产代码通常把连接 fd 放进 ev.data.fd 或 ev.data.ptr,从而在事件返回后定位连接上下文。
用一个可运行示例完成注册与分发
下面创建两条管道,把两个读端都注册到同一个 epoll 实例,然后分别写入数据。epoll_wait 返回时,程序只遍历实际就绪的事件。
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/epoll.h>
#include <unistd.h>
#define MAX_EVENTS 8
static void die(const char *msg) {
perror(msg);
exit(EXIT_FAILURE);
}
int main(void) {
int epfd = epoll_create1(EPOLL_CLOEXEC);
if (epfd == -1) die("epoll_create1");
int p1[2], p2[2];
if (pipe(p1) == -1 || pipe(p2) == -1) die("pipe");
// 两个读端都关注可读事件,并把 fd 自身作为事件上下文保存。
int read_fds[] = {p1[0], p2[0]};
for (size_t i = 0; i < 2; ++i) {
struct epoll_event ev = {0};
ev.events = EPOLLIN;
ev.data.fd = read_fds[i];
if (epoll_ctl(epfd, EPOLL_CTL_ADD, read_fds[i], &ev) == -1) {
die("epoll_ctl ADD");
}
}
if (write(p1[1], "alpha", 5) != 5) die("write p1");
if (write(p2[1], "beta", 4) != 4) die("write p2");
struct epoll_event events[MAX_EVENTS];
int n = epoll_wait(epfd, events, MAX_EVENTS, 1000);
if (n == -1) die("epoll_wait");
for (int i = 0; i < n; ++i) {
int fd = events[i].data.fd;
// 错误与挂断通常应优先处理,避免继续把异常连接当正常数据读。
if (events[i].events & (EPOLLERR | EPOLLHUP)) {
fprintf(stderr, "fd=%d error-or-hup\n", fd);
continue;
}
if (events[i].events & EPOLLIN) {
char buf[32];
ssize_t nr = read(fd, buf, sizeof(buf) - 1);
if (nr == -1) die("read");
buf[nr] = '\0';
printf("fd=%d data=%s\n", fd, buf);
}
}
if (epoll_ctl(epfd, EPOLL_CTL_DEL, p1[0], NULL) == -1) die("DEL p1");
if (epoll_ctl(epfd, EPOLL_CTL_DEL, p2[0], NULL) == -1) die("DEL p2");
close(p1[0]); close(p1[1]);
close(p2[0]); close(p2[1]);
close(epfd);
return 0;
}保存为 epoll_demo.c 后编译并运行:
gcc -Wall -Wextra -O2 epoll_demo.c -o epoll_demo
./epoll_demo预期输出:
fd=<ID> data=alpha
fd=<ID> data=beta两个 fd 的具体数值由进程当前打开文件决定,因此用 <ID> 表示;两行的先后顺序也可能不同,因为 epoll_wait 不承诺按注册顺序返回事件。
正确使用 epoll_ctl
EPOLL_CTL_ADD 用于首次注册,重复添加同一 fd 会失败并返回 EEXIST;需要修改关注事件时使用 EPOLL_CTL_MOD;不再管理连接时使用 EPOLL_CTL_DEL。连接关闭后仍应同步清理应用层的连接对象,避免把已复用的 fd 误认成旧连接。
在真实服务器中,最常见的变化是按需启用 EPOLLOUT。只有发送缓冲区写满且确实还有待发送数据时,才把 EPOLLOUT 加入关注集合;待缓冲数据写完后再移除。若始终监听可写事件,socket 大多数时间都处于“可写”状态,事件循环会被无意义地反复唤醒。
事件循环的边界处理
epoll_wait 返回 -1 时要检查 errno。如果被信号中断且 errno == EINTR,通常应重新等待;其他错误再按故障处理。返回 0 表示超时,不是错误,可用于执行定时任务、空闲连接清理或退出检查。
处理连接事件时,应把 EPOLLERR、EPOLLHUP 与正常读写事件一起考虑。对于 socket,即使同时出现 EPOLLIN 与挂断,也可能仍有最后一批数据可读;具体策略取决于协议。稳定的事件循环应做到:只处理本轮返回的就绪项,处理后更新关注集合,并在连接生命周期结束时释放对应资源。