Linux epoll EPOLLRDHUP 怎样判断对端半关闭
在长连接服务里,最容易误判的一类事件是“对端已经不再发送数据,但本地还有数据没读完”。这时只看 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 带来的数据。

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

整理关闭与错误边界
把连接收尾拆成三个独立判断会更稳:
- 还有数据吗?先看读取结果,正数就继续交给协议层,不能先 close。
- 对端还会写吗?用
EPOLLRDHUP记录对端写方向已关闭;这不等于本地发送方向也必须马上关闭。 - 发生不可恢复错误吗?遇到
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 会同时出现?
因为对端可以先关闭写方向,而此前发送的数据仍在本地接收缓冲中。此时既有半关闭状态,也有可读数据。
Linux pidfd 怎样等待指定进程退出而不复用 PID
- 上一篇
- Linux pidfd 怎样等待指定进程退出而不复用 PID
- 下一篇
- Linux inotify 队列溢出后怎样重建目录状态
-
- 文章 · linux | 23分钟前 | Linux 文件权限 capabilities getcap user namespace libcap
- Linux getcap 怎样查看文件携带的 capabilities
- 147浏览 收藏
-
- 文章 · linux | 29分钟前 |
- systemd timer 怎样表达日历调度并查看下一次触发
- 448浏览 收藏
-
- 文章 · linux | 1天前 |
- Linux pidfd怎样安全等待进程结束
- 170浏览 收藏
-
- 文章 · linux | 1天前 |
- Linux perf record定位CPU热点
- 418浏览 收藏
-
- 文章 · linux | 1天前 | linux运维 · Linux 命名空间 挂载树 Mount API open_tree move_mount
- Linux open_tree怎样复制挂载树
- 376浏览 收藏
-
- 文章 · linux | 1天前 | linux运维 · Linux 防火墙规则 nftables nft list ruleset 地址族 规则集导出
- nftables list ruleset怎样按地址族导出配置
- 308浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1057次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1058次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1222次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1164次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1005次使用
-
- 深入了解Golang网络编程Net包的使用
- 2023-01-23 215浏览
-
- Go语言WEB框架(Gin)详解
- 2023-01-07 399浏览
-
- Go语言Ratelimit服务流量限制
- 2022-12-29 458浏览
-
- Go语言session的创建和管理
- 2022-12-28 151浏览
-
- Go语言是如何使得Web工作的
- 2022-12-24 169浏览

