ASP.NET Core 主机模型详解：Host、WebHost与WebApplication的对比与实践【代码之美】

🎀🎀🎀代码之美系列目录🎀🎀🎀

一、C# 命名规则规范 二、C# 代码约定规范 三、C# 参数类型约束 四、浅析 B/S 应用程序体系结构原则 五、浅析 C# Async 和 Await 六、浅析 ASP.NET Core SignalR 双工通信 七、浅析 ASP.NET Core 和 MongoDB 创建 Web API 八、浅析 ASP.NET Web UI 框架 Razor Pages/MVC/Web API/Blazor 九、如何使用 MiniProfiler WebAPI 分析工具 十、浅析 .NET Core 中各种 Filter 十一、C#.Net筑基-类型系统 十二、C#.Net 筑基-运算符 十三、C#.Net筑基-解密委托与事件 十四、C#.Net筑基-集合知识大全 十五、C#.Net筑基 – 常见类型 十六、C#.NET体系图文概述—2024最全总结 十七、C# 强大无匹的模式匹配，让代码更加优雅 十八、C# 中的记录类型简介 十九、C# 异步编程模型【代码之美系列】 二十、C#高级篇 反射和属性详解【代码之美系列】 二十一、.NET Core 中获取各种路径的的方法汇总【代码之美】 二十二、【C#实战】动态模板替换：根据Model字段名称自动匹配替换值【代码之美】 二十三、.NET 集成 Velocity 模板引擎实现动态代码生成（高性能+易扩展） 二十四、在 .NET 8/9 中使用 AppUser 进行 JWT 令牌身份验证 二十五、.NET8 中间件与过滤器的对比：深入解析与应用场景 二十六、.NET Core 中获取各种路径的的方法汇总【代码之美】 二十七、.NET 8 实现大文件分片上传：本地存储解决方案【代码之美】

文章目录

• 🎀🎀🎀代码之美系列目录🎀🎀🎀
• 前言
• 一、主机模型概述
• • 1.1 主机的作用
  • 1.2 三种主机的演进
• 二、三种主机的详细对比
• • 2.1 WebHost (传统Web主机)
  • 2.2 Host (通用主机)
  • 2.3 WebApplication (现代Web主机)
• 三、最佳实践与迁移建议
• • 3.1 如何选择主机模型
  • 3.2 从WebHost迁移到WebApplication
  • 3.3 最小API示例
• 四、常见问题解答
• • Q1：WebApplication和Host能否共存？
  • Q2：何时需要使用单独的Startup类？
  • Q3：性能上有差异吗？
• 结语

前言

在ASP.NET Core开发中，主机（Host）是应用程序的入口和运行环境。随着版本的迭代，ASP.NET Core提供了不同的主机模型，包括 Host、WebHost 和WebApplication。许多开发者对这些概念容易混淆，本文将深入解析它们的区别，并通过实际代码演示各自的用法。

一、主机模型概述

1.1 主机的作用

主机在 ASP.NET Core 中负责：

• 应用程序的启动和生命周期管理
• 依赖注入容器的配置
• 应用程序配置的设置
• 日志系统的初始化
• 中间件管道的构建（针对Web应用）

1.2 三种主机的演进

• WebHost (1.0-3.x)：最初的Web应用主机
• Host (3.0+)：通用主机，用于 非HTTP 场景
• WebApplication (6.0+)：现代化 Web应用 主机

二、三种主机的详细对比

2.1 WebHost (传统Web主机)

public class Program
{
public static void Main(string[] args)
{
CreateWebHostBuilder(args).Build().Run();
}

public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.ConfigureAppConfiguration((hostingContext, config) =>
{
// 配置设置
})
.ConfigureLogging(logging =>
{
// 日志配置
})
.UseStartup<Startup>();
}

🎯关键点：

• 使用 WebHost.CreateDefaultBuilder创建
• 需要 Startup 类分离配置
• 🚫在ASP.NET Core 3.0+中已过时

2.2 Host (通用主机)

public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}

public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureServices((hostContext, services) =>
{
services.AddHostedService<Worker>();
});
}

public class Worker : BackgroundService
{
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
// 后台服务逻辑
}
}

🎯关键点：

• 使用 Host.CreateDefaultBuilder 创建
• 适合后台服务、控制台应用等 非HTTP 场景
• 不包含Web 服务器

2.3 WebApplication (现代Web主机)

var builder = WebApplication.CreateBuilder(args);

// 添加服务到容器
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// 配置HTTP请求管道
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

🎯关键点：

• 使用 WebApplication.CreateBuilder 创建
• 更简洁的API设计
• 支持最小API
• 推荐用于 ASP.NET Core 6.0+ 的新项目

三、最佳实践与迁移建议

3.1 如何选择主机模型

3.2 从WebHost迁移到WebApplication

旧代码 (WebHost):

public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers();
}

public void Configure(IApplicationBuilder app)
{
app.UseRouting();
app.UseEndpoints(endpoints => endpoints.MapControllers());
}
}

新代码 (WebApplication):

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();

var app = builder.Build();
app.MapControllers();
app.Run();

3.3 最小API示例

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");
app.MapGet("/user/{id}", (int id) => $"User ID: {id}");

app.Run();

四、常见问题解答

Q1：WebApplication和Host能否共存？

A：可以，WebApplication 内部实际上使用了 Host 作为基础，并添加了 Web 特定功能。

Q2：何时需要使用单独的Startup类？

A：在 WebApplication 模型中，Startup 类不再是必需的，所有配置可以在Program.cs` 中完成。但大型项目仍可分离配置。

Q3：性能上有差异吗？

A：WebApplication 启动更快，因为减少了间接层，但运行时性能差异不大。

结语

理解 ASP.NET Core 的不同主机模型对于构建高效应用程序至关重要。随着.NET的演进，WebApplication 已成为最简单、最直接的 Web 应用构建方式。✅建议新项目直接采用 WebApplication 模型，现有项目可考虑逐步迁移。