在微服务架构中,服务之间的高效通信至关重要。.NET 中集成 gRPC 能够实现高性能、跨语言的服务间调用。gRPC 基于 HTTP/2 协议,使用 Protocol Buffers 作为接口定义语言(IDL),天然适合内部服务通信。下面介绍如何在 .NET 项目中配置和使用 gRPC 进行服务间通信。
创建 gRPC 服务项目
使用 .NET CLI 快速搭建 gRPC 服务:
执行命令 dotnet new grpc -n MyGrpcService 创建新的 gRPC 服务项目 项目会自动生成 proto 文件(如 greet.proto)和对应的 Service 类 proto 文件定义了服务接口和消息结构,是客户端与服务端的契约确保项目已引用 Grpc.AspNetCore 包,这是运行 gRPC 服务所必需的。
定义和编译 proto 接口
修改或新增 .proto 文件来定义你的服务。例如:
syntax = "proto3";
option csharp_namespace = "MyGrpcService";
package greet;
service Greeter {
rpc SayHello (HelloRequest) returns (HelloReply);
}
message HelloRequest {
string name = 1;
}
message HelloReply {
string message = 1;
}
在项目文件(.csproj)中配置 protobuf 编译:
<ItemGroup> <Protobuf Include="Protos\greet.proto" GrpcServices="Server" /> </ItemGroup>GrpcServices="Server" 表示生成服务端基类;若用于客户端,则设为 "Client" 或 "Both"。
实现 gRPC 服务逻辑
继承由 proto 生成的基类,实现具体业务逻辑:
public class GreeterService : Greeter.GreeterBase
{
public override Task<HelloReply> SayHello(HelloRequest request, ServerCallContext context)
{
return Task.FromResult(new HelloReply
{
Message = $"Hello, {request.Name}"
});
}
}
将服务注册到依赖注入容器:
builder.Services.AddGrpc();
并启用 gRPC 端点:
app.MapGrpcService<GreeterService>();
配置客户端调用 gRPC 服务
在调用方项目中添加对 proto 文件的引用,并配置生成客户端代码:
<ItemGroup> <Protobuf Include="..\MyGrpcService\Protos\greet.proto" GrpcServices="Client" /> </ItemGroup>
通过 GrpcChannel 创建客户端实例:
var channel = GrpcChannel.ForAddress("https://localhost:5001");
var client = new Greeter.GreeterClient(channel);
var reply = await client.SayHelloAsync(new HelloRequest { Name = "Alice" });
Console.WriteLine(reply.Message);
</p>
推荐将客户端注册为依赖项以支持依赖注入:
builder.Services.AddSingleton<Greeter.GreeterClient>(sp =>
{
var channel = GrpcChannel.ForAddress("https://localhost:5001");
return new Greeter.GreeterClient(channel);
});
基本上就这些。只要 proto 定义一致,.NET 服务之间就能高效通信。注意确保服务地址可达,HTTPS 配置正确,特别是在生产环境中。 