如何在IIS或应用程序池重启后自动初始化/唤醒C# WebAPI，确保后台作用域服务持续运行

我完全理解你的困扰——依赖外部请求才能唤醒API，导致后台任务中断，确实不是个优雅的解决方案。咱们一步步来解决这个问题，从基础配置到代码层面的优化，确保重启后API自动初始化：

1. 先确认IIS应用池的核心配置是否真的生效 #

很多时候配置没生效是因为细节没做到位：

• 打开IIS管理器，找到你的应用池，进入高级设置：
  • 把「启动模式」设为 AlwaysRunning
  • 「空闲超时（分钟）」设为 0，同时「闲置超时操作」选「无」，避免应用池因闲置回收
  • 「定期时间间隔（分钟）」也设为 0，防止应用池自动定时回收

2. 修正applicationInitialization的配置（你之前的设置可能有遗漏） #

这个配置需要和IIS的预加载功能配合，而且要注意参数细节：

• 确保web.config放在网站根目录，正确的配置示例：

  <system.webServer>
    <!-- 关键：skipManagedModules设为false，不然会跳过AspNetCore模块，初始化请求无效 -->
    <applicationInitialization doAppInitAfterRestart="true" skipManagedModules="false">
      <!-- 注意路径要加斜杠，确保IIS能正确解析 -->
      <add initializationPage="/api/app_start" />
    </applicationInitialization>
  
    <!-- 确保AspNetCore模块配置正确 -->
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath="dotnet" arguments=".\YourApi.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  </system.webServer>
  

• 重点：skipManagedModules不能设为true，因为AspNetCore是托管模块，跳过它会导致初始化请求无法触发API启动。

3. 用ASP.NET Core托管服务（Hosted Service）固化后台任务 #

你的Scoped服务依赖请求上下文，单纯靠API启动可能不够。建议把后台逻辑包装成IHostedService，这样应用启动时就会自动运行，完全不依赖外部请求：

• 如果必须使用Scoped服务（比如依赖DbContext），可以通过IServiceScopeFactory在托管服务里创建作用域：

  public class BackgroundWorker : BackgroundService
  {
      private readonly IServiceScopeFactory _scopeFactory;
      private readonly ILogger<BackgroundWorker> _logger;
  
      public BackgroundWorker(IServiceScopeFactory scopeFactory, ILogger<BackgroundWorker> logger)
      {
          _scopeFactory = scopeFactory;
          _logger = logger;
      }
  
      protected override async Task ExecuteAsync(CancellationToken stoppingToken)
      {
          _logger.LogInformation("后台任务已启动");
  
          while (!stoppingToken.IsCancellationRequested)
          {
              // 创建作用域来使用Scoped服务
              using var scope = _scopeFactory.CreateScope();
              var yourScopedService = scope.ServiceProvider.GetRequiredService<YourScopedService>();
  
              // 执行你的后台逻辑
              await yourScopedService.DoBackgroundWork(stoppingToken);
  
              // 根据需求设置任务间隔
              await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
          }
  
          _logger.LogInformation("后台任务已停止");
      }
  }
  

• 然后在Program.cs里注册这个托管服务：

  builder.Services.AddHostedService<BackgroundWorker>();
  

4. 开启网站的预加载功能 #

最后一步，确保网站本身启用预加载：

• 在IIS管理器中找到你的网站，进入高级设置，把「预加载已启用」设为True。这个选项会配合applicationInitialization，在应用池启动时自动触发初始化请求。

5. 验证配置是否生效 #

重启应用池后，可以做这几个检查：

• 查看IIS日志，确认/api/app_start的请求是否被自动触发
• 打开任务管理器，看dotnet.exe或w3wp.exe进程是否在重启后立即启动
• 查看你的API日志，确认托管服务是否在应用启动时就开始运行

备注：内容来源于stack exchange，提问作者M.Fakhoury