.NET Generic Host关闭时未释放注册服务实例的原因探究

问题描述 #

我使用.NET 8控制台应用搭配Microsoft.Extensions.Hosting v8.0.0 NuGet包（即.NET Generic Host），注入了一个实现IDisposable的单例服务，但按下Ctrl+C关闭应用时，该服务的Dispose()方法并未被调用。我找到了两种临时解决办法（通过IHostApplicationLifetime注册关闭回调，或者手动调用host.Dispose()），但始终不理解为何需要这些操作——IHost在主机关闭时难道不该自动释放所有注册的服务实例吗？

复现代码 #

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using System;

namespace IHostCtrlC;

internal class Program
{
    static void Main()
    {
        var hostBuilder = Host.CreateDefaultBuilder().ConfigureServices(services =>
        {
            services.AddSingleton<IService1, Service1>();
        });

        var host = hostBuilder.Build();

        host.Start();

        // 临时解决办法：通过IHostApplicationLifetime注册回调
        //var hostApplicationLifetime = host.Services.GetRequiredService<IHostApplicationLifetime>();
        //var service1 = host.Services.GetRequiredService<IService1>();
        //hostApplicationLifetime.ApplicationStopping.Register(OnShutdown, service1);

        Console.WriteLine(host.Services.GetRequiredService<IService1>().GetText());
        host.WaitForShutdown();

        // 临时解决办法：手动调用host.Dispose()
        //host.Dispose();
    }

    private static void OnShutdown(object toDispose)
    {
        ((IDisposable)toDispose).Dispose();
    }
}

internal interface IService1 : IDisposable
{
    string GetText();
}

internal class Service1 : IService1
{
    public string GetText() => "Text from Service1";
    public void Dispose() => Console.WriteLine("Service1.Dispose()");
}

原因分析 #

从Microsoft.Extensions.Hosting.Abstractions的源码可以看到，host.RunAsync()的内部逻辑包含完整的生命周期管理：

try
{
    await host.StartAsync(token).ConfigureAwait(false);
    await host.WaitForShutdownAsync(token).ConfigureAwait(false);
}
finally
{
    if (host is IAsyncDisposable asyncDisposable)
    {
        await asyncDisposable.DisposeAsync().ConfigureAwait(false);
    }
    else
    {
        host.Dispose();
    }
}

而你当前使用的host.Start() + host.WaitForShutdown()组合，仅完成了启动应用和等待关闭信号两个步骤，不包含Host实例的释放逻辑。

IHost本身实现了IDisposable接口，只有当Host实例被释放时，它才会递归释放其管理的所有服务（包括单例的IDisposable服务）。这就是为什么你需要手动调用host.Dispose()，或者通过IHostApplicationLifetime手动触发服务释放的原因。

解决方法 #

方法1：改用host.Run()（推荐） #

host.Run()是封装好的同步生命周期方法，内部会自动处理启动、等待关闭、释放Host三个环节，无需手动调用释放：

static void Main()
{
    var host = Host.CreateDefaultBuilder()
        .ConfigureServices(services => services.AddSingleton<IService1, Service1>())
        .Build();

    host.Run();
    // 无需手动调用host.Dispose()，Run()内部会自动处理
}

方法2：手动调用host.Dispose() #

如果坚持使用Start() + WaitForShutdown()，只需在WaitForShutdown()之后手动调用host.Dispose()即可：

host.WaitForShutdown();
host.Dispose(); // 手动释放Host，触发所有服务的Dispose

方法3：通过IHostApplicationLifetime注册回调（不推荐） #

这种方法是单独针对某个服务注册释放逻辑，绕开了Host的自动管理机制，仅适用于需要单独控制服务释放时机的特殊场景：

var hostApplicationLifetime = host.Services.GetRequiredService<IHostApplicationLifetime>();
var service1 = host.Services.GetRequiredService<IService1>();
hostApplicationLifetime.ApplicationStopping.Register(OnShutdown, service1);

总结 #

核心问题在于Start() + WaitForShutdown()的组合仅覆盖了应用的启动和等待关闭阶段，没有包含Host的释放逻辑。而Run()/RunAsync()是.NET Generic Host提供的完整生命周期方法，会自动处理Host的释放，进而触发所有托管服务的Dispose()方法。推荐优先使用Run()/RunAsync()来避免手动处理释放的繁琐。

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