Azure App Service中启动超时后如何优雅关闭ASP.NET Core应用？

核心原因 #

Azure App Service的WEBSITES_CONTAINER_START_TIME_LIMIT是容器启动阶段的超时阈值，一旦触发，平台会直接发送SIGKILL强制终止容器，不会走正常的SIGTERM优雅停止流程——这和运行时主动停止应用的逻辑完全不同。

可行解决方案 #

1. 调整启动超时阈值（优先尝试） #

如果初始化操作时长可预估，直接增大WEBSITES_CONTAINER_START_TIME_LIMIT的取值：

• 在Azure门户的App Service配置页，进入常规设置，找到启动时间限制，调整为合适数值（最大支持1800秒，即30分钟）
• 或通过Azure CLI设置：

  az webapp config set --name <你的应用名> --resource-group <资源组名> --startup-time-limit 1800
  

2. 拆分初始化流程，避免阻塞启动 #

把非关键初始化逻辑移到应用启动完成后执行：

• 保留必须的初始化逻辑在IHostedService的StartAsync中，确保这部分能在超时阈值内完成
• 将非紧急的初始化任务放到后台队列，在应用启动后异步执行，比如用BackgroundService结合任务队列，或在第一个请求触发时执行（需处理并发问题）

3. 利用预热实例（针对生产环境） #

若应用使用高级或隔离层，可开启预热实例功能：

• 在App Service的缩放设置中配置预热实例，平台会在实例接入流量前完成初始化，即使耗时较长，也不会触发启动超时终止

4. 自定义健康检查配合启动超时 #

实现自定义健康检查，让Azure App Service识别应用是否完成初始化：

• 在ASP.NET Core中添加健康检查端点，初始化完成前返回不健康状态，完成后返回健康
• 在App Service的监控配置中设置健康检查，平台会等待健康检查通过后才认定启动完成，此时即使初始化时间超过阈值，也不会直接终止

注意事项 #

• 本地测试的SIGTERM场景是运行时停止，和启动超时的终止逻辑完全不同，所以本地有效不代表Azure平台会走同样流程
• 不要依赖启动超时阶段的SIGTERM，当前平台设计就是启动超时直接发送SIGKILL

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