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 立刻结束。

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

预期输出

text
client received: hello
server stopped: context canceled
after cancel: EOF

监听端口由操作系统临时分配,因此示例不依赖固定端口。关键行为是:cancel() 先传播停止信号,conn.Close() 再把阻塞 I/O 唤醒,最终连接处理函数退出。

把取消边界放在连接所有权上

生产代码应明确谁拥有连接以及谁负责关闭它。通常由连接处理函数最终执行 Close,而取消监视逻辑只负责在需要提前终止时触发关闭。这样即使正常断开、服务停机和超时同时发生,也不会出现多个模块各自维护一套退出协议。

连接上的其他后台任务也应接收同一个派生 context,例如心跳、异步查询或业务流水线。它们收到取消信号后停止创建新工作;阻塞在网络 I/O 的 goroutine 则由连接关闭负责唤醒。

当连接退出路径统一成“发出取消信号、停止后台任务、关闭连接、等待 goroutine 收尾”后,服务停机、请求撤销和异常断开都能复用同一套资源回收逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

让连接支持主动取消

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

登录哪都通