Go / 系统课时

正确关闭一条网络连接

正确关闭一条网络连接

关闭连接不只是调用一次 Close。服务端需要区分对端正常结束写入、本端主动关闭以及读写异常,并确保处理函数最终退出、连接对象被释放、关联 goroutine 不再阻塞。本节用一个完整 TCP 示例串起正常 EOF、半关闭和统一清理流程。

学习目标

  • 区分正常 EOF、本端主动关闭和异常断连在 Go 中的表现。
  • 使用 defer conn.Close() 保证连接处理函数退出时释放资源。
  • 通过 TCP 半关闭完成“请求发送完毕,但仍等待响应”的正常收尾。

三种结束方式不要混为一谈

对端正常关闭写方向后,本端把已到达的数据读完,下一次读取会得到 io.EOF;若使用 bufio.Scanner,正常 EOF 会让 Scan 返回 false,而 Scanner.Err() 仍为 nil。这表示字节流正常结束,不需要按故障记录。

本端主动调用 Close 会释放自己的连接资源,并让本进程中阻塞在该连接上的并发读写尽快返回错误。网络故障、RST、超时等异常断连则通常表现为非 EOF 的读写错误,应该保留错误信息用于诊断。

TCP 连接关闭状态与处理路径

连接处理代码应把“关闭”设计成生命周期的一部分:无论正常返回还是错误返回,最终都走到同一个资源清理点。这样错误分支越多,越不容易遗漏 Close。

用半关闭完成正常收尾

下面的程序在本机临时端口建立一条 TCP 连接。客户端写入一行请求后调用 CloseWrite,表示“我不会再发送数据,但仍要读取响应”;服务端读到正常 EOF 后返回,defer conn.Close() 负责最终释放连接。监听地址使用端口 0 让操作系统自动选择可用端口,因此实际端口每次运行可能不同。

go
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)
	}
}

预期输出

text
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 能退出,且没有长期卡在读写调用上的残留任务。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

正确关闭一条网络连接

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通