Go / 系统课时
正确关闭一条网络连接
正确关闭一条网络连接
关闭连接不只是调用一次 Close。服务端需要区分对端正常结束写入、本端主动关闭以及读写异常,并确保处理函数最终退出、连接对象被释放、关联 goroutine 不再阻塞。本节用一个完整 TCP 示例串起正常 EOF、半关闭和统一清理流程。
学习目标
- 区分正常 EOF、本端主动关闭和异常断连在 Go 中的表现。
- 使用
defer conn.Close()保证连接处理函数退出时释放资源。 - 通过 TCP 半关闭完成“请求发送完毕,但仍等待响应”的正常收尾。
三种结束方式不要混为一谈
对端正常关闭写方向后,本端把已到达的数据读完,下一次读取会得到 io.EOF;若使用 bufio.Scanner,正常 EOF 会让 Scan 返回 false,而 Scanner.Err() 仍为 nil。这表示字节流正常结束,不需要按故障记录。
本端主动调用 Close 会释放自己的连接资源,并让本进程中阻塞在该连接上的并发读写尽快返回错误。网络故障、RST、超时等异常断连则通常表现为非 EOF 的读写错误,应该保留错误信息用于诊断。

连接处理代码应把“关闭”设计成生命周期的一部分:无论正常返回还是错误返回,最终都走到同一个资源清理点。这样错误分支越多,越不容易遗漏 Close。
用半关闭完成正常收尾
下面的程序在本机临时端口建立一条 TCP 连接。客户端写入一行请求后调用 CloseWrite,表示“我不会再发送数据,但仍要读取响应”;服务端读到正常 EOF 后返回,defer conn.Close() 负责最终释放连接。监听地址使用端口 0 让操作系统自动选择可用端口,因此实际端口每次运行可能不同。
package main
import (
"bufio"
"fmt"
"net"
)
type result struct {
state string
err error
}
func handle(conn net.Conn) result {
defer conn.Close()
scanner := bufio.NewScanner(conn)
for scanner.Scan() {
// 收到完整请求后立即回复;循环结束再判断是正常 EOF 还是异常错误。
if _, err := fmt.Fprintf(conn, "ack:%s\n", scanner.Text()); err != nil {
return result{state: "write error", err: err}
}
}
if err := scanner.Err(); err != nil {
return result{state: "abnormal disconnect", err: err}
}
return result{state: "normal EOF"}
}
func main() {
ln, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
panic(err)
}
defer ln.Close()
resultCh := make(chan result, 1)
go func() {
conn, err := ln.Accept()
if err != nil {
resultCh <- result{state: "accept error", err: err}
return
}
resultCh <- handle(conn)
}()
conn, err := net.Dial("tcp", ln.Addr().String())
if err != nil {
panic(err)
}
tcp := conn.(*net.TCPConn)
if _, err := fmt.Fprintln(tcp, "ping"); err != nil {
panic(err)
}
// 只关闭客户端写方向,让服务端看到正常 EOF,同时保留读方向等待响应。
if err := tcp.CloseWrite(); err != nil {
panic(err)
}
reply, err := bufio.NewReader(tcp).ReadString('\n')
if err != nil {
panic(err)
}
fmt.Printf("client received: %s", reply)
if err := tcp.Close(); err != nil {
panic(err)
}
r := <-resultCh
fmt.Printf("server state: %s\n", r.state)
if r.err != nil {
fmt.Printf("server error: %v\n", r.err)
}
}预期输出
client received: ack:ping
server state: normal EOF这里的 CloseWrite 是 TCP 半关闭:客户端发送 FIN 结束自己的写方向,但读方向仍然可用。若直接在写完请求后调用完整 Close,客户端也会放弃后续读取,便无法完成“发送结束后等待响应”的协议流程。
让 goroutine 随连接一起结束
常见服务模型会为每条连接启动一个处理 goroutine。只要处理函数的所有退出路径最终都会返回,并在入口处安排 defer conn.Close(),连接对象和该 goroutine 就能一起结束;真正危险的是某个分支既不返回,也没有超时或取消条件。
当同一连接存在独立的读 goroutine 和写 goroutine 时,不要让多个地方无协调地重复决定关闭时机。更稳妥的做法是由一个生命周期控制点发起关闭,并让其他 goroutine 因 Close、上下文取消或通道关闭而退出。
异常断连如何处理
如果 Scanner.Err() 返回非 nil,就不要把它包装成正常 EOF。超时、连接复位、网络中断或本端并发关闭都可能进入这个分支;日志应至少保留远端地址、当前处理阶段和原始错误,方便判断问题发生在读取、业务处理还是写回阶段。
服务主动停机时,监听器和已有连接也要分别处理:先停止接收新连接,再通知存量处理流程结束;需要强制退出时再关闭连接以打断阻塞 I/O。无论选择优雅关闭还是强制关闭,验收标准都一样:连接数量能下降,处理 goroutine 能退出,且没有长期卡在读写调用上的残留任务。