登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

Linux epoll EPOLLRDHUP 怎样判断对端半关闭

来源:17golang原创

时间:2026-11-17 00:32:37 337浏览 收藏

在长连接服务里,最容易误判的一类事件是“对端已经不再发送数据,但本地还有数据没读完”。这时只看 EPOLLHUP 或 EPOLLRDHUP 就立即关闭文件描述符,可能会把接收缓冲里最后一段数据丢掉。

官方地址:https://man7.org/linux/man-pages/man2/epoll_ctl.2.html

EPOLLRDHUP 表示流式套接字对端关闭了连接,或者关闭了连接的写方向;它不是“本地可以立刻 close”的命令。正确做法是结合 EPOLLIN 和 read 返回值,把可读数据处理完,再决定连接是否结束。

先把“半关闭”与“读完”分开

TCP 流式连接的两个方向可以独立关闭。对端调用关闭写方向的操作后,本地不再收到新的字节,但此前已经进入接收缓冲的数据仍然可以读取。因此,“对端不再写”和“本地已经读到 EOF”是两个状态。

信号它说明什么处理重点
EPOLLIN当前文件描述符存在可读条件调用 read,以返回值判断还有多少数据
EPOLLRDHUP流式套接字对端关闭连接或关闭写方向记录半关闭状态,仍要处理可能残留的接收数据
EPOLLHUP关联文件描述符发生挂断;该事件会被报告不要据此跳过待读数据,读取结果仍需参与判断
read 返回 0本地已经读到流的末尾确认没有更多字节可读后,进入关闭或收尾状态

这几个信号可以同时出现。尤其是 EPOLLIN | EPOLLRDHUP,很可能意味着“最后一批数据已经可读,同时对端不会再发送新数据”。

注册 EPOLLIN、EPOLLRDHUP 与错误事件

注册事件时,把读取、半关闭和异常分别表达出来。EPOLLHUP 与 EPOLLERR 即使不写进感兴趣事件,epoll_wait 也会报告;显式写入的价值主要是让代码读起来更完整。

#include 
#include 
#include 

static int watch_stream(int epfd, int fd)
{
    struct epoll_event ev = {
        // data.fd 让事件返回时能找到对应的连接状态
        .events = EPOLLIN | EPOLLRDHUP | EPOLLERR | EPOLLHUP,
        .data.fd = fd,
    };

    // ADD 只建立一次监听关系;后续修改事件集合再使用 MOD
    if (epoll_ctl(epfd, EPOLL_CTL_ADD, fd, &ev) == -1) {
        // errno 需要保留给上层日志,不能把注册失败伪装成连接关闭
        return -errno;
    }
    return 0;
}

这里没有把 EPOLLRDHUP 当作“立刻释放资源”的标志,而是把它作为连接状态的一部分。这样事件处理器既能看到对端的写方向状态,也能继续处理 EPOLLIN 带来的数据。

epoll实例、interest list、流式套接字与EPOLLIN和EPOLLRDHUP事件位的静态关系图
图1:结构图展示 epoll 事件位与流式套接字的静态关系,不是截图或运行证据。

按事件组合读取并记录状态

事件处理的核心是先读取,再根据 read 的结果更新连接状态。下面的示例只展示半关闭判断,不展开边沿触发与水平触发的完整差异;即使使用默认的 LT 语义,也不应该把事件位直接当成最终连接结论。

#include 

static int consume_stream(int fd, int event_mask)
{
    char buf[4096];
    int peer_write_closed = (event_mask & EPOLLRDHUP) != 0;

    // 先处理可读数据,避免 HUP/RDHUP 到来时丢掉接收缓冲
    for (;;) {
        ssize_t n = read(fd, buf, sizeof(buf));
        if (n > 0) {
            // 这里交给协议层解析 n 个字节;示例不假设消息边界
            handle_bytes(buf, (size_t)n);
            continue;
        }
        if (n == 0) {
            // 只有 read 返回 0,才确认本地已经读到流末尾
            return peer_write_closed ? 1 : 2;
        }
        if (errno == EINTR) {
            // 被信号打断时重试读取,不改变半关闭状态
            continue;
        }
        if (errno == EAGAIN || errno == EWOULDBLOCK) {
            // 暂时没有更多字节;是否关闭由协议状态决定
            return peer_write_closed ? 3 : 0;
        }
        // 其他 errno 表示读取异常,交给上层执行错误收尾
        return -errno;
    }
}

