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 实现大文件分片上传：本地存储解决方案【代码之美】
文章目录
前言
在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主机)
publicclassProgram{publicstaticvoidMain(string[] args){CreateWebHostBuilder(args).Build().Run();}publicstaticIWebHostBuilderCreateWebHostBuilder(string[] args)=> WebHost.CreateDefaultBuilder(args).ConfigureAppConfiguration((hostingContext, config)=>{// 配置设置}).ConfigureLogging(logging =>{// 日志配置}).UseStartup<Startup>();}🎯关键点：
- 使用
WebHost.CreateDefaultBuilder创建 - 需要
Startup类分离配置 - 🚫在ASP.NET Core 3.0+中已过时
2.2 Host (通用主机)
publicclassProgram{publicstaticvoidMain(string[] args){CreateHostBuilder(args).Build().Run();}publicstaticIHostBuilderCreateHostBuilder(string[] args)=> Host.CreateDefaultBuilder(args).ConfigureServices((hostContext, services)=>{ services.AddHostedService<Worker>();});}publicclassWorker:BackgroundService{protectedoverrideasyncTaskExecuteAsync(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 如何选择主机模型
| 场景 | 推荐主机 |
|---|---|
| 新Web项目 (6.0+) | WebApplication |
| 旧Web项目 (3.0-5.0) | WebHost (考虑迁移) |
| 后台服务/Worker | Host |
3.2 从WebHost迁移到WebApplication
旧代码 (WebHost):
publicclassStartup{publicvoidConfigureServices(IServiceCollection services){ services.AddControllers();}publicvoidConfigure(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 模型，现有项目可考虑逐步迁移。
