<p>C# 的 grpc 基于 google 的 gRPC 框架，使用 Protocol Buffers 和 http/2，支持四种调用模式，通过 Grpc.As.netCore 和 Grpc.Net.Client 实现高效通信，需复用 channel、启用压缩与异步处理以提升性能。</p>

C# 的 gRPC 是基于 google 开发的 gRPC 高性能远程过程调用（RPC）框架在 .NET 平台上的实现。它使用 Protocol Buffers 作为接口定义语言（IDL），并默认通过 HTTP/2 进行通信，具备强类型、跨语言、低延迟和高吞吐量的特点。C# 中使用 gRPC 能够构建轻量级、高效的微服务通信系统，特别适合服务间需要高性能交互的场景。

理解 C# 中的 gRPC 核心概念

在使用 gRPC 前，先掌握几个关键组件：

• Protocol Buffers (.proto 文件)：定义服务接口和消息结构。编译后会生成 C# 类和服务基类/客户端类。
• gRPC 服务类型：支持四种模式——一元调用（Unary）、服务器流（Server streaming）、客户端流（Client streaming）、双向流（Bidirectional streaming）。
• Kestrel 服务器：ASP.NET Core 默认使用的高性能服务器，天然支持 HTTP/2，是承载 gRPC 服务的理想选择。
• Grpc.AspNetCore 包：提供服务端支持，集成到 ASP.NET Core 管道中。
• Grpc.Net.Client 包：用于 C# 客户端调用 gRPC 服务。

构建一个高性能 gRPC 服务的步骤

以下是使用 C# 构建 gRPC 服务的基本流程，兼顾性能与可维护性。

1. 创建 .proto 文件定义服务

在项目中添加 .proto 文件，例如 helloworld.proto：

syntax = "proto3"; <p>option csharp_namespace = "HelloWorld";</p><p>package greet;</p><p>// 定义服务 service Greeter { rpc SayHello (HelloRequest) returns (HelloReply); }</p><p>// 请求与响应消息 message HelloRequest { string name = 1; }</p><p>message HelloReply { string message = 1; } 

2. 配置项目以支持 gRPC

在服务端项目（通常是 ASP.NET Core Web API）中引入 NuGet 包：

<PackageReference Include="Grpc.AspNetCore" Version="2.57.0" /> 

在 Program.cs 中启用 gRPC：

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

37

查看详情

var builder = Webapplication.CreateBuilder(args); <p>// 添加 gRPC 服务 builder.Services.AddGrpc();</p><p>var app = builder.Build();</p><p>app.MapGrpcService<GreeterService>(); app.MapGet("/", () => "Communication with gRPC endpoints must be made through a gRPC client.");</p><p>app.Run(); 

3. 实现服务类

创建继承自生成的基类的服务实现：

public class GreeterService : Greeter.GreeterBase {     public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)     {         return Task.FromResult(new HelloReply         {             Message = $"Hello, {request.Name}"         });     } } 

4. 客户端调用 gRPC 服务

在客户端项目中安装 Grpc.Net.Client 和共享的 .proto 文件或引用服务模型。

using var channel = GrpcChannel.ForAddress("https://localhost:7249"); var client = new Greeter.GreeterClient(channel); <p>var reply = await client.SayHelloAsync(new HelloRequest { Name = "Alice" }); Console.WriteLine(reply.Message); 

提升 gRPC 性能的关键实践

要充分发挥 gRPC 的高性能优势，需注意以下几点：

• 使用 HTTP/2：确保服务器使用 Kestrel 并配置为 HTTPS（HTTP/2 要求 TLS），避免降级到 HTTP/1.1。
• 减少消息大小：Protocol Buffers 已高效，但仍应避免传输冗余字段，合理设计消息结构。
• 复用 Channel：gRPC 客户端的 GrpcChannel 应长期持有，避免频繁创建销毁。
• 启用压缩：对大消息可启用 Gzip 压缩，在服务端和客户端配置压缩策略。
• 异步处理：服务方法全部使用 async/await，避免阻塞线程，提升并发能力。
• 流式调用优化：对于实时数据推送（如日志、通知），使用服务器流或双向流减少连接开销。

调试与测试注意事项

gRPC 不像 REST 接口那样容易用浏览器测试，建议：

• 使用 BloomRPC 或 gRPcurl 等工具进行手动测试。
• 在开发时启用日志输出，查看调用详情和性能瓶颈。
• 编写单元测试和集成测试，模拟客户端调用服务逻辑。

基本上就这些。C# 的 gRPC 让你在 .NET 生态中轻松构建高效、类型安全的服务通信，只要合理设计接口、利用异步和流式特性，就能支撑高并发微服务架构。