.NET如何使用gRPC进行服务间通信_gRPC服务通信配置指南

来源:这里教程网 时间:2026-02-21 17:29:06 作者:

在微服务架构中,服务之间的高效通信至关重要。.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 配置正确,特别是在生产环境中。

相关推荐