0

0

C# AssemblyLoadContext使用方法 C#如何隔离和卸载插件

畫卷琴夢

畫卷琴夢

发布时间:2026-02-04 10:05:39

|

748人浏览过

|

来源于php中文网

原创

AssemblyLoadContext 可卸载程序集但需满足严格条件:构造时设 isCollectible = true,避免强引用、静态字段、线程或 Finalizer;.NET Core 3.0+ 支持,Framework 不支持。

c# assemblyloadcontext使用方法 c#如何隔离和卸载插件

AssemblyLoadContext 能否真正卸载程序集

不能直接卸载,但可以卸载整个 AssemblyLoadContext 实例及其加载的所有程序集——前提是该上下文是“可卸载的”(isCollectible = true),且其中没有强引用、静态字段、线程或 Finalizer 持有对象。.NET Core 3.0+ 支持此机制,.NET Framework 不支持。

常见错误现象:AssemblyLoadContext.Unload() 返回后,内存未释放、类型仍可访问、GC 不回收上下文对象。

  • 必须在构造时传入 true:new AssemblyLoadContext(true)
  • 不能在默认上下文(AssemblyLoadContext.Default)中加载插件——它不可卸载
  • 插件内不能调用 typeof(...).Assembly 并跨上下文缓存类型,否则会隐式持有引用
  • 插件导出的接口类型必须定义在主程序集(或共享的、由默认上下文加载的程序集)中

如何安全加载和调用插件类型

核心原则:所有跨上下文交互必须通过接口(而非具体类型),且接口定义必须由主程序集提供。插件只负责实现,不参与类型定义。

使用场景:动态加载 DLL 插件,执行某方法后卸载,避免程序集锁定和内存泄漏。

幻舟AI
幻舟AI

专为短片创作者打造的AI创作平台

下载
  • 主程序定义公共接口,如 IPluginvoid Execute()
  • 插件项目引用主程序集(仅用于编译,运行时不复制)
  • 用自定义 AssemblyLoadContext 加载插件 DLL:
    var context = new AssemblyLoadContext(pluginPath, isCollectible: true);
    var assembly = context.LoadFromAssemblyPath(pluginPath);
    var pluginType = assembly.GetType("MyPlugin");
    var plugin = Activator.CreateInstance(pluginType) as IPlugin;
  • 调用完成后,显式调用 context.Unload(),然后等待 GC 回收(可手动 GC.Collect(); GC.WaitForPendingFinalizers(); 辅助验证)

为什么插件里 new Thread 或 Timer 会导致卸载失败

因为线程、定时器回调、事件订阅、静态 Action/Func 等都会在后台维持对插件上下文中类型的强引用,使 AssemblyLoadContext 无法被 GC 回收。

典型错误代码:

public class MyPlugin : IPlugin {
    private Timer _timer;
    public void Execute() {
        _timer = new Timer(_ => { Console.WriteLine("tick"); }, null, 0, 1000);
    }
}

  • Timer 回调委托捕获了插件实例,而该实例类型来自插件上下文,导致上下文无法卸载
  • 解决方案:在 Execute() 前或 Unload() 前主动 _timer?.Dispose()
  • 更稳妥做法:插件实现 IDisposable,主程序在 Unload() 前先调用 plugin.Dispose()
  • 避免在插件中启动长期存活线程;如需后台任务,改用主程序托管的 Task + 取消令牌

调试卸载失败的常见手段

context.Unload() 后上下文仍存活,说明仍有根引用未清理。这不是黑盒问题,有明确排查路径。

  • 用 Visual Studio 的“调试 → Windows → .NET Object Allocation Tracking”观察上下文对象是否被回收
  • 用 dotMemory 或 dotTrace 快照比对:卸载前后搜索 AssemblyLoadContext 实例数量
  • 检查插件中是否用了 AppDomain.CurrentDomain.AssemblyResolve 或自定义 AssemblyLoadContext.Default.Load 回调——这些委托可能跨上下文泄露
  • 确保插件 DLL 没被其他地方(如 Assembly.GetExecutingAssembly()、日志框架反射扫描)意外加载进默认上下文

最常被忽略的一点:插件中的 static readonly Dictionary 缓存,只要键值是插件上下文里的 Type,就会阻止整个上下文回收。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

104

2025.11.27

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1235

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

255

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2192

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

33

2026.01.19

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

588

2023.08.10

Java 并发编程高级实践
Java 并发编程高级实践

本专题深入讲解 Java 在高并发开发中的核心技术,涵盖线程模型、Thread 与 Runnable、Lock 与 synchronized、原子类、并发容器、线程池(Executor 框架)、阻塞队列、并发工具类(CountDownLatch、Semaphore)、以及高并发系统设计中的关键策略。通过实战案例帮助学习者全面掌握构建高性能并发应用的工程能力。

87

2025.12.01

全国统一发票查询平台入口合集
全国统一发票查询平台入口合集

本专题整合了全国统一发票查询入口地址合集,阅读专题下面的文章了解更多详细入口。

37

2026.02.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 8.4万人学习

Excel 教程
Excel 教程

共162课时 | 15.4万人学习

PHP基础入门课程
PHP基础入门课程

共33课时 | 2.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号