惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

T
The Exploit Database - CXSecurity.com
aimingoo的专栏
aimingoo的专栏
WordPress大学
WordPress大学
美团技术团队
小众软件
小众软件
量子位
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Jina AI
Jina AI
Martin Fowler
Martin Fowler
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
Recent Announcements
Recent Announcements
罗磊的独立博客
P
Proofpoint News Feed
博客园 - 聂微东
爱范儿
爱范儿
D
Docker
IT之家
IT之家
人人都是产品经理
人人都是产品经理
Hugging Face - Blog
Hugging Face - Blog
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
I
Intezer
S
Security Archives - TechRepublic
Cyberwarzone
Cyberwarzone
C
Cybersecurity and Infrastructure Security Agency CISA
Know Your Adversary
Know Your Adversary
MyScale Blog
MyScale Blog
云风的 BLOG
云风的 BLOG
G
GRAHAM CLULEY
有赞技术团队
有赞技术团队
Blog — PlanetScale
Blog — PlanetScale
G
Google Developers Blog
雷峰网
雷峰网
博客园 - 三生石上(FineUI控件)
Vercel News
Vercel News
Scott Helme
Scott Helme
Threat Intelligence Blog | Flashpoint
Threat Intelligence Blog | Flashpoint
CTFtime.org: upcoming CTF events
CTFtime.org: upcoming CTF events
博客园 - 司徒正美
腾讯CDC
T
Threat Research - Cisco Blogs
B
Blog RSS Feed
博客园_首页
Cisco Talos Blog
Cisco Talos Blog
博客园 - Franky
Recorded Future
Recorded Future
PCI Perspectives
PCI Perspectives
C
CXSECURITY Database RSS Feed - CXSecurity.com
Microsoft Security Blog
Microsoft Security Blog
L
LangChain Blog
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org

博客园_首页

