Azure App Service Linux容器中gRPC与REST共存配置问题

我已遵循Azure App Service的gRPC基础设置指南，但测试gRPC端点时始终收到502 Bad Gateway响应，而REST接口可正常访问。找到的示例均仅包含gRPC端点，未涉及二者共存配置。

本地环境中，我通过以下代码明确设置监听端口，可正常运行（REST在5025端口使用HTTP1，gRPC在5026端口使用HTTP2）：

if (app.Environment.IsDevelopment())
{
    builder.WebHost.ConfigureKestrel(options =>
    {
        options.ListenAnyIP(5025, opts => opts.Protocols = HttpProtocols.Http1 );
        options.ListenAnyIP(5026, opts => opts.Protocols = HttpProtocols.Http2 );
    });
}

但据我了解，部署到生产环境时应通过Azure App Service控制配置。我对其环境变量和设置经验不足，此前该应用仅运行REST接口，未配置过明确端口。

应用以容器形式构建，配置如下（配合dotnet publish ... /t:PublishContainer命令）：

<PropertyGroup>
    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
    <EnableSdkContainerDebugging>True</EnableSdkContainerDebugging>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/aspnet:9.0</ContainerBaseImage>
    <ContainerRepository>app-name</ContainerRepository>
</PropertyGroup>
<ItemGroup>
    <ContainerEnvironmentVariable Include="ASPNETCORE_HTTPS_PORTS">
        <Value>8081</Value>
    </ContainerEnvironmentVariable>
</ItemGroup>

若将Kestrel默认配置为HTTP2，REST接口无法正常工作（我使用Postman测试）；配置为Http1AndHttp2时同样如此。

gRPC服务已通过app.MapGrpcService<MyGrpcService>()的标准方式在Program.cs中添加。

请问是否可在单个端口实现gRPC与REST共存，还是必须使用两个不同端口分别对应gRPC和REST？

可以单端口实现REST与gRPC共存 #

.NET的Kestrel服务器支持在单个端口同时处理HTTP/1.1（REST）和HTTP/2（gRPC）请求，解决502错误的核心是确保HTTP/2流量能正确到达应用容器，同时让REST请求仍以HTTP/1.1正常交互。

具体配置步骤 #

1. 调整Kestrel生产环境配置
   不要仅在开发环境配置端口，修改Program.cs让生产环境也启用双协议支持：

   builder.WebHost.ConfigureKestrel(options =>
   {
       var httpsPort = int.Parse(Environment.GetEnvironmentVariable("ASPNETCORE_HTTPS_PORTS") ?? "8081");
       options.ListenAnyIP(httpsPort, opts =>
       {
           opts.Protocols = HttpProtocols.Http1AndHttp2;
           // Azure App Service会处理SSL终止，容器内无需额外配置证书
       });
   });
   

   也可通过appsettings.json配置（更灵活，无需硬编码）：

   "Kestrel": {
       "Endpoints": {
           "Https": {
               "Url": "https://+:8081",
               "Protocols": "Http1AndHttp2"
           }
       }
   }
   

2. Azure App Service关键设置

   • 进入应用服务的配置 > 常规设置，将“HTTP版本”设置为2.0（或支持双版本的选项，部分界面显示为1.1 and 2.0），确保Azure会转发HTTP/2流量到容器。
   • 检查容器设置，确认端口映射与容器内ASPNETCORE_HTTPS_PORTS的8081一致。
   • 启用强制HTTPS（gRPC要求HTTPS，除本地开发场景），在配置 > TLS/SSL设置中开启该选项。

3. 排查REST接口失效问题
   配置Http1AndHttp2后REST失效，大概率是测试工具的问题：

   • 检查Postman是否误将请求协议改为HTTP/2，切换回HTTP/1.1重试。
   • 确认REST接口路由未与gRPC路由冲突（gRPC路由通常以.proto定义的服务名开头，不易冲突，但需排查）。

双端口备选方案 #

如果单端口配置遇到难以排查的问题，也可以采用双端口方案：

• 在容器内配置Kestrel监听两个端口（如8080用于HTTP/1.1 REST，8081用于HTTP/2 gRPC）。
• 在Azure App Service的容器设置中添加两个端口映射。
• 注意gRPC端口必须使用HTTPS，可通过Azure配置SSL终止。

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