首页 > 基础资料 博客日记
.NET Core自定义 ALC 中启动WebHost的HostingStartup解析异常
2026-06-14 15:00:02基础资料围观1次

可观测性 — Application Insights 通过 HostingStartup 自动注入请求追踪、依赖遥测、性能计数器,应用完全无感知
平台集成 — Azure AppService的AzureAppServices.HostingStartup注入诊断日志、应用预热(Application Initialization)、ARR 亲和性 Cookie 等平台级中间件
配置增强 — 在 Configure()中读取远程配置中心数据,追加到 IWebHostBuilder,实现启动阶段的动态配置注入
配置指定 — 环境变量ASPNETCORE_HOSTINGSTARTUPASSEMBLIES,或配置键hostingStartupAssemblies
自动扫描 — 遍历 deps.json 中列出的程序集,检查是否标记了 [assembly: HostingStartup]
GenericWebHostBuilder.ExecuteHostingStartups()内部调用:
var assembly = Assembly.Load(new AssemblyName(assemblyName));
Assembly.Load(AssemblyName)仅在Default ALC中查找,对自定义 ALC 完全无感知。

private void ExecuteHostingStartups() { var webHostOptions = new WebHostOptions( _config, Assembly.GetEntryAssembly()?.GetName().Name); if (webHostOptions.PreventHostingStartup) return; var exceptions = new List<Exception>(); var assemblyNames = webHostOptions.HostingStartupAssemblies .Except(webHostOptions.HostingStartupExcludeAssemblies, StringComparer.OrdinalIgnoreCase) .Distinct(StringComparer.OrdinalIgnoreCase); // 1) 先 Except(excludeAssemblies),再 Distinct 去重 // 2) 逐个程序集独立 try/catch,异常不中断循环 foreach (var assemblyName in assemblyNames) { try { var assembly = Assembly.Load(new AssemblyName(assemblyName)); foreach (var attr in assembly.GetCustomAttributes<HostingStartupAttribute>()) { var hostingStartup = (IHostingStartup)Activator .CreateInstance(attr.HostingStartupType); hostingStartup.Configure(_hostingStartupWebHostBuilder); } } catch (Exception ex) { exceptions.Add(ex); // 收集异常,继续处理后续程序集 } } if (exceptions.Count > 0) _hostingStartupErrors = exceptions; }
每个程序集包裹在独立的 try/catch中,异常只影响当前程序集,循环继续执行后续程序集,不存在 StartupFilter 链断裂问题,Except(excludeAssemblies)在Assembly.Load()之前执行,被排除的程序集根本不会进入加载循环,这是解决方案生效的根基。所有异常最终存入 _hostingStartupErrors,由 GenericWebHostServiceOptions.HostingStartupExceptions对外暴露,日志组件据此输出crit级别日志。
using System.Reflection; using System.Runtime.Loader; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.Hosting; // 1. 在 Default ALC 中启动第一个 WebHost Console.WriteLine("[ConsoleApp] Starting first web host..."); var mainHost = Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseUrls("http://localhost:5001"); webBuilder.Configure(app => app.Run(async ctx => await ctx.Response.WriteAsync("Hello from main host!"))); }) .Build(); await mainHost.StartAsync(); Console.WriteLine("[ConsoleApp] First host listening on http://localhost:5001"); // 2. 通过自定义 ALC 加载插件程序集 var pluginPath = Path.Combine( AppContext.BaseDirectory, "Plugins", "TestLib.dll"); var alc = new CustomAssemblyLoadContext(pluginPath); var asm = alc.LoadFromAssemblyPath(pluginPath); // 验证隔离:TestLib 不在 Default ALC 中 Console.WriteLine($"[ConsoleApp] TestLib in Default ALC: " + $"{AssemblyLoadContext.Default.Assemblies.Any(a => a.GetName().Name == "TestLib")}"); // 输出: False // 3. 调用插件初始化方法 asm.GetType("TestLib.Initializer")! .GetMethod("Initialize")! .Invoke(null, null); Console.WriteLine("Press ENTER to shut down..."); Console.ReadLine(); await mainHost.StopAsync(); // 自定义 ALC:仅加载 Plugins 目录下的程序集,其余交给 Default ALC internal sealed class CustomAssemblyLoadContext : AssemblyLoadContext { private readonly AssemblyDependencyResolver _resolver; public CustomAssemblyLoadContext(string pluginDir) : base(isCollectible: true) { _resolver = new AssemblyDependencyResolver(pluginDir); } protected override Assembly? Load(AssemblyName assemblyName) { var path = _resolver.ResolveAssemblyToPath(assemblyName); return path is not null ? LoadFromAssemblyPath(path) : null; } }
确保 ConsoleApp.csproj中TestLib不作为项目引用。TestLib.dll 通过构建后事件拷贝到 Plugins/ 子目录,使其脱离 Default ALC 的探查路径:
<Target Name="CopyTestLibToPlugins" AfterTargets="Build"> <MakeDir Directories="$(OutputPath)Plugins" /> <Copy SourceFiles="..\TestLib\bin\$(Configuration)\net10.0\TestLib.dll" DestinationFolder="$(OutputPath)Plugins" /> </Target>
using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.Hosting; // 标记为 HostingStartup 程序集 [assembly: HostingStartup(typeof(TestLib.TestHostingStartup))] namespace TestLib; public class TestHostingStartup : IHostingStartup { public void Configure(IWebHostBuilder builder) { // 观测点 1:记录 Configure 被调用,证明 TestLib 被成功加载为 HostingStartup Console.WriteLine("[TestLib.HostingStartup] Configure() invoked."); // 观测点 2:检查当前程序集归属的 ALC var currentAlc = AssemblyLoadContext.GetLoadContext( typeof(TestHostingStartup).Assembly); Console.WriteLine($"[TestLib.HostingStartup] Loaded in ALC: {currentAlc?.Name ?? "Default"}"); Console.WriteLine($"[TestLib.HostingStartup] Is Default ALC: {currentAlc == AssemblyLoadContext.Default}"); // 观测点 3:注册一个诊断中间件,验证 HostingStartup 注入是否生效 builder.Configure(app => { app.Use(async (ctx, next) => { ctx.Response.Headers["X-HostingStartup"] = "TestLib-Injected"; await next(); }); }); Console.WriteLine("[TestLib.HostingStartup] Diagnostic middleware registered."); } }
TestHostingStartup本身也是一个观测手段——如果Configure()被调用,说明 ASP.NET Core 在 Default ALC 中成功定位并加载了 TestLib;反之,如果只有FileNotFoundException日志而Configure()从未触发,则证实了加载失败。
public static class Initializer { public static void Initialize() { Console.WriteLine("[TestLib] Called from custom ALC context."); // 模拟被注入到环境变量的场景 Environment.SetEnvironmentVariable( "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES", "TestLib"); var host = Host.CreateDefaultBuilder() .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseUrls("http://localhost:5002"); webBuilder.Configure(app => app.Run(async ctx => await ctx.Response.WriteAsync("Hello from inner host!"))); }) .Build(); host.Start(); Console.WriteLine("[TestLib] Inner host started on http://localhost:5002"); } }

TestLib in Default ALC: False —— 插件确实只存在于自定义 ALC;异常来自GenericWebHostBuilder.ExecuteHostingStartups()→Assembly.Load()—— Default ALC 中找不到 TestLib
Host.CreateDefaultBuilder() .ConfigureWebHostDefaults(webBuilder => { // 在 Assembly.Load 发生之前就排除 TestLib webBuilder.UseSetting( WebHostDefaults.HostingStartupExcludeAssembliesKey, "TestLib"); webBuilder.UseUrls("http://localhost:5002"); webBuilder.Configure(app => app.Run(async ctx => await ctx.Response.WriteAsync("Hello from inner host!"))); }) .Build();
webBuilder.UseSetting( WebHostDefaults.HostingStartupAssembliesKey, ""); // 无效
AddInMemoryCollection(_settings) ← UseSetting 写入(低优先级)
.AddConfiguration(hostConfig) ← 环境变量在此(高优先级)
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:jacktools123@163.com进行投诉反馈,一经查实,立即删除!
标签:
相关文章
最新发布
- Strong consistency models 学习笔记
- .NET Core自定义 ALC 中启动WebHost的HostingStartup解析异常
- 27. Agent 需要拦截模型调用?用 Middleware 给它加个“拦截器“!
- 15天学会AI应用开发(六)使用离线大模型对文本生成摘要
- 上位机WPF全局异常捕获处理:三种场景全覆盖,防止崩溃
- 码哥实测:写了20行SKILL.md,Claude的代码质量提升了一倍
- AI-Coding:2026世界杯实时看板
- Jasmine.Format - 一个高性能、线程安全的 .NET HTML 生成库
- 还在被框架绑架?一文看懂“六边形架构”,让你的核心业务稳如泰山!
- 独立开发者最容易低估的,不是开发成本,而是维护成本

