等待就绪

解释如何配置 RPC 在发送请求之前等待服务器就绪。

等待就绪

解释如何配置 RPC 在发送请求之前等待服务器就绪。

概述

这是一项可以在 stub 上使用的功能,它将导致 RPC 在发送请求之前等待服务器变为可用状态。这允许健壮的批量工作流程,因为瞬时的服务器问题不会导致失败。截止时间仍然适用,因此如果超过截止时间,等待将被中断。

当通道未能连接到服务器时创建 RPC 时,如果不使用等待就绪,它将立即返回失败;使用等待就绪,它将简单地排队,直到连接准备就绪。默认情况下为不使用等待就绪。

有关详细语义,请参阅

如何使用等待就绪

您可以指定 stub 是否应使用等待就绪,这将在创建 RPC 时自动传递。

以下显示了当客户端向服务器发送消息时发生的事件序列,基于通道状态以及是否设置了等待就绪。

sequenceDiagram
participant A as Application
participant RPC
participant CH as Channel
participant S as Server 
A->>RPC: Create RPC using stub
RPC->>CH: Initiate Communication
alt channel state: READY
  CH->>S: Send message
else Channel state: IDLE or CONNECTING
  CH-->>CH: Wait for state change
else Channel state: TRANSIENT_FAILURE
  alt with Wait-for-Ready
    CH-->>CH: Wait for channel<br>becoming READY<br>(or a permanent failure)
    CH->>S: Send message
  else without Wait-for-Ready
    CH->>A: Failure
  end
else Channel state is a Permanent Failure
    CH->>A: Failure
end

以下是基于状态的视图

stateDiagram-v2
   state "Initiating Communication" as IC
   state "Channel State" as CS
   IC-->CS: Check Channel State
   state CS {
      state "Permanent Failure" as PF
      state "TRANSIENT_FAILURE" as TF
      IDLE --> CONNECTING
      CONNECTING --> READY
      READY-->[*]
      CONNECTING-->TF
      CONNECTING-->PF
      TF-->READY
      TF -->[*]: without\n wait-for-ready
      TF-->PF
      PF-->[*]
   }
  state "MSG sent" as MS
  state "RPC Failed" as RF
  CS-->WAIT:From IDLE /\nCONNECTING
  CS-->WAIT:From Transient\nFailure with\nWait-for-Ready
  WAIT-->CS:State Change 
  CS-->MS: From READY
  CS-->RF: From Permanent failure or\nTransient Failure without\nWait-for-Ready
  MS-->[*]
  RF-->[*]

替代方案

  • 循环(使用指数退避),直到 RPC 停止返回瞬时失败。
    • 为了提高效率,这可以与实现 onReady 处理程序(对于支持此功能的语言)相结合。
  • 接受可能可以通过等待避免的失败,因为您希望快速失败

语言支持

语言示例
JavaJava 示例
GoGo 示例
PythonPython 示例