Go中控制Socket读写超时需调用SetReadDeadline和SetWriteDeadline设置绝对时间点,每次读/写前必须重设;客户端优先使用DialTimeout或http.Client内置超时。

在 Go 中控制 Socket 的读写超时,关键在于对 net.Conn 接口调用 SetReadDeadline 和 SetWriteDeadline 方法。它们不是“阻塞时间上限”,而是设定一个绝对时间点,超过该时间点再进行读/写操作就会返回 timeout 错误。正确使用需要配合业务逻辑重置时间点,否则一次设置后连接会持续失效。
读超时:每次读取前都需更新 ReadDeadline
TCP 连接是长连接,读操作可能分多次完成(比如读 HTTP 请求头、再读 body)。若只在连接建立后设一次 deadline,后续读取大概率直接超时。
- 对每个
Read操作前,调用conn.SetReadDeadline(time.Now().Add(timeout)) - 如果读取的是不定长数据(如按行、按协议包),应在每次
Read前重设;若用bufio.Reader,也要注意其内部缓冲行为,必要时对底层conn手动设 deadline - 示例:
conn.SetReadDeadline(time.Now().Add(5 * time.Second))
n, err := conn.Read(buf)
若err == net.ErrTimeout或err.(net.Error).Timeout() == true,说明读超时
写超时:同样需在每次写前设置 WriteDeadline
写操作也可能因对端接收窗口满、网络拥塞等被阻塞。尤其在高延迟或弱网环境下,不设写超时会导致 goroutine 长期 hang 住。
- 每次调用
Write前设置:conn.SetWriteDeadline(time.Now().Add(3 * time.Second)) - 注意:
Write返回n, nil并不表示数据已送达对端,只表示成功写入内核发送缓冲区;超时仅针对“写入缓冲区”这一步的阻塞 - 若需确保对端收到,需上层协议配合 ACK 机制,超时控制无法替代
更简洁的方式:用 net.DialTimeout 和 http.Client 超时
对于客户端场景,Go 标准库提供了更高阶封装:
立即学习“go语言免费学习笔记(深入)”;
-
net.DialTimeout(network, addr, timeout):只控制连接建立阶段超时(三次握手) - HTTP 客户端应优先使用
http.Client的Timeout、Transport中的IdleConnTimeout、ResponseHeaderTimeout等字段,比手动设 Conn deadline 更安全可靠 - 自定义 TCP 连接池或长连接服务(如 MQTT、RPC)才需直接操作
SetRead/WriteDeadline
常见误区与注意事项
容易忽略但影响稳定性的细节:
-
SetDeadline同时影响读和写,但一般不推荐用它代替分开设置,语义不清晰 - deadline 时间为绝对时间,不是相对时长;重复调用会覆盖,不是累加
- 超时错误类型是
net.Error,需用类型断言判断:if ne, ok := err.(net.Error); ok && ne.Timeout() - UDP 使用
net.UDPConn,也支持SetReadDeadline,但无连接概念,不涉及写超时(sendto 通常不阻塞)










