当前位置：首页 > news >正文

gRPC 核心概念、架构与生命周期

news 2026/4/16 3:36:24

核心概念、架构与生命周期

本文介绍 gRPC 核心概念，并概述 gRPC 架构与 RPC 生命周期。

。有关语言特定细节，请查看你所选语言的快速入门、教程与参考文档。

概述

服务定义

与许多 RPC 系统类似，gRPC 基于定义服务的思想：指定可以被远程调用的方法，以及它们的参数和返回类型。默认情况下，gRPC 使用Protocol Buffers作为Interface Definition Language (IDL)，用于描述服务接口以及消息负载结构。也可以使用其他替代方案。

service HelloService { rpc SayHello (HelloRequest) returns (HelloResponse); } message HelloRequest { string greeting = 1; } message HelloResponse { string reply = 1; }

gRPC 允许你定义四种类型的服务方法：

一元 RPC：客户端发送单个请求，然后得到一个响应，就像普通的函数调用。

rpc SayHello(HelloRequest) returns (HelloResponse);

服务端流式 RPC：客户端发送一个请求，然后获得一个流来读取一系列消息。gRPC 保证单次 RPC 内的消息顺序。

rpc LotsOfReplies(HelloRequest) returns (stream HelloResponse);

客户端流式 RPC：客户端使用一个流写入一系列消息并发送给服务端。客户端写完消息后，会等待服务端读取完成并返回响应。gRPC 同样保证单次 RPC 内的消息顺序。

rpc LotsOfGreetings(stream HelloRequest) returns (HelloResponse);

双向流式 RPC：双方都使用读写流发送一系列消息。这两个流相互独立运行，因此客户端和服务端可以按照任意顺序读写。每个流内部的消息顺序会被保留。

rpc BidiHello(stream HelloRequest) returns (stream HelloResponse);

你将在下面RPC 生命周期部分更详细地了解这些 RPC 类型。

API 使用

从.proto文件中的服务定义开始，gRPC 提供protoc插件，用于生成客户端和服务端代码。gRPC 用户通常在客户端调用这些 API，并在服务端实现对应的 API。

服务端：实现服务中声明的方法，并运行 gRPC 服务器处理客户端调用。gRPC 底层框架负责解码入站请求、执行服务方法、编码服务响应。
客户端：拥有一个名为stub的本地对象（在某些语言中也叫 client），它实现了与服务相同的方法。你可以在客户端直接调用这个本地对象上的方法，这些方法会将参数封装成对应的 Protocol Buffers 消息类型，向服务端发送请求，并接收服务端返回的 Protocol Buffers 响应。

同步与异步

同步 RPC 调用会一直阻塞，直到收到服务端响应，这最接近 RPC 所追求的过程调用抽象。但由于网络本身是异步的，在很多场景下，发起 RPC 而不阻塞当前线程非常有用。

大多数语言中的 gRPC 编程 API 同时提供同步和异步两种形式。具体细节可以参考各语言的教程和参考文档。

RPC 生命周期

本节详细介绍当 gRPC 客户端调用服务端方法时发生的流程。具体实现细节请查阅对应语言的文档。

一元 RPC

先看最简单的 RPC 类型：客户端发送单个请求，获得单个响应。

客户端调用 stub 上的方法后，服务端会收到此次调用的相关通知，包括此次调用的metadata、方法名，以及指定的deadline（如果有）。
服务端可以选择立刻发送回自己的初始 metadata（必须在任何响应之前发送），或者等待客户端的请求消息，具体取决于应用逻辑。
服务端收到客户端的请求消息后，会执行相关逻辑生成并填充响应。响应成功后，服务端会连同状态详情（状态码、可选状态信息）以及可选的trailing metadata一起返回给客户端。
如果响应状态是OK，客户端会收到响应，客户端侧的调用就此完成。