如何让启用gRPC-Web的ASP.NET Core服务同时支持HTTP/2调用？

问题根源分析 #

你遇到的错误是因为全局启用了UseGrpcWeb中间件，该中间件会强制所有gRPC请求走gRPC-Web的HTTP/1.x处理逻辑，破坏了HTTP/2的原生gRPC握手流程，导致原生客户端调用失败。

方案一：同一端口同时支持两种协议（推荐） #

不需要端口分离，只需调整中间件和路由配置，让服务自动根据请求特征区分处理：

修改后的Program.cs代码：

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

// 保留原有gRPC服务注册
builder.Services.AddGrpc();
builder.Services.AddGrpcReflection();

WebApplication app = builder.Build();

// 移除全局的app.UseGrpcWeb()！
// 仅对目标服务启用gRPC-Web支持，同时保留原生HTTP/2处理能力
app.MapGrpcService<UsersService>().EnableGrpcWeb();

// 保留反射服务
app.MapGrpcReflectionService();

app.Run();

原理说明

EnableGrpcWeb()扩展方法会为该服务路由添加gRPC-Web支持，但不会干扰原生gRPC请求：

• 当请求来自.NET/Postman等原生客户端（使用HTTP/2、无grpc-web请求头），服务会按原生gRPC逻辑响应
• 当请求来自Blazor WASM等浏览器客户端（使用HTTP/1.x、携带grpc-web请求头），服务会自动切换为gRPC-Web处理模式

方案二：端口分离（可选，适用于特殊隔离需求） #

如果需要严格区分协议端口，可以通过Kestrel配置多个终结点，分别处理原生gRPC和gRPC-Web请求：

修改后的Program.cs代码：

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

// 配置Kestrel多端口：一个用于HTTP/2原生gRPC，一个用于HTTP/1.x gRPC-Web
builder.WebHost.ConfigureKestrel(options =>
{
    // 原生gRPC端口，仅启用HTTP/2
    options.ListenAnyIP(5000, o => o.Protocols = HttpProtocols.Http2);
    // gRPC-Web端口，仅启用HTTP/1.x
    options.ListenAnyIP(5001, o => o.Protocols = HttpProtocols.Http1);
});

builder.Services.AddGrpc();
builder.Services.AddGrpcReflection();

WebApplication app = builder.Build();

// 绑定原生gRPC到5000端口，无需启用gRPC-Web
app.MapGrpcService<UsersService>().RequireHost("*:5000");

// 绑定gRPC-Web到5001端口，启用gRPC-Web支持
app.MapGrpcService<UsersService>()
   .EnableGrpcWeb()
   .RequireHost("*:5001");

app.MapGrpcReflectionService();

app.Run();

使用方式

• 原生客户端（.NET/Postman）通过https://localhost:5000调用HTTP/2 gRPC
• Blazor WASM客户端通过https://localhost:5001调用HTTP/1.x gRPC-Web

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