Go / 系统课时
让连接支持主动取消
让连接支持主动取消
长连接处理常卡在 Read、Write 或后台 goroutine 上。仅取消 context.Context 不会自动打断套接字 I/O,本节用“取消信号 + 主动关闭连接”把阻塞操作唤醒,并让同一连接上的后台任务一起退出。
学习目标
- 理解
context与net.Conn.Close在取消链路中的不同职责 - 用统一的连接生命周期终止阻塞 I/O 和后台任务
- 识别取消、超时与正常断开的边界
为什么只取消 context 还不够
context 负责传播“应该停止”的信号,但 net.Conn.Read 和 net.Conn.Write 不会自动监听这个信号。若 goroutine 正阻塞在读操作上,调用 cancel() 后它仍可能一直停在那里。
可靠做法是让一个监视 goroutine 等待 ctx.Done();一旦收到取消信号,就调用 conn.Close()。关闭连接会让正在阻塞的网络读写返回错误,主处理循环因此获得退出机会,后续清理也能顺序执行。

用关闭连接打断阻塞 I/O
下面的完整程序启动一个本地 TCP 服务。服务端正常回显第一条消息;随后主流程调用 cancel(),监视 goroutine 主动关闭服务端连接,使正在等待下一条消息的 Scanner 立刻结束。
package main
import (
"bufio"
"context"
"fmt"
"net"
"sync"
)
func handleConn(ctx context.Context, conn net.Conn) {
defer conn.Close()
stopClose := make(chan struct{})
go func() {
select {
case <-ctx.Done():
// context 只发信号,真正打断阻塞 I/O 要靠关闭连接。
_ = conn.Close()
case <-stopClose:
}
}()
scanner := bufio.NewScanner(conn)
for scanner.Scan() {
_, _ = fmt.Fprintln(conn, scanner.Text())
}
close(stopClose)
fmt.Println("server stopped:", ctx.Err())
}
func main() {
ln, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
panic(err)
}
defer ln.Close()
ctx, cancel := context.WithCancel(context.Background())
var wg sync.WaitGroup
wg.Add(1)
go func() {
defer wg.Done()
conn, err := ln.Accept()
if err != nil {
return
}
handleConn(ctx, conn)
}()
client, err := net.Dial("tcp", ln.Addr().String())
if err != nil {
panic(err)
}
defer client.Close()
reader := bufio.NewReader(client)
_, _ = fmt.Fprintln(client, "hello")
line, err := reader.ReadString('\n')
if err != nil {
panic(err)
}
fmt.Print("client received: ", line)
cancel()
wg.Wait()
_, err = reader.ReadString('\n')
fmt.Println("after cancel:", err)
}预期输出
client received: hello
server stopped: context canceled
after cancel: EOF监听端口由操作系统临时分配,因此示例不依赖固定端口。关键行为是:cancel() 先传播停止信号,conn.Close() 再把阻塞 I/O 唤醒,最终连接处理函数退出。
把取消边界放在连接所有权上
生产代码应明确谁拥有连接以及谁负责关闭它。通常由连接处理函数最终执行 Close,而取消监视逻辑只负责在需要提前终止时触发关闭。这样即使正常断开、服务停机和超时同时发生,也不会出现多个模块各自维护一套退出协议。
连接上的其他后台任务也应接收同一个派生 context,例如心跳、异步查询或业务流水线。它们收到取消信号后停止创建新工作;阻塞在网络 I/O 的 goroutine 则由连接关闭负责唤醒。
当连接退出路径统一成“发出取消信号、停止后台任务、关闭连接、等待 goroutine 收尾”后,服务停机、请求撤销和异常断开都能复用同一套资源回收逻辑。