如何在IIS上优雅关闭ASP.NET WebApi（4.72）应用？

针对ASP.NET 4.7.2 WebApi在IIS环境下的优雅关闭需求，以下是几种实用方案：

一、利用IIS应用池的原生优雅回收机制 #

IIS应用池本身支持优雅关闭逻辑，核心是给正在处理的请求留足完成时间，同时拒绝新请求：

• 图形界面配置：打开IIS管理器，找到目标应用池→右键「高级设置」→在「进程模型」下调整「关闭时间限制」（默认90秒，可根据业务请求时长调整）。触发回收时，IIS会在超时时间内等待现有请求完成，之后终止进程。
• 命令行触发：用appcmd工具执行回收命令，比手动停止更可控：

  appcmd recycle apppool /apppool.name:"你的应用池名称"
  

  该命令会触发应用池优雅回收，自动处理请求收尾。

二、代码层面实现自定义优雅关闭逻辑 #

通过ASP.NET的IRegisteredObject接口，可以在关闭前执行自定义清理逻辑（如等待请求完成、释放资源）：

1. 在Global.asax中注册关闭处理器：

   protected void Application_Start()
   {
       HostingEnvironment.RegisterObject(new GracefulShutdownHandler());
   }
   

2. 实现关闭处理器类：

   public class GracefulShutdownHandler : IRegisteredObject
   {
       public void Stop(bool immediate)
       {
           if (immediate)
           {
               HostingEnvironment.UnregisterObject(this);
               return;
           }
   
           // 1. 等待正在处理的请求完成（需自行实现请求计数逻辑）
           WaitForPendingRequests();
           // 2. 清理资源：关闭数据库连接池、释放文件句柄等
           CleanupCriticalResources();
   
           HostingEnvironment.UnregisterObject(this);
       }
   
       private void WaitForPendingRequests()
       {
           // 示例：用计数器统计活跃请求，等待计数器归0（需设置超时，避免无限等待）
           int timeout = 30000; // 30秒超时
           while (ActiveRequestCount > 0 && timeout > 0)
           {
               Thread.Sleep(100);
               timeout -= 100;
           }
       }
   
       private void CleanupCriticalResources()
       {
           // 这里添加你的资源清理代码
           // 比如：SqlConnection.ClearAllPools();
       }
   }
   

3. 触发关闭：可以新增一个仅限内部访问的接口，调用HostingEnvironment.InitiateShutdown()触发优雅关闭流程，注意做好权限验证（如IP白名单）。

三、运维脚本结合的分步关闭方案 #

如果是数据库备份恢复后的批量操作，用PowerShell脚本分步执行更高效：

# 1. 暂停网站，拒绝新请求
Stop-Website -Name "你的网站名称"
# 2. 等待现有请求处理完成（时长根据业务调整）
Start-Sleep -Seconds 30
# 3. 停止应用池
Stop-AppPool -Name "你的应用池名称"

这种方式先阻断新请求，再给现有请求留足处理时间，最后终止应用池，避免强制中断导致的数据异常。

注意事项 #

• 调整应用池的「关闭时间限制」时，要覆盖业务中最长请求的处理时长，避免提前终止进程。
• 自定义清理逻辑必须设置超时，防止因异常导致关闭流程卡住。
• 内部关闭接口一定要做权限控制，禁止外部访问。

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