在现有ASP.NET Core 7项目中配置gRPC与HTTP端点共存的问题

问题根源 #

核心矛盾是非HTTPS的HTTP/1.1旧API与依赖HTTP/2的gRPC服务无法共存，加上中间件顺序错误，导致协议匹配失败、CORS校验异常等问题。

具体解决方案 #

1. 配置Kestrel同时支持HTTP/1.1和HTTP/2

在Startup.cs的ConfigureServices方法中添加Kestrel配置，让服务器在非HTTPS端口同时处理两种协议：

public void ConfigureServices(IServiceCollection services)
{
    // 保留原有服务配置（如Controllers、Swagger等）
    
    // 配置Kestrel兼容HTTP/1.1和HTTP/2
    services.Configure<KestrelServerOptions>(options =>
    {
        options.ListenAnyIP(5010, listenOptions =>
        {
            listenOptions.Protocols = HttpProtocols.Http1AndHttp2;
        });
    });

    // 注册gRPC服务
    services.AddGrpc();
}

2. 调整中间件顺序与CORS配置

修改Configure方法，修正中间件顺序并适配gRPC的CORS需求：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
        // 开发环境关闭HTTPS重定向，避免旧API被强制跳转
        // app.UseHttpsRedirection();
    }
    // 生产环境若需保留HTTPS重定向，可根据业务场景调整
    // else { app.UseHttpsRedirection(); }

    app.UseOpenApi();
    app.UseSwaggerUi3(c => {
        c.OAuth2Client = new NSwag.AspNetCore.OAuth2ClientSettings() { ClientId = null, ClientSecret = null };
    });

    // CORS中间件必须放在UseRouting之前，确保所有请求（含gRPC）都经过校验
    app.UseCors(c => {
        c.AllowAnyOrigin();
        c.AllowAnyMethod();
        c.AllowAnyHeader();
        // 暴露gRPC专属响应头部，避免客户端CORS校验失败
        c.WithExposedHeaders("Grpc-Status", "Grpc-Message", "Grpc-Encoding", "Grpc-Accept-Encoding");
    });

    app.UseRouting();

    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapGrpcService<StateStoreService>();
        if (env.IsDevelopment())
            endpoints.MapGrpcReflectionService();
        endpoints.MapControllers();
    });
}

3. 客户端调用适配

• grpcurl调用：明确指定非TLS模式，若仍超时可强制指定HTTP/2：

  ./grpcurl -plaintext -http2 localhost:5010 data_provider_service.v1.StateStore/ReadStates
  

• Insomnia调用：选择gRPC请求类型，关闭TLS选项，请求地址使用http://localhost:5010而非HTTPS。

关键说明 #

• Kestrel的Http1AndHttp2配置是核心，让服务器能根据请求自动适配协议，同时满足旧API和gRPC的需求。
• CORS中间件前置到UseRouting之前，可避免gRPC请求绕过校验；暴露gRPC专属头部是为了让客户端正常解析响应。
• 开发环境关闭HTTPS重定向是为了兼容旧API的非HTTPS访问，生产环境可根据部署情况调整。

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