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

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提供了不同的主机模型,包括 HostWebHostWebApplication。许多开发者对这些概念容易混淆,本文将深入解析它们的区别,并通过实际代码演示各自的用法。

一、主机模型概述

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 (考虑迁移)
后台服务/WorkerHost

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 模型,现有项目可考虑逐步迁移。

Read more

Qwen3-VL-WEBUI部署教程:多用户并发访问的配置方案

Qwen3-VL-WEBUI部署教程:多用户并发访问的配置方案 1. 引言 随着多模态大模型在实际业务场景中的广泛应用,视觉-语言模型(VLM)已成为智能客服、内容生成、自动化测试等领域的核心技术。阿里云推出的 Qwen3-VL 系列模型,作为目前 Qwen 家族中能力最强的视觉语言模型,具备强大的图文理解、空间推理、视频分析和代理交互能力,尤其适用于需要高并发、低延迟响应的企业级应用。 本文将围绕开源项目 Qwen3-VL-WEBUI,详细介绍如何部署支持多用户并发访问的 Web 服务环境。该 WEBUI 内置了 Qwen3-VL-4B-Instruct 模型,开箱即用,并针对生产环境进行了优化,适合中小团队快速搭建私有化多模态服务平台。 通过本教程,你将掌握: - 如何拉取并运行官方镜像 - 配置高性能推理后端以支持并发请求 - 调整 WebUI 参数实现负载均衡与资源隔离 - 实际部署中的常见问题与调优建议 2. Qwen3-VL-WEBUI 核心特性解析 2.

Apache SeaTunnel Web 完整使用指南:从零搭建可视化数据集成平台

Apache SeaTunnel Web 完整使用指南:从零搭建可视化数据集成平台 【免费下载链接】seatunnel-webSeaTunnel is a distributed, high-performance data integration platform for the synchronization and transformation of massive data (offline & real-time). 项目地址: https://gitcode.com/gh_mirrors/se/seatunnel-web Apache SeaTunnel Web 是基于 SeaTunnel Connector API 和 Zeta Engine 开发的可视化管理平台,让数据集成工作变得前所未有的简单。无论您是数据工程师、开发人员还是运维人员,这个强大的 Web 控制台都能帮助您轻松管理海量数据的同步和转换任务。

使用Docker安装Ollama及Open-WebUI完整教程

作者:吴业亮 博客:wuyeliang.blog.ZEEKLOG.net 一、Ollama 简介及工作原理 1. Ollama 简介及原理 * 简介:Ollama 是一款轻量级、开源的大语言模型(LLM)运行工具,旨在简化本地部署和运行大语言模型的流程。它支持 Llama 3、Mistral、Gemini 等主流开源模型,用户无需复杂配置即可在本地设备(CPU 或 GPU)上快速启动模型,适用于开发测试、本地智能应用搭建等场景。 * 工作原理: * 采用模型封装机制,将大语言模型的运行环境、依赖库及推理逻辑打包为标准化格式,实现模型的一键下载、启动和版本管理。 * 通过优化的推理引擎适配硬件架构,支持 CPU 基础运行和 GPU 加速(如 NVIDIA CUDA),减少资源占用并提升响应速度。 * 提供简洁的

GLM-4.6V-Flash-WEB避坑指南:这些错误千万别犯

GLM-4.6V-Flash-WEB避坑指南:这些错误千万别犯 你刚下载完 GLM-4.6V-Flash-WEB 镜像,兴奋地点开终端,输入 ./1键推理.sh,屏幕却突然卡住——几秒后弹出 CUDA out of memory; 你拖进一张高清商品图,点击“提问”,界面转圈两分钟,最后返回空响应; 你照着文档调用API,反复修改JSON格式,却始终收到 422 Unprocessable Entity; 你自信满满地把服务暴露到公网,第二天发现日志里全是异常图片上传和高频恶意请求…… 这不是模型不行,而是你踩进了别人已经趟过的坑。 GLM-4.6V-Flash-WEB 是智谱AI最新开源的轻量级多模态视觉大模型,主打“单卡可跑、网页即用、API兼容”,但它的易用性有个前提:你得避开那些看似微小、实则致命的配置陷阱和操作误区。本文不讲原理、不堆参数,只聚焦一个目标:帮你把服务稳稳跑起来,且不翻车。全文基于真实部署记录整理,所有问题均来自ZEEKLOG星图用户反馈、GitHub