13. 超时

超时机制可以保护服务调用陷入无限的等待之中。超时定义了服务的最长等待时间,如果在给定的时间没有相应,服务调用就进入下一个状态,或者重试、或者立即返回错误。

Server

  • 你可以使用OptionFn设置服务器的 readTimeoutwriteTimeout
    type Server struct {
        ……
        readTimeout  time.Duration
        writeTimeout time.Duration
        ……
    }
    
  • 设置超时的OptionFn是:
    func WithReadTimeout(readTimeout time.Duration) OptionFn
    func WithWriteTimeout(writeTimeout time.Duration) OptionFn
    

Client

客户端有两种方式可是超时。一种是设置连接的 read/write deadline, 一种是使用 context.Context.

read/write deadline

Client的 Option 可以设置连接的超时值:

type Option struct {
    ……
    //ConnectTimeout sets timeout for dialing
    ConnectTimeout time.Duration
    // ReadTimeout sets readdeadline for underlying net.Conns
    ReadTimeout time.Duration
    // WriteTimeout sets writedeadline for underlying net.Conns
    WriteTimeout time.Duration
    ……
}

DefaultOption 设置连接超时值为 10 秒,但是没有设置 ReadTimeout 和 WriteTimeout。 如果没有设置,则不会有超时限制。由于多个服务可能共用同一个节点,有可能出现多个服务调用互相影响的状况。

context.Context

context.Context 也可以用来控制超时。你可以使用context.WithTimeout 来设置超时时间,这是推荐的设置超时的方式。

func WithTimeout(parent Context, timeout time.Duration) (Context, CancelFunc)
下一节:客户端和服务器端可以互相传递元数据。元数据不是服务请求和服务响应的业务数据,而是一些辅助性的数据。元数据是一个键值队的列表,键和值都是字符串, 类似 http.Header。