如何在同一HostBuilder中配置FunctionsWebApplication与WebHost

你遇到的核心冲突是：ConfigureFunctionsWebApplication已经为Azure Functions封装了完整的WebHost配置逻辑，直接调用ConfigureWebHost会覆盖或干扰Functions运行时的初始化流程，导致代理无法正确转发请求到Functions工作进程。

要在Azure Functions应用中同时运行gRPC服务，需要将gRPC的配置整合到Functions的Web应用管道中，而不是单独配置WebHost。以下是调整后的实现方案：

关键修改点 #

• 移除独立的ConfigureWebHost调用：所有Web相关配置（包括gRPC）都通过ConfigureFunctionsWebApplication的回调完成
• Kestrel需同时支持HTTP/1.1和HTTP/2：Azure Functions依赖HTTP/1.1处理请求，gRPC需要HTTP/2，因此不能只绑定HTTP/2端点
• 整合gRPC到Functions的请求管道：在Functions的应用配置中添加gRPC服务和端点映射

修改后的完整代码 #

IHost host = new HostBuilder()
    .ConfigureFunctionsWebApplication(builder =>
    {
        // 原有的Functions JSON配置
        builder.Services.Configure<JsonSerializerOptions>(options =>
        {
            options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
        });

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

        // 整合gRPC到请求管道
        builder.Configure(app =>
        {
            // 保留Functions默认的管道中间件
            var functionsEndpointRouteBuilder = app.UseFunctionsEndpoint();
            
            // 添加gRPC的路由和端点映射
            app.UseRouting();
            app.UseEndpoints(endpoints =>
            {
                endpoints.MapGrpcService<GreeterService>();
                // 确保Functions的端点也能正常工作
                functionsEndpointRouteBuilder.MapEndpoints(endpoints);
            });
        });
    })
    .ConfigureAppConfiguration((hostContext, configuration) =>
    {
        configuration.SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", true, false)
            .AddJsonFile($"appsettings.{hostContext.HostingEnvironment.EnvironmentName}.json", true, false)
            .AddJsonFile("local.settings.json", true, false)
            .AddEnvironmentVariables();
    })
    .ConfigureServices((hostContext, services) =>
    {
        services.AddGrpcClient<Greeter.GreeterClient>(options =>
        {
            options.Address = new Uri("https://localhost:7293");
        });
        services.AddApplicationInsightsTelemetryWorkerService();
        services.ConfigureFunctionsApplicationInsights();

        IConfiguration configuration = hostContext.Configuration;
        services
            .AddBindings()
            .AddConfig(configuration)
            .AddAutoMapper(typeof(Program));
    })
    .ConfigureServices((hostContext, services) =>
    {
        // 配置Kestrel同时支持HTTP/1.1和HTTP/2
        services.Configure<KestrelServerOptions>(options =>
        {
            // 监听一个同时支持HTTP/1.1和HTTP/2的端点（用于Functions和gRPC）
            options.ListenLocalhost(7105, o => o.Protocols = HttpProtocols.Http1AndHttp2);
            // 可选：单独监听一个纯HTTP/2端点专门用于gRPC
            options.ListenLocalhost(7293, o => o.Protocols = HttpProtocols.Http2);
        });
    })
    .Build();

host.Run();

额外说明 #

• 端口配置：确保Functions的默认端口（通常是7071）或你指定的端口支持HTTP/1.1，gRPC可以用另一个HTTP/2端口，或者同一个端口同时支持双协议
• 本地调试注意事项：如果使用Azure Functions Core Tools，需要确保工具的代理能正确转发请求到你的应用进程
• 生产环境部署：在Azure上部署时，需要确保Function App的配置允许HTTP/2，并且gRPC的端点路径不会和Functions的触发器路径冲突

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