Go / 系统课时

处理临时网络错误

处理临时网络错误

网络调用返回错误后,最危险的做法是统一重试:有些错误只是超时,有些意味着对端已经关闭,还有些会让当前连接失去继续使用的意义。本节用 errors.Is、errors.As 和 net.Error 把错误分类,再为不同类型选择继续、有限重试或关闭连接。

学习目标

  • 用 errors.As 提取 net.Error 并判断超时属性
  • 区分截止时间超时、io.EOF 与其他网络错误
  • 为可恢复错误设置有限重试,并避免依赖已废弃的 Temporary

先按错误语义决定动作

网络错误处理应该先识别“错误意味着什么”,再决定是否重试。io.EOF 表示流已经正常结束,通常应关闭当前连接;os.ErrDeadlineExceeded 表示操作越过了设置的截止时间,可以根据业务策略选择刷新截止时间后再试一次,或直接按空闲连接处理。其他实现了 net.Error 的错误还可以通过 Timeout() 判断是否属于超时类。

网络错误分类与处理决策

net.Error 仍包含 Temporary(),但这个属性的语义并不稳定,新代码不应把它作为通用重试开关。更可靠的判断依据是明确的截止时间错误、超时属性、协议语义以及当前操作是否允许安全重试。

用真实超时验证判断逻辑

下面的程序用 net.Pipe 制造一次真实读超时。第一次读取的截止时间只有 50 毫秒,而客户端在 120 毫秒后才写入数据,因此服务端先观察到超时;随后刷新截止时间并只重试一次,第二次读取成功。

go
package main

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

func main() {
    server, client := net.Pipe()
    defer server.Close()
    defer client.Close()

    go func() {
        time.Sleep(120 * time.Millisecond)
        _, _ = client.Write([]byte("ok"))
    }()

    buf := make([]byte, 2)
    if err := server.SetReadDeadline(time.Now().Add(50 * time.Millisecond)); err != nil {
        panic(err)
    }

    _, err := server.Read(buf)
    if err != nil {
        var netErr net.Error
        if errors.As(err, &netErr) {
            fmt.Printf("timeout=%v\n", netErr.Timeout())
        }
        if errors.Is(err, os.ErrDeadlineExceeded) {
            fmt.Println("decision: refresh deadline and retry once")
        }
    }

    if err := server.SetReadDeadline(time.Now().Add(500 * time.Millisecond)); err != nil {
        panic(err)
    }
    n, err := server.Read(buf)
    if err != nil {
        panic(err)
    }
    fmt.Printf("read=%q\n", buf[:n])
}

预期输出

text
timeout=true
decision: refresh deadline and retry once
read="ok"

这个示例之所以可以继续读取,是因为第一次错误来自明确的读截止时间,而且代码主动刷新了新的截止时间。真实服务里不要把“任何 Timeout() 都重试”写成死循环,因为超时可能来自不同层次,重复同一操作也未必安全。

把重试限制在可证明安全的范围

对于连接级读取,可以把策略收敛为几条明确规则:收到 io.EOF 就结束;达到空闲截止时间时按协议关闭或有限重试;未知的非超时错误通常记录后关闭当前连接。对于拨号、DNS 或请求级操作,还要额外判断操作是否幂等,以及是否已经产生了部分写入。

“临时”不是错误类型本身的永久属性,而是由当前操作、协议状态和重试成本共同决定。把判断写成小而明确的分支,并给重试设置次数、退避和总时限,比看到 net.Error 就继续循环更安全。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理临时网络错误

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

登录哪都通