AWS托管.NET Core API如何配置应用空闲超时解决502错误

不需要额外编写自定义全局超时中间件，.NET Core 3 内置的Kestrel Web服务器已经提供了对应的空闲连接超时配置项，你之前测试没观测到应用侧独立超时是测试场景和空闲超时的触发条件不匹配导致的。

核心逻辑说明 #

• 你之前测试的8分钟等待接口属于活跃连接：请求发出后连接一直处于等待后端响应的状态，全程没有出现无数据传输的空闲阶段，所以无论怎么调整ALB超时，都会在ALB的超时阈值触发504，不会触发任何一端的空闲超时规则，这个现象是正常的。
• 间歇性502的根因是连接断连时序不匹配：.NET Core 3 默认Kestrel配置下，连接Keep-Alive空闲超时是2分钟，如果你把ALB的空闲超时设置为大于2分钟的值，当一条复用连接空闲超过2分钟时，Kestrel会主动发送TCP断连包回收连接；如果ALB还没收到这个断连包，就把新请求调度到这条已经被后端关闭的连接上，会直接收到连接拒绝响应，最终给客户端返回502。

内置配置方法 #

只需要把Kestrel的KeepAlive超时配置为严格大于ALB上设置的空闲超时值即可，有两种常用配置方式：

1. 配置文件/环境变量配置（推荐容器化部署场景） #

在appsettings.json中添加Kestrel配置段：

{
  "Kestrel": {
    "Limits": {
      // 示例：ALB空闲超时设为300秒（5分钟）时，此处设置为360秒（6分钟）即可
      "KeepAliveTimeout": "00:06:00",
      // 存在慢请求、大文件上传场景时，建议同步将请求头超时调整为相同值
      "RequestHeadersTimeout": "00:06:00"
    }
  }
}

容器部署时不需要重新构建镜像，直接注入对应环境变量即可覆盖配置：
Kestrel__Limits__KeepAliveTimeout=00:06:00

2. 代码硬编码配置 #

在Program.cs的主机构建阶段直接修改Kestrel限制参数：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseKestrel(serverOptions =>
            {
                // 取值要求大于ALB配置的空闲超时值
                serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(6);
                serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(6);
            });
            webBuilder.UseStartup<Startup>();
        });

验证与额外注意事项 #

• 空闲超时的触发前提是连接上没有任何数据传输，不要用长等待接口测试该配置：正确测试方式是发起一次正常请求后保持TCP连接不释放，等待超过配置的超时阈值后再在该连接上发起新请求，即可观测到应用侧主动断开连接的行为。
• 如果你的Docker镜像内同时打包了Nginx来托管React静态资源、反向代理API请求，需要同步修改Nginx的keepalive_timeout配置，保证该值也大于ALB的空闲超时，否则Nginx提前断开空闲连接一样会触发502。

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