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

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,也不是把写方向一并关闭。

TCPConn CloseRead 关闭读方向并保留写方向的结构示意图
图1:CloseRead 的读写方向关系说明图,不是运行截图。

官方 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 后 Read 与 Write 状态分离的边界示意图
图2:半关闭状态与完整关闭状态的边界说明图,不是运行截图。

CloseRead、CloseWrite 和 Close 有什么区别

方法影响方向适合表达的意图
CloseRead读方向本端不再接收或处理输入,但可能继续写
CloseWrite写方向本端不再发送,仍可能继续读取对端剩余数据
Close整条连接连接生命周期结束,不再区分方向

如果需求是“告诉对端我已经发完,但还要读完对方响应”,看的是 CloseWrite;如果需求是“我不再读,但还要回一条消息”,才考虑 CloseRead。方向选反会让代码看起来能运行,却在协议收尾时丢掉数据。

三个容易踩到的边界

  1. 手里只有 net.Conn:先断言为 *net.TCPConn,断言失败就返回清晰错误,不要强行转换。
  2. 连接实际是 TLS:CloseRead 是 TCPConn 的能力,不能把 TLS 连接当成普通 TCP 半关闭对象;TLS 的记录层和关闭通知需要单独设计。
  3. 重复调用或全量清理:把方向切换和最终 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

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