ASP.NET 6 Code First gRPC跨服务调用失败，如何正确实现？

错误原因 #

你使用了普通的AddGrpcClient注册Code First风格的gRPC客户端，但该方法仅适用于.proto文件生成的客户端代理。Code First模式需要专门的注册方法来为[ServiceContract]标记的接口生成代理实例，否则DI容器无法找到接口的实现，从而抛出构造函数找不到的异常。

正确实现步骤 #

1. 确保NuGet包引用正确

• 共享类库：安装Grpc.AspNetCore（包含Code First所需的服务端/客户端基础组件）
• 接收端（服务端）：安装Grpc.AspNetCore
• 发送端（客户端）：安装Grpc.AspNetCore.Client和Grpc.AspNetCore

2. 验证共享项目中的接口与数据类

确保接口和数据类的特性标记完整且正确，尤其是字段顺序（gRPC序列化依赖明确的顺序）：

// 数据请求类
[DataContract]
public class GrpcRegisterUserRequest
{
    [DataMember(Order = 1)]
    public string Username { get; set; }

    [DataMember(Order = 2)]
    public string Password { get; set; }
}

// 数据响应类
[DataContract]
public class GrpcRegisterUserResponse
{
    [DataMember(Order = 1)]
    public bool Success { get; set; }

    [DataMember(Order = 2)]
    public string Message { get; set; }
}

// gRPC服务接口
[ServiceContract]
public interface IGrpcUserHandlingService
{
    [OperationContract]
    Task<GrpcRegisterUserResponse> RegisterAtServerAsync(GrpcRegisterUserRequest request);
}

3. 接收端（服务端）配置

在Program.cs中注册并映射gRPC服务：

var builder = WebApplication.CreateBuilder(args);

// 启用HTTP/2（gRPC默认依赖）
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5001, o => o.Protocols = HttpProtocols.Http2);
});

// 注册gRPC服务
builder.Services.AddGrpc();

var app = builder.Build();

// 映射gRPC服务端点
app.MapGrpcService<UserHandlingService>(); // UserHandlingService是IGrpcUserHandlingService的实现类

app.MapGet("/", () => "gRPC服务仅支持gRPC客户端调用");

app.Run();

4. 发送端（客户端）配置

在Program.cs中使用Code First专用的注册方法添加gRPC客户端：

var builder = WebApplication.CreateBuilder(args);

// 注册Code First风格的gRPC客户端
builder.Services.AddCodeFirstGrpcClient<IGrpcUserHandlingService>(options =>
{
    // 替换为接收端服务的实际地址
    options.Address = new Uri("https://localhost:5001");
});

// 注册你的UserService（依赖注入IGrpcUserHandlingService）
builder.Services.AddScoped<UserService>();

var app = builder.Build();

// 其他中间件配置...

app.Run();

5. 客户端调用实现

在UserService中正常依赖注入并调用gRPC方法：

public class UserService
{
    private readonly IGrpcUserHandlingService _grpcClient;

    // 依赖注入自动获取Code First生成的代理实例
    public UserService(IGrpcUserHandlingService grpcClient)
    {
        _grpcClient = grpcClient;
    }

    public async Task<bool> RegisterUser(string username, string password)
    {
        var request = new GrpcRegisterUserRequest
        {
            Username = username,
            Password = password
        };

        var response = await _grpcClient.RegisterAtServerAsync(request);
        return response.Success;
    }
}

关键注意点 #

• 必须使用AddCodeFirstGrpcClient而非AddGrpcClient来注册Code First风格的gRPC客户端
• 数据类的[DataMember]必须指定Order属性，否则gRPC序列化会失败
• 服务端必须启用HTTP/2协议，gRPC默认不支持HTTP/1.1

内容的提问来源于stack exchange，提问作者user3079834