如何在IIS中触发ASP.NET应用启动、重启、停止事件

• IHostApplicationLifetime 是ASP.NET Core通用宿主层的内置接口，仅支持ASP.NET Core 3.0及以上版本的应用，在.NET Framework 4.7.2的传统System.Web栈ASP.NET应用中无对应实现，跨框架直接调用必然抛出类型加载、引用缺失类异常。
• 两个运行时的生命周期逻辑完全独立，需根据项目实际目标框架分别实现，不要跨框架混用接口。

.NET Framework 4.7.2 （System.Web栈）实现 #

直接通过Global.asax全局应用类的内置生命周期事件实现，无需额外安装第三方包：

public class Global : HttpApplication
{
    // 应用首次启动、IIS应用池初始化完成后触发，对应Start事件
    protected void Application_Start(object sender, EventArgs e)
    {
        // 写入启动逻辑：初始化缓存、预热依赖服务、加载全局配置
    }

    // 应用关闭、应用池回收/停止时触发，对应Shutdown事件
    protected void Application_End(object sender, EventArgs e)
    {
        // 写入关闭逻辑：释放非托管资源、持久化临时状态、断开长连接
        // 可通过以下属性获取具体关闭原因，区分是IIS自动回收、配置变更触发重启、还是手动停止站点
        var shutdownReason = HostingEnvironment.ShutdownReason;
    }
}

• 该框架无原生独立Restart事件：IIS触发的应用重启本质是先执行Application_End收尾，下一次用户请求进入时重新执行Application_Start完成初始化。如果需要识别重启动作，可以在Application_End阶段写入持久化标记（比如磁盘临时文件、系统注册表项），下次Application_Start执行时读取该标记即可区分冷启动和重启场景。
• 注意事项：IIS应用池默认的进程关闭时间限制为90秒，如果Shutdown逻辑执行时长超过该阈值，会被IIS强制终止，需根据实际逻辑耗时调整应用池配置。

.NET Core 3.0 实现 #

.NET Core 3.0 SDK已原生内置IHostApplicationLifetime，无需额外引入NuGet包，直接在Startup启动类中注入使用即可，调用异常通常是目标框架配置错误、包版本冲突导致：

public class Startup
{
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IHostApplicationLifetime appLifetime)
    {
        // 应用启动完成、请求处理管道就绪后触发，对应Start事件
        appLifetime.ApplicationStarted.Register(() =>
        {
            // 写入启动后逻辑：预热接口、注册服务实例
        });

        // 收到关闭信号、开始停止进程时触发，此时仍可处理正在进行的请求
        appLifetime.ApplicationStopping.Register(() =>
        {
            // 写入停止中逻辑：停止接收新请求、通知依赖服务下线
        });

        // 所有请求处理完成、进程即将退出时触发，对应Shutdown事件
        appLifetime.ApplicationStopped.Register(() =>
        {
            // 写入收尾逻辑：释放资源、刷日志
        });
    }
}

• 该框架同样无原生独立Restart事件：IIS触发的重启流程为先执行停止相关事件，待进程退出后由IIS重新拉起新进程，再执行启动相关事件。如果需要主动触发重启，可调用appLifetime.StopApplication()终止当前进程，由IIS自动完成后续拉起动作，不要直接手动杀进程。
• 常见调用异常排查：
  • 确认项目目标框架设置为netcoreapp3.0，不要将目标框架设为net472时尝试调用该接口
  • 不要手动安装低于3.0版本的Microsoft.Extensions.Hosting相关包，避免版本绑定冲突
  • 提前在服务器安装对应版本的ASP.NET Core托管捆绑包，否则IIS无法正确启动Core进程，生命周期事件自然不会触发

注意：如果是同一IIS站点下通过子应用混跑.NET Framework 4.7.2和.NET Core 3.0应用，需要分别在两个独立项目中编写对应生命周期逻辑，不支持跨应用、跨框架调用生命周期接口。

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