本文系统讲解如何在 .NET 生态中高效构建和使用 gRPC 服务，涵盖 .proto 协议定义、ASP.NET Core 服务托管、强类型客户端生成、通道复用最佳实践及 TLS 安全配置，助开发者快速落地高性能、跨语言的微服务通信。
本文系统讲解如何在 .net 生态中高效构建和使用 grpc 服务，涵盖 `.proto` 协议定义、asp.net core 服务托管、强类型客户端生成、通道复用最佳实践及 tls 安全配置，助开发者快速落地高性能、跨语言的微服务通信。
gRPC 是一种现代、高性能、语言无关的远程过程调用（RPC）框架，其核心优势在于基于 HTTP/2 的双向流支持、Protocol Buffers（Protobuf）默认序列化带来的轻量与高效，以及协定优先（contract-first）的 API 设计范式。在 .NET 平台中，gRPC 与 ASP.NET Core 深度集成，可无缝利用依赖注入（DI）、日志、身份验证、中间件等基础设施能力，成为构建云原生微服务架构的理想选择。
一、定义服务契约：.proto 文件是起点
所有 gRPC 服务均始于一个 .proto 文件，它以 Protobuf v3 语法声明服务接口与数据结构。例如，标准 Greeter 示例：
syntax = "proto3";
package greet;
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply);
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}该文件需置于项目 Protos/ 目录下（如 Protos/greet.proto），并配置 MSBuild 项以启用代码生成：
<ItemGroup> <Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> </ItemGroup>
同时确保已引用 Grpc.AspNetCore（服务端）或 Grpc.Net.Client（客户端）及 Grpc.Tools 工具包。构建时，SDK 将自动生成 GreeterBase（服务基类）、GreeterClient（客户端类型）及 HelloRequest/HelloReply 消息类，实现强类型、零手动序列化。
二、构建服务端：ASP.NET Core 集成
创建 ASP.NET Core gRPC 服务项目（模板名：ASP.NET Core gRPC Service），并在 Program.cs 中注册服务：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddGrpc(); // 启用 gRPC 支持
var app = builder.Build();
app.MapGrpcService<GreeterService>(); // 映射服务端点
app.MapGet("/", () => "Communication with gRPC endpoints is working.");
app.Run();服务实现继承自生成的基类，并可直接注入 ILogger、IConfiguration 等 ASP.NET Core 服务：
public class GreeterService(ILogger<GreeterService> logger) : Greeter.GreeterBase
{
public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
logger.LogInformation("Received greeting request for '{Name}'", request.Name);
return Task.FromResult(new HelloReply { Message = $"Hello, {request.Name}!" });
}
}⚠️ 注意：默认模板启用 HTTPS（TLS），客户端必须使用 https:// 地址访问；若需 HTTP 调试，须显式禁用 TLS 并配置 GrpcChannel.ForAddress("http://...")，且在 .NET Core 3.1+ 中需额外设置 AppContext.SetSwitch("System.Net.Http.SocketsHttpHandler.Http2UnencryptedSupport", true)。
三、构建客户端：通道复用与调用模式
.NET 客户端通过 GrpcChannel 建立与服务的长连接。关键性能原则：通道应被复用，而非每次调用新建。推荐使用 GrpcChannel 的单例或依赖注入方式管理：
// 推荐：注册为 Singleton（Program.cs）
builder.Services.AddSingleton(services =>
{
var channel = GrpcChannel.ForAddress("https://localhost:7042", new GrpcChannelOptions
{
HttpHandler = new SocketsHttpHandler
{
EnableMultipleHttp2Connections = true // 突破单连接并发流限制（默认100）
}
});
return channel;
});
// 使用时注入
public class GreetingService
{
private readonly Greeter.GreeterClient _client;
public GreetingService(GrpcChannel channel)
=> _client = new Greeter.GreeterClient(channel);
public async Task<string> GetGreetingAsync(string name)
{
var reply = await _client.SayHelloAsync(new HelloRequest { Name = name });
return reply.Message;
}
}gRPC 支持四种调用模式：
- 一元（Unary）：rpc SayHello(...) returns (...) —— 最常用，请求-响应一次完成；
- 服务器流（Server Streaming）：rpc ListFeatures(...) returns (stream Feature)；
- 客户端流（Client Streaming）：rpc RecordRoute(stream Point) returns (RouteSummary)；
- 双向流（Bidirectional Streaming）：rpc RouteChat(stream RouteNote) returns (stream RouteNote)。
每种模式均有对应的异步方法（如 SayHelloAsync, ListFeaturesAsync）及流式处理 API（AsyncStreamReader<T> / IServerStreamWriter<T>）。
四、高级注意事项与最佳实践
- TLS 配置：生产环境务必使用 HTTPS。若需客户端证书认证，可通过 GrpcChannelOptions.Credentials 设置 SslCredentials。
- 大消息处理：默认消息大小限制为 4MB。如需传输大文件，需在 GrpcChannelOptions 和服务端 KestrelServerOptions.Limits.MaxRequestBodySize 中同步调高 MaxReceiveMessageSize 与 MaxSendMessageSize。
-
性能优化：
- 复用 GrpcChannel（线程安全，可创建多个客户端）；
- 启用 EnableMultipleHttp2Connections = true 避免高并发流排队；
- 在 .NET 6+ 中，考虑使用 GrpcChannel 的工厂模式（AddGrpcClient + DI）实现自动生命周期管理；
- 调试与测试：使用 grpcurl 或 gRPCui 工具直接调用 .proto 定义的服务，无需编写客户端代码，加速 API 验证。
综上，.NET 的 gRPC 实现不仅提供了开箱即用的高性能通信能力，更通过深度集成 ASP.NET Core 生态，显著降低了微服务开发与运维复杂度。从契约定义、服务实现、客户端调用到生产调优，全程遵循现代云原生工程实践，是构建低延迟、高吞吐分布式系统的坚实基础。
