C# 的 gRPC 基于 Google 的 gRPC 框架,使用 Protocol Buffers 和 HTTP/2,支持四种调用模式,通过 Grpc.AspNetCore 和 Grpc.Net.Client 实现高效通信,需复用 Channel、启用压缩与异步处理以提升性能。
C# 的 gRPC 是基于 Google 开发的 gRPC 高性能远程过程调用(RPC)框架在 .NET 平台上的实现。它使用 Protocol Buffers 作为接口定义语言(IDL),并默认通过 HTTP/2 进行通信,具备强类型、跨语言、低延迟和高吞吐量的特点。C# 中使用 gRPC 能够构建轻量级、高效的微服务通信系统,特别适合服务间需要高性能交互的场景。
在使用 gRPC 前,先掌握几个关键组件:
以下是使用 C# 构建 gRPC 服务的基本流程,兼顾性能与可维护性。
1. 创建 .proto 文件定义服务
在项目中添加 .proto 文件,例如 helloworld.proto:
syntax = "proto3";option csha
rp_namespace = "HelloWorld";
package greet;
// 定义服务 service Greeter { rpc SayHello (HelloRequest) returns (HelloReply); }
// 请求与响应消息 message HelloRequest { string name = 1; }
message HelloReply { string message = 1; }
2. 配置项目以支持 gRPC
在服务端项目(通常是 ASP.NET Core Web API)中引入 NuGet 包:
在 Program.cs 中启用 gRPC:
var builder = WebApplication.CreateBuilder(args);// 添加 gRPC 服务 builder.Services.AddGrpc();
var app = builder.Build();
app.MapGrpcService
(); app.MapGet("/", () => "Communication with gRPC endpoints must be made through a gRPC client."); app.Run();
3. 实现服务类
创建继承自生成的基类的服务实现:
public class GreeterService : Greeter.GreeterBase
{
public override Task 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);
var reply = await client.SayHelloAsync(new HelloRequest { Name = "Alice" });
Console.WriteLine(reply.Message);
要充分发挥 gRPC 的高性能优势,需注意以下几点:
GrpcChannel 应长期持有,避免频繁创建销毁。gRPC 不像 REST 接口那样容易用浏览器测试,建议:
基本上就这些。C# 的 gRPC 让你在 .NET 生态中轻松构建高效、类型安全的服务通信,只要合理设计接口、利用异步和流式特性,就能支撑高并发微服务架构。