Go / 系统课时

设置连接级读写超时

设置连接级读写超时

网络读写如果没有时间边界,连接可能永久卡在 Read 或 Write 上,占住 goroutine 和连接资源。本节直接用 net.Conn 的三个 Deadline API 控制等待时间,并验证超时、清除超时与滚动刷新这三个关键行为。

学习目标

  • 区分 SetDeadline、SetReadDeadline 与 SetWriteDeadline 的作用范围
  • 用绝对截止时间限制一次读写等待,并正确识别超时错误
  • 理解 Deadline 会持续生效,知道何时清除或刷新它

三个 Deadline API 的边界

net.Conn 的 Deadline 不是“持续多久”的配置,而是一个绝对时间点。到达这个时间后,当前阻塞中的 I/O 会返回错误,之后的同方向 I/O 也会继续失败,直到你把 Deadline 移到未来或设为零值。

  • SetDeadline(t):同时设置后续读和写的截止时间。
  • SetReadDeadline(t):只限制读操作。
  • SetWriteDeadline(t):只限制写操作。
  • time.Time{}:清除对应 Deadline,恢复为不设截止时间。

如果协议读取可能长期等待客户端数据,而写响应又希望使用不同预算,就应分别设置读写 Deadline;只有两者确实共享同一时间边界时,才适合直接调用 SetDeadline。

用 net.Pipe 验证读写超时

下面用内存中的 net.Pipe 模拟一对连接,不依赖外部端口。第一次读取没有数据,会在 Deadline 到达后超时;随后清除读 Deadline,再由另一端写入 pong;最后让写端在对端不读取时触发写超时。

go
package main

import (
	"errors"
	"fmt"
	"net"
	"os"
	"time"
)

func main() {
	left, right := net.Pipe()
	defer left.Close()
	defer right.Close()

	// 没有数据到达时,读取最多等待 200ms。
	if err := left.SetReadDeadline(time.Now().Add(200 * time.Millisecond)); err != nil {
		panic(err)
	}

	buf := make([]byte, 4)
	_, err := left.Read(buf)
	fmt.Println("read timed out:", errors.Is(err, os.ErrDeadlineExceeded))

	// 零值时间会清除读 Deadline,使后续读取重新允许等待。
	if err := left.SetReadDeadline(time.Time{}); err != nil {
		panic(err)
	}

	go func() {
		time.Sleep(20 * time.Millisecond)
		_, _ = right.Write([]byte("pong"))
	}()

	n, err := left.Read(buf)
	fmt.Printf("after reset: %s, err=%v\n", buf[:n], err)

	// 对端不读取时,写操作会一直等待,因此给写方向单独设置 Deadline。
	if err := left.SetWriteDeadline(time.Now().Add(200 * time.Millisecond)); err != nil {
		panic(err)
	}

	_, err = left.Write([]byte("blocked"))
	fmt.Println("write timed out:", errors.Is(err, os.ErrDeadlineExceeded))
}

预期输出

text
read timed out: true
after reset: pong, err=<nil>
write timed out: true

这里使用 errors.Is(err, os.ErrDeadlineExceeded) 判断 Deadline 超时,比比较错误字符串更稳妥。真实网络环境下,错误文本可能包含地址、操作类型等额外信息,不应依赖固定字符串。

把超时当作滚动窗口

很多长连接并不是“建立后 30 秒必须关闭”,而是“连续 30 秒没有读到任何数据就关闭”。这类空闲超时需要在每次成功 I/O 后刷新 Deadline,而不是连接建立时只设置一次。

典型做法是在准备读取下一条消息前调用 SetReadDeadline(time.Now().Add(idleTimeout))。如果成功读到完整消息,再为下一轮读取重新计算新的绝对时间。这样活跃连接可以持续存在,真正失去响应的连接才会被回收。

常见误区与处理

不要把 Deadline 当成业务取消机制。它只约束底层连接 I/O,无法自动终止已经进入业务层的数据库查询、RPC 调用或计算任务。业务操作应使用 context.Context 等机制单独控制生命周期。

也不要在多个 goroutine 共享同一连接时随意互相修改 Deadline。net.Conn 允许并发调用方法,但 Deadline 是连接级状态,一个 goroutine 的修改会影响另一个 goroutine 的读写。需要不同请求拥有独立超时边界时,协议层应明确串行化规则,或为请求设计可取消的多路复用机制。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置连接级读写超时

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

登录哪都通