Linux实操--组管理、权限管理和定时任务 - NE_STOP Java + EasyExcel 实现单个接口导出多个Excel - LucaJu Mem0 源码解析系列(二):提示词工程的深度剖析 TaskFlow究竟是什么?和普通Skills技能有什么区别 - Winton-H 图论证明题 - 洛苡hh 嘉立创开源:应该是全网MicroPython教程最多的开发板 - FreakStudio Hermes Agent 集成实践:从协议到生产 - Newbe36524 2026年AI编程工具横评:Cursor、Codex、Claude Code、Zed、Windsurf Java程序员必看的RAG入门教程 - 苏三说技术 2026 AI效率神器:Superpowers + Claude Code 保姆级教程 - 狂师 本地大模型部署全攻略:从 0 到 1 玩转 Ollama - MeteorSeed 【从0到1构建一个ClaudeAgent】内存管理-上下文压缩 - 程序员Seven .NET 高级开发 | 设计、实现一个事件总线框架 - 痴者工良 电子小白入门之NE555 - Tlink 3. WorkBuddy:隐藏玩法,一键召唤专家,让 AI 以"专家身份"给你干活 - 岳小哥AI 和AI一起搞事情#3:Claude Teammate 游戏开发翻车实录 - 风雨中的小七 【OpenClaw】通过 Nanobot 源码学习架构---(7)Memory - 罗西的思考 C# .NET 周刊|2026年3月3期 - InCerry 我在 Debian 11 上把 K8s 单机搭起来了,过程没你想的那么顺(/opt 目录版) - 陌陌卡上 深度学习进阶(七)Data-efficient Image Transformer - 哥布林学者 CLI+Skill搭建浏览器AI自动化框架,告别一切重复枯燥任务 - 技术爬爬虾 告别Token账单无底洞:OpenClaw本地部署,重塑企业数据主权的唯一解 - 清风915938629 FastAPI+Vue:文件分片上传+秒传+断点续传,这坑我帮你踩平了! - 一名程序媛呀 SBTI 爆火后,我做了个程序员版的 CBTI。。已开源 + 附开发过程 - 程序员鱼皮 多模态检索开始进入工程期:用 Sentence Transformers 搭建可落地的 Multimodal RAG 100多行代码实现一个最简单的Agent(用ReAct) Claude Code 通关手册(八):推荐 5 个 Hooks,代码质量提升 3 倍 - 暮色之狐 老板:“有人截图了!”。安全部门:“收到,马上查暗水印!” - why技术 技术之外,皆是人间 C#/.NET/.NET Core技术前沿周刊 | 第 69 期(2026年4.01-4.12) - 追逐时光者 Snack JSONPath 项目架构分析 - 带刺的坐椅 Claude Code Buddy 小析:一个非核心功能,如何体现产品的细节完成度 - 葡萄城技术团队 AI新时代下的图床管理方案-Cloudflare图床+MCP+Skills方案指南 - bingo彬哥 化繁为简:顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量 - HarmonyOS_SDK 从零实现富文本编辑器#13-React非编辑节点的内容渲染 - WindRunnerMax AI开发-python-langchain框架(3-23-OpenAI Functions风格Tool Calling智能助手) - 万笑佛 .NET + AI 进阶实战:基于类的技能开发 - 打造可治理的 Agent 能力模块 - NetCoreKevin 【从0到1构建一个ClaudeAgent】规划与协调-技能 - 程序员Seven 上周热点回顾(4.6-4.12) - 博客园团队 电子小白的工具三件套:面包板、杜邦线、万能板 - Tlink 单表五亿数据的查询优化 | Mysql、StarRocks - 痴者工良 WorkBuddy:从“我是谁”到“帮我干活” - 岳小哥AI C# 如何减少代码运行时间:7 个实战技巧 - 码农刚子 基于HelixToolkit.SharpDX 渲染3D模型 - 笺上知微 从零开始的双臂具身VLA起源及现阶段发展综述 - SkyXZ 记对 xonsh shell 的使用, 脚本编写, 迁移及调优 - pluvium27 受够了Vibe Coding的失控?换个起点,让AI事半功倍 - 海滨code 从开始配置漏洞环境到漏洞复现流程 - 難しい 关于10年工作经验的程序员对OpenClaw的实战经验分享以及看法 - 虚无境 Any metadata 的内存布局 - chaoguo1234 C# .NET 周刊|2026年3月2期 - InCerry 我帮你测过了,测试圈排名第二的 Skill 依然很牛逼 Skill Discovery | 无监督技能发现的经典工作总结 - MoonOut PbootCMS 网站内容数量多导致访问慢?这些实用优化方案帮你提速! - 家兴网络技术工作室 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 网站漏洞怎么发现并修复?一篇实用指南(附完整流程) - 家兴网络技术工作室 开了 TUN 模式还是直连?90% 的人都踩过这个坑 Github日报|2026年04月12日 - AI一族 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术 Etsy 把 1000 个 MySQL 分片迁进 Vitess:425TB 数据背后的真正问题不是性能,而是运维规模 - ChatInfo MicroPython LVGL基础知识和概念:底层渲染与性能优化 - FreakStudio 数据库草图算法 Python 潮流周刊#146:CPython 引入 Rust 的进展 - 豌豆花下猫 最小生成树 - mofei1116 红日靶场七:从外网入口、容器逃逸到 AD 接管的完整利用链复盘 - YouDiscovered1t 分享四款开源且实用的 Kafka 管理工具 - 追逐时光者 vLLM 权重加载机制全解析:从挑战到理想架构 LCT 学习笔记 - ACehomoxue Avalonia UI 12.0.0 正式发布:架构演进和性能飞跃 - 张善友 当 AI Agent 把调用链拉长,延迟开始成为一门生意 - ChatInfo conhost.exe 无法显示 U+2717 - 145a 太秀了,我把自己蒸馏成了 Skill!已开源 - 程序员鱼皮 ASP.NET Core 内存缓存实战:一篇搞懂该怎么配、怎么避坑 基于 Ghostty 带有分割标签页和为 Claude 编程设计的通知终端 - BugShare AI 焊死入口:教育的“操作系统级”重塑 - 郝hai 初级Java开发工程师使用sql脚本编写代码的过程是简单而且不糊涂 - CoderOilStation Claude Code通关手册(六):MCP协议完全指南 - 暮色之狐 边框灯光环绕动画特效实现指南 - Newbe36524 开源:子木蒸馏版的 SEO 审计工具 seo-audit-skill v1.0 我所理解的Python元模型 - Artech 【从0到1构建一个ClaudeAgent】规划与协调-TodoWrite - 程序员Seven Claude 和 Codex 在审计 Skill 上性能差异探究 - ACai_sec AScript如何实现中文脚本引擎 - rockey627 【渗透测试】HTB Season10 Garfield 全过程wp - dynasty_chenzi Android 开发者为什么必须掌握 AI 能力?端侧视角下的技术变革 树状数组正确性证明 - AC-wyr 你的 AI 焦虑,可能比 AI 本身更危险——ATM 机没有消灭银行柜员,但恐慌消灭了你的判断力 - 我没有三颗心脏 一个拉胯的分库分表方案有多绝望?整个部门都在救火! - 冰河团队 动态规划入门必学之走方格问题 - Ofnoname PostgREST 与 PostgreSQL 角色权限配置全解析(生产级实践) - SheepDog1998 使用 UEFI 图形输出协议 GOP 在屏幕上显示图像的方法 - 阿源- Claude Code通关手册(五):组建你的AI专家团队,子代理系统 - 暮色之狐 一个程序员到架构师的催婚路之感悟(整整10年后的催婚相亲感悟) - MisterLip 用 Agent Skill 自动生成工作周报 - 赵康
.NET Core自定义 ALC 中启动WebHost的HostingStartup解析异常
Jeffcky · 2026-06-14 · via 博客园_首页

