.NET Framework程序启动前第三方DLL被加载抛出异常的解决咨询

异常原因 #

CLR在main()执行前加载第三方DLL的核心原因：

• 当项目直接引用该DLL，且代码中直接声明了DLL内的类型（比如作为类的静态成员、全局变量，或入口类方法的参数/返回值）时，CLR会在JIT编译入口类的阶段提前加载依赖程序集。
• 若引用的Copy Local属性设为True，CLR会在应用启动时自动解析所有直接引用的程序集，触发提前加载逻辑，导致自定义的DLL检测代码根本无法执行。

规避方案与延迟加载实现 #

1. 移除项目直接引用，改用动态加载 #

这是彻底避免CLR提前加载的最可靠方式，通过反射在需要使用功能时手动加载DLL：

using System.IO;
using System.Reflection;
using System.Windows.Forms;

// 在需要调用第三方DLL功能的位置执行以下逻辑
if (File.Exists("FTD2XX_NET.dll"))
{
    // 加载目标DLL
    var assembly = Assembly.LoadFrom("FTD2XX_NET.dll");
    // 获取要使用的类型（替换为实际类名）
    var ftdiType = assembly.GetType("FTDI.FTD2XX");
    // 创建类型实例
    var ftdiInstance = Activator.CreateInstance(ftdiType);
    // 反射调用目标方法（替换为实际方法名和参数）
    var targetMethod = ftdiType.GetMethod("Open");
    targetMethod.Invoke(ftdiInstance, null);
}
else
{
    MessageBox.Show("缺少FTD2XX_NET.dll，请安装对应驱动后重试");
}

注意：代码中不能直接声明该DLL的类型（比如FTDI.FTD2XX ftdi;），否则CLR仍会触发提前加载。

2. 利用AppDomain.AssemblyResolve事件拦截加载 #

如果必须保留项目引用，可在main()最开头注册AssemblyResolve事件，拦截CLR的加载请求，手动处理DLL缺失情况：

using System;
using System.IO;
using System.Reflection;
using System.Windows.Forms;

[STAThread]
static void Main()
{
    // 必须在所有业务代码前注册事件
    AppDomain.CurrentDomain.AssemblyResolve += CurrentDomain_AssemblyResolve;
    
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new MainForm());
}

private static Assembly CurrentDomain_AssemblyResolve(object sender, ResolveEventArgs args)
{
    // 匹配目标DLL的名称标识
    if (args.Name.StartsWith("FTD2XX_NET, Version=1.1.0.0"))
    {
        string dllPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "FTD2XX_NET.dll");
        if (File.Exists(dllPath))
        {
            return Assembly.LoadFrom(dllPath);
        }
        else
        {
            MessageBox.Show("缺少FTD2XX_NET.dll，请安装对应驱动后重试");
            Environment.Exit(1);
            return null;
        }
    }
    return null;
}

该方法能在CLR加载失败时触发自定义逻辑，但需确保事件注册在所有可能触发加载的代码之前。

3. 拆分依赖代码到独立类库 #

将依赖第三方DLL的代码单独封装到一个类库项目中，主项目不直接引用这个类库，而是通过动态加载类库的方式调用功能，这样主项目启动时不会触发目标DLL的加载。

捕获启动阶段的加载异常 #

若需要处理main()执行前的未捕获加载异常，可注册AppDomain.UnhandledException事件做兜底处理：

private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    if (e.ExceptionObject is FileNotFoundException ex && ex.FileName.Contains("FTD2XX_NET"))
    {
        MessageBox.Show("缺少FTD2XX_NET.dll，请安装对应驱动后重试");
        Environment.Exit(1);
    }
}

注册位置同样需放在main()的最开头。

内容的提问来源于stack exchange，提问作者jemiah