Go net.TCPConn.CloseRead 怎样半关闭 TCP 连接的读方向
来源:17golang原创
时间:2026-11-17 13:53:38 227浏览 收藏
如果你只想让 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
-
369 收藏
-
344 收藏
-
488 收藏
-
464 收藏
-
327 收藏
-
234 收藏
-
156 收藏
-
Golang · Go问答 | 25分钟前 | 错误处理 · Context · HTTP客户端 · Go问答 · Http请求 Go error nil context http.NewRequestWithContext189 收藏
-
492 收藏
-
385 收藏
-
487 收藏
-
Golang · Go问答 | 47分钟前 | 错误处理 · 重定向 · net/http · HTTP客户端 · Go问答 · Go HTTP重定向 http.Response.Location http.ErrNoLocation Location头420 收藏
-
429 收藏
-
201 收藏
-
265 收藏
-
501 收藏
-
227 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习