问题场景

在 .NET Core插件系统中,插件程序集通过自定义 AssemblyLoadContext(ALC)加载,与宿主程序的 Default ALC 保持隔离。当插件内部若需要自托管一个 Web 服务,调用 Host.CreateDefaultBuilder() 启动 WebHost 时,此时必然会出现一条致命异常:

1

异常被捕获,但应用仍能正常运行,所以看起来只是一条日志污染,但它却出现 crit 级别,难免让我们心生疑惑。

机制背景

HostingStartup 是什么

IHostingStartup 是 ASP.NET Core 提供的启动扩展点。标记 [assembly: HostingStartup] 特性的程序集,会在构建 IWebHostBuilder 时被自动加载并执行,允许外部组件在启动阶段注入服务和中间件,无需修改应用代码、也不需要应用显式依赖这些组件。这是 Azure 等 PaaS 平台实现零侵入集成的核心机制。典型场景:

可观测性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 完全无感知。

冲突链路

image

源码分析

GenericWebHostBuilder.ExecuteHostingStartups() 的实际实现

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级别日志。

异常复现

第一步:创建控制台宿主程序

新建 .NET 控制台项目 ConsoleApp。宿主需要两件事:启动WebHost,然后通过自定义 ALC 加载插件并调用其初始化方法。

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>

第二步:创建测试插件类库

新建 .NET 类库项目TestLib,引用Microsoft.AspNetCore.App框架。

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");
    }
}

第三步:启动控制台程序

2

TestLib in Default ALC: False —— 插件确实只存在于自定义 ALC;异常来自GenericWebHostBuilder.ExecuteHostingStartups()→Assembly.Load()—— Default ALC 中找不到 TestLib

解决方案

在插件的 ConfigureWebHostDefaults 中,排除自身程序集:

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();

WebHostOptions 在构建待加载列表时先执行 assemblies.Except(excludeAssemblies),再交给 ExecuteHostingStartups。排除发生在 Assembly.Load() 之前,加载尝试根本不会触发。

令人疑惑的API

直觉上我们可能想直接清空 HostingStartupAssemblies

webBuilder.UseSetting(
    WebHostDefaults.HostingStartupAssembliesKey, "");  // 无效

但在 WebHostBuilder 内部,配置会按以下优先级合并:

AddInMemoryCollection(_settings)     ← UseSetting 写入(低优先级)
   .AddConfiguration(hostConfig)     ← 环境变量在此(高优先级)

_settings 中的空值被 hostConfig 中的环境变量覆盖,因此 UseSetting 无法清空由环境变量注入的值。而 HostingStartupExcludeAssemblies 没有对应的环境变量,UseSetting 写入的值不会被覆盖。

总结

FileNotFoundException: Could not load file or assembly 'TestLib'——ASP.NET Core 尝试在 Default ALC 中加载 TestLib 作为 HostingStartup 程序集,但没找到。这个失败的后果仅仅是一条 crit 日志,以及 IHostingStartup.Configure() 不会被调用。循环中的其他程序集不受影响,StartupFilter 链不受影响,WebHost 正常启动。换句话说:如果我们不依赖 Configure() 来做任何业务初始化,输出的致命异常日志对应用没有任何实质性影响。

参考链接

https://github.com/dotnet/aspnetcore/issues/17098

https://github.com/dotnet/aspnetcore/issues/21159

https://github.com/dotnet/runtime/issues/37584