Go net.TCPConn.CloseRead 怎样半关闭 TCP 连接的读方向
如果你只想让 TCP 连接停止接收数据,但还要把确认、结束标记或代理收尾信息发出去,应该调用 *net.TCPConn.CloseRead(),而不是直接调用 Close()。它关闭的是读方向,写方向仍然单独存在;调用方必须处理返回错误,并确认手里的连接确实是 TCP 连接。
一句话记忆:CloseRead负责“我不再读”,CloseWrite负责“我不再写”,Close才是“整条连接都不要了”。
CloseRead 到底关闭了哪一侧
TCP 连接可以把读和写看成两个方向。CloseRead 让本端停止使用读方向,适合代理转发、协议已经决定不再接收后续数据,但仍需从本端发送最后一段响应的场景。它不是把连接对象变成 nil,也不是把写方向一并关闭。

官方 API 挂在 net.TCPConn 上,因此最先要检查类型。业务函数如果只接收 net.Conn,不能假设任何连接都支持 TCP 的半关闭能力。
先做类型断言,再关闭读方向
下面的辅助函数保留了接口层的错误信息:不是 TCP 连接时直接返回,CloseRead 失败时也不继续伪装成成功。
package main
import (
"fmt"
"net"
)
func closeTCPReadSide(conn net.Conn) error {
// net.Conn 是通用接口,只有 TCPConn 才提供 CloseRead。
tcpConn, ok := conn.(*net.TCPConn)
if !ok {
return fmt.Errorf("connection is not *net.TCPConn")
}
// 只关闭本端读方向,写方向的生命周期另行处理。
if err := tcpConn.CloseRead(); err != nil {
return fmt.Errorf("close tcp read side: %w", err)
}
return nil
}
这里没有把 CloseRead 放进 defer,因为它不是常规的资源总清理动作,而是协议状态的一次方向切换。什么时候切换,应由协议状态决定。
关闭读方向后,写方向仍要单独判断
半关闭的价值在于:读方向不再接受后续处理,但写方向仍可能要发送响应或收尾数据。下面的结构先检查关闭读方向的结果,再尝试发送一段通知;发送结果仍需独立处理。
func rejectFurtherInputAndReply(conn net.Conn, reply []byte) error {
// 类型断言确保后续调用使用的是 TCP 专有能力。
tcpConn, ok := conn.(*net.TCPConn)
if !ok {
return fmt.Errorf("need TCP connection for half-close")
}
// 读侧停止后,不再从该连接消费新的输入。
if err := tcpConn.CloseRead(); err != nil {
return fmt.Errorf("close read side: %w", err)
}
// 写侧不是 CloseRead 的副作用,响应仍按普通写入处理错误。
if _, err := tcpConn.Write(reply); err != nil {
return fmt.Errorf("write final reply: %w", err)
}
return nil
}
不要把“CloseRead 返回 nil”理解成整条连接已经可安全回收。它只说明读侧关闭调用没有返回错误;最终写入、连接关闭和 goroutine 退出仍是自己的责任。
Read、Write 和 CloseRead 的错误边界
调用后,后续读操作不应再被当作正常输入路径。读循环应记录错误并结束;如果业务仍需发送数据,则把写路径和读路径分开管理。不要依赖某一种具体错误字符串,因为网络错误可能包含包装信息。
func finishReadLoop(conn *net.TCPConn) error {
// 关闭读侧前先完成本业务层的状态判断。
if err := conn.CloseRead(); err != nil {
return err
}
buf := make([]byte, 256)
// 关闭读方向后的 Read 只用于收敛退出路径,不再处理业务数据。
_, err := conn.Read(buf)
if err != nil {
return fmt.Errorf("read loop ended after CloseRead: %w", err)
}
return nil
}
这段代码的重点不是把错误当作某个固定值,而是把“读循环结束”与“写方向收尾”分开记录。若一个 goroutine 负责读、另一个 goroutine 负责写,还要用明确的退出信号协调它们,避免一侧提前返回后留下泄漏。

