为何EPOLLOUT未被触发？水平触发模式epoll_wait休眠问题排查

安全阿岳

2026-5-21

问题分析与解决

首先，咱们得抓住epoll的核心逻辑：epoll_wait只会响应你通过epoll_ctl主动注册的事件，哪怕socket本身处于可写状态，只要你没把EPOLLOUT事件加入监听集合，epoll就不会触发任何通知——这就是你程序里epoll_wait一直休眠的根本原因。

具体拆解一下：

事件注册是大前提
水平触发（LT）模式下，epoll的触发逻辑是：当事件状态为真（比如socket可写）且你已经注册了该事件时，epoll_wait会持续通知你，直到事件状态变为假（比如socket缓冲区满到无法再写入）或者你处理完事件。但如果从一开始就没注册EPOLLOUT，epoll完全不会关心socket的可写状态。
你大概率是在调用epoll_ctl时只设置了EPOLLIN事件，漏掉了EPOLLOUT，所以哪怕socket可写，epoll_wait也不会被唤醒。
额外的排查细节
- 如果是客户端socket：要确认connect是否已经成功完成。如果是非阻塞connect，你需要通过getsockopt检查连接状态，只有连接成功后，socket才会进入稳定的可写状态。
- 如果是服务器端的监听socket：监听socket的"可写"状态没有实际意义，只有accept返回的连接socket才会有读写事件的需求。

修复示例

如果你确实需要监听socket的可写事件，在调用epoll_ctl注册事件时，要显式加入EPOLLOUT：

int epollfd = epoll_create1(0);
if (epollfd == -1) {
    perror("epoll_create1");
    return -1;
}

struct epoll_event ev;
ev.events = EPOLLIN | EPOLLOUT; // 同时监听可读和可写事件
ev.data.fd = sfd; // sfd是你的目标socket描述符

if (epoll_ctl(epollfd, EPOLL_CTL_ADD, sfd, &ev) == -1) {
    perror("epoll_ctl");
    close(epollfd);
    return -1;
}