.NET Core 通用主机设计与实现机制解析
主机核心概念
主机是 .NET Core 应用程序的运行时容器，它将应用所需的核心基础设施整合为统一的管理单元。这些基础设施包括依赖注入容器、日志系统、配置管理以及托管服务的生命周期调度。
Web 主机与通用主机的演进
在 ASP.NET Core 早期版本中，WebHost 专门处理 HTTP 请求场景。随着 3.0 版本发布，微软引入了通用主机（Generic Host）架构，该架构能够承载任意类型的应用负载——不仅限于 Web 应用，还包括后台任务、定时作业等。
以 ASP.NET Core 3.1 为例，Program.cs 中的典型结构如下：
public class Program
{
public static void Main(string[] args) => CreateHostBuilder(args).Build().Run();
public static IHostBuilder CreateHostBuilder(string[] args) = >
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
webBuilder.UseStartup<Startup>());
}HostBuilder 的构造流程
Host.CreateDefaultBuilder 方法返回 HostBuilder 实例，其内部执行了多项关键配置：
- 设定内容根目录为当前工作目录
- 加载 DOTNET_ 前缀的环境变量
- 解析命令行参数
- 读取 appsettings.json 及其环境变体
- 开发环境下启用 User Secrets
- 注册控制台、调试、事件源等日志提供程序
- 开发模式下开启作用域验证
Web 运行时集成机制
ConfigureWebHostDefaults 扩展方法通过 GenericWebHostBuilder 将 Web 能力叠加到通用主机之上。其核心逻辑如下：
public static IHostBuilder ConfigureWebHostDefaults(
this IHostBuilder builder,
Action<IWebHostBuilder> configure)
{
return builder.ConfigureWebHost(webHostBuilder =>
{
WebHost.ConfigureWebDefaults(webHostBuilder);
configure(webHostBuilder);
});
}ConfigureWebDefaults 方法完成以下 Web 特定配置：
- 集成 Kestrel 服务器并读取其配置节
- 添加主机筛选中间件
- 条件性启用转发头中间件
- 配置 IIS 集成
Build 阶段的关键步骤
IHostBuilder.Build() 方法触发以下构建序列：
- 构建主机配置：合并所有配置源形成
IConfiguration - 创建宿主环境：初始化
IHostEnvironment，包含应用名称、环境名称、根路径等 - 建立构建上下文：生成
HostBuilderContext供后续配置使用 - 构建应用配置：处理应用程序级别的配置数据
- 创建服务提供程序：组装依赖注入容器
主机启动与托管服务
Run() 扩展方法最终调用 Host.StartAsync()，该方法遍历并启动所有已注册的 IHostedService 实现。
以下示例展示了一个周期性后台任务的实现：
public class BackgroundWorker : IHostedService, IDisposable
{
private Timer _timer;
private readonly ILogger<BackgroundWorker> _logger;
public BackgroundWorker(ILogger<BackgroundWorker> logger)
{
_logger = logger;
}
public Task StartAsync(CancellationToken cancellationToken)
{
_timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
return Task.CompletedTask;
}
private void DoWork(object state)
{
_logger.LogInformation("后台任务执行于: {time}", DateTimeOffset.Now);
}
public Task StopAsync(CancellationToken cancellationToken)
{
_timer?.Change(Timeout.Infinite, 0);
return Task.CompletedTask;
}
public void Dispose() => _timer?.Dispose();
}注册方式采用标准的 DI 注册语法：
public void ConfigureServices(IServiceCollection services)
{
services.AddHostedService<BackgroundWorker>();
services.AddControllers();
}主机启动后，BackgroundWorker 将自动运行，每 5 秒输出一次日志记录。