CloseRead、CloseWrite 和 Close 有什么区别
| 方法 | 影响方向 | 适合表达的意图 |
|---|---|---|
CloseRead | 读方向 | 本端不再接收或处理输入,但可能继续写 |
CloseWrite | 写方向 | 本端不再发送,仍可能继续读取对端剩余数据 |
Close | 整条连接 | 连接生命周期结束,不再区分方向 |
如果需求是“告诉对端我已经发完,但还要读完对方响应”,看的是 CloseWrite;如果需求是“我不再读,但还要回一条消息”,才考虑 CloseRead。方向选反会让代码看起来能运行,却在协议收尾时丢掉数据。
三个容易踩到的边界
- 手里只有 net.Conn:先断言为
*net.TCPConn,断言失败就返回清晰错误,不要强行转换。 - 连接实际是 TLS:
CloseRead是 TCPConn 的能力,不能把 TLS 连接当成普通 TCP 半关闭对象;TLS 的记录层和关闭通知需要单独设计。 - 重复调用或全量清理:把方向切换和最终
Close分开记录,避免多个退出路径重复承担同一状态转换。
在生产代码里,建议给读循环、写循环和最终关闭分别设置日志字段,例如连接 ID、当前方向和操作结果。这样排查“读已停但写也失败”的问题时,能知道失败发生在半关闭调用、后续写入还是完整关闭阶段。
总结
net.TCPConn.CloseRead 的核心不是“关闭一个连接”,而是明确关闭 TCP 连接的读方向。正确流程是:确认具体类型,调用并处理返回错误,把后续读路径视为退出路径,同时独立处理仍可能存在的写路径。需要停止写入却继续读取时使用 CloseWrite;需要结束全部通信时才调用 Close。
常见问题
CloseRead 是否等于 Close?
不等于。CloseRead 只表达读方向结束,Close 表达整条连接结束。
为什么 net.Conn 没有 CloseRead 方法?
因为 net.Conn 还可以代表 UDP、Unix 域连接等不同实现,方向半关闭并不是所有实现都提供的通用能力。TCP 专有操作需要先拿到 *net.TCPConn。
CloseRead 后还能 Write 吗?
CloseRead 的语义只针对读方向,因此写路径要独立处理;能否完成最终写入仍取决于连接状态、对端状态和写入返回错误。
应该用错误字符串判断读循环结束吗?
不建议。保留错误上下文并按业务退出路径处理,必要时使用 errors.Is 配合具体错误类型或网络状态判断。
官方文档:https://pkg.go.dev/net#TCPConn.CloseRead
Go net.TCPConn.SetLinger 怎样理解关闭连接时的等待语义
- 上一篇
- Go net.TCPConn.SetLinger 怎样理解关闭连接时的等待语义
- 下一篇
- Go http.NewRequestWithContext 传入 nil context 为什么会 panic
-
- Golang · Go问答 | 25分钟前 | 标准库 · Go问答 · Go At image.Image Bounds color.Color 像素读取
- Go image.Image.At 怎样按坐标读取像素颜色
- 156浏览 收藏
-
- Golang · Go问答 | 38分钟前 |
- Go csv.Reader.Comma 怎样设置分号分隔符并处理非法配置
- 385浏览 收藏
-
- Golang · Go问答 | 46分钟前 | 错误处理 · 重定向 · net/http · HTTP客户端 · Go问答 · Go HTTP重定向 http.Response.Location http.ErrNoLocation Location头
- Go http.Response.Location 没有 Location 头时怎么判断重定向目标缺失
- 420浏览 收藏
-
- Golang · Go问答 | 1小时前 | net/http · Go问答 · Go URL查询参数 http.Request ParseForm 表单请求体
- Go http.Request.ParseForm 什么时候会读取请求体
- 201浏览 收藏
-
- Golang · Go问答 | 1小时前 | 错误处理 · go · Go io.Writer text/tabwriter tabwriter.Writer.Flush
- Go tabwriter.Writer.Flush 怎样判断表格输出是否完整
- 265浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go gosym.Sym.PackageName 怎样提取符号所属的包名
- 227浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1074次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1075次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1237次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1181次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1022次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Go语言TCP从原理到代码实现详解
- 2022-12-30 488浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览