示例中的返回值只是应用层状态码:1 表示半关闭后读到 EOF,3 表示已经排空当前可读数据但保留半关闭状态。真实项目中应把协议是否允许半关闭、是否还要发送响应、是否需要延迟回收等规则放进连接对象,而不是散落在事件位判断里。

用 read 返回值确认 EOF

EPOLLRDHUP 告诉你对端的写方向发生了变化,EPOLLIN 告诉你现在存在可读条件,真正决定“是否还有字节”的仍是 read。判断顺序可以压缩成三种结果:

  • 返回正数:仍有数据,先交给协议层消费;不要因为同时出现 RDHUP 就丢弃。
  • 返回 0:已经读到 EOF,可以将连接转入关闭或半关闭收尾状态。
  • 返回 EAGAIN/EWOULDBLOCK:当前没有更多字节,是否关闭取决于已记录的半关闭状态和业务协议。

EPOLLHUP 也不能替代这一步。Linux 手册特别说明,流式套接字发生挂断时,在所有未读数据被消费前,后续读取不一定马上返回 0。

对端关闭写方向后接收缓冲、EPOLLIN、EPOLLRDHUP与read返回值的静态关系图
图2:说明图对比半关闭时仍可读与最终 EOF 的关系,不代表某次命令的真实输出。

整理关闭与错误边界

把连接收尾拆成三个独立判断会更稳:

  1. 还有数据吗?先看读取结果,正数就继续交给协议层,不能先 close。
  2. 对端还会写吗?用 EPOLLRDHUP 记录对端写方向已关闭;这不等于本地发送方向也必须马上关闭。
  3. 发生不可恢复错误吗?遇到 EPOLLERR 或读取返回其他 errno 时,记录错误原因并执行统一资源清理。

如果协议支持“对端发完请求后半关闭、等待本端返回响应”,收到 RDHUP 后仍可以保留本端写方向。只有协议状态、读到 EOF 或明确错误共同满足关闭条件时,才移除监听关系并关闭描述符。

一张判断表用于排障

观察到的组合更合理的解释优先动作
EPOLLIN有数据或 EOF 条件可读调用 read,依据正数、0、EAGAIN 分支
EPOLLIN | EPOLLRDHUP对端不再写,但可能还有最后数据先排空数据,再决定是否保留本端写方向
EPOLLHUP 且缓冲未空对端挂断,但待读数据仍存在继续读,读到 0 后再完成关闭收尾
EPOLLERR文件描述符存在错误条件读取错误信息,停止把它当作普通可读事件

最常见的误区是把事件位当成命令:看到 RDHUP 就 close,看到 HUP 就丢弃缓冲,看到 IN 就假定一定能读到正数。事件位只是内核提供的状态线索,连接生命周期仍要由读取结果和协议状态共同决定。

总结

判断 Linux epoll 的对端半关闭,关键不是记住一个标志位,而是建立一条清晰的语义链:EPOLLRDHUP 说明对端关闭了写方向,EPOLLIN 说明当前存在可读条件,read 返回正数说明还有数据,返回 0 才确认 EOF,EPOLLHUP 与 EPOLLERR 则需要进入统一的异常收尾分支。

按“先读数据、再记状态、最后决定关闭”的顺序处理,既能保留半关闭协议的灵活性,也能避免事件循环因为过早 close 而丢失最后一段数据。

常见疑问

收到 EPOLLRDHUP 后一定要关闭连接吗?

不一定。它表示对端关闭连接或关闭写方向;如果协议允许本端继续发送响应,可以保留本端写方向,直到业务收尾。

EPOLLHUP 和 read 返回 0 有什么区别?

EPOLLHUP 是事件层面的挂断线索,read 返回 0 是本地已经读到流末尾的结果。挂断出现时仍可能有待读数据,所以不要跳过读取。

为什么 EPOLLRDHUP 和 EPOLLIN 会同时出现?

因为对端可以先关闭写方向,而此前发送的数据仍在本地接收缓冲中。此时既有半关闭状态,也有可读数据。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>