.NET Core聚合WebAPI调用gRPC服务的通道与客户端创建策略

咱们先把gRPC通道和客户端的本质搞明白，再聊哪种注入策略更合适：

1. gRPC通道：必须单例复用，启动时创建是正确策略 #

gRPC通道是重量级、线程安全的对象，它背后管理着TCP连接池、TLS握手、重试策略等核心资源，创建成本非常高。如果每次请求都新建通道，会导致大量重复的TCP连接建立/销毁，不仅延迟飙升，还会严重消耗服务器资源。

所以你现在在启动时将通道注册为单例的做法完全正确，这是官方推荐的最佳实践。示例代码大概是这样：

services.AddSingleton(provider =>
{
    // 可以自定义HttpClientHandler来配置代理、证书验证等
    var handler = new HttpClientHandler();
    var httpClient = new HttpClient(handler);
    
    return GrpcChannel.ForAddress("https://your-grpc-service-endpoint", new GrpcChannelOptions
    {
        HttpClient = httpClient,
        // 可以添加超时、重试等配置
        Deadline = TimeSpan.FromSeconds(30)
    });
});

2. gRPC客户端：轻量级对象，按需创建（推荐Scoped）更灵活 #

gRPC客户端本质上是通道的轻量级包装器，它本身不持有任何持久化资源，而且是线程安全的。那到底该注册为单例还是按需创建？

• 如果你的客户端是完全无状态的（不需要针对每个请求修改元数据、超时等），单例也能正常工作，但更推荐注册为Scoped（请求生命周期）：
  • 一方面，Scoped和Web API的请求周期对齐，方便在每个请求中动态设置客户端的参数（比如添加授权Token到元数据）；
  • 另一方面，客户端本身创建成本极低，Scoped不会带来任何性能负担。

示例代码：

// 注册Scoped的gRPC客户端
services.AddScoped<YourGrpcService.YourGrpcServiceClient>(provider =>
{
    var channel = provider.GetRequiredService<GrpcChannel>();
    var client = new YourGrpcService.YourGrpcServiceClient(channel);
    
    // 如果需要给每个请求添加元数据，可以在这里处理
    var httpContext = provider.GetRequiredService<IHttpContextAccessor>();
    var token = httpContext.HttpContext.Request.Headers["Authorization"].FirstOrDefault();
    if (!string.IsNullOrEmpty(token))
    {
        client.CallOptions = client.CallOptions.WithHeaders(new Metadata { { "Authorization", token } });
    }
    
    return client;
});

3. 绝对不要做的事：按需创建并关闭通道 #

如前所述，通道的创建成本极高，频繁创建销毁通道会直接把性能拉垮，这是严重的反模式，一定要避免。

额外注意点 #

• 通道的健康监测：可以利用gRPC的健康检查服务，定期验证通道状态，避免使用失效的通道；
• 配置变更：如果你的gRPC服务地址可能动态变化，可以考虑用工厂模式来管理通道的创建与刷新，但这种场景比较少见，大部分情况下固定地址的单例通道足够用。

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