当前位置:首页 > 文章列表 > 文章 > linux > Linux epoll EPOLLRDHUP 怎样判断对端半关闭

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

来源:17golang原创 2026-11-17 00:32:37 0浏览 收藏

在长连接服务里,最容易误判的一类事件是“对端已经不再发送数据,但本地还有数据没读完”。这时只看 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删除
Linux pidfd 怎样等待指定进程退出而不复用 PIDLinux pidfd 怎样等待指定进程退出而不复用 PID
上一篇
Linux pidfd 怎样等待指定进程退出而不复用 PID
Linux inotify 队列溢出后怎样重建目录状态
下一篇
Linux inotify 队列溢出后怎样重建目录状态
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1058次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1222次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1164次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1005次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码