C# .NET应用引用第三方库缺失时启动异常，如何友好提示用户？

因为.NET程序在启动阶段加载依赖库时发生的错误，无法通过主程序内的try/catch捕获，可通过以下几种方式处理：

方法1：拆分程序，做启动引导器 #

• 编写一个不依赖第三方库的轻量引导程序（控制台或WinForms均可）作为主入口
• 引导程序先执行依赖检查：
  • 检查对应程序的注册表安装信息
  • 验证系统目录或指定路径下是否存在目标DLL文件
• 检查通过则启动业务主程序；不通过则弹出提示告知用户需安装依赖程序

示例引导程序核心代码（WinForms）：

using System;
using System.Diagnostics;
using System.IO;
using System.Windows.Forms;

namespace Bootstrapper
{
    static class Program
    {
        [STAThread]
        static void Main()
        {
            bool isDependencyInstalled = CheckDependency();
            if (!isDependencyInstalled)
            {
                MessageBox.Show("请先安装XXX程序，否则本应用无法正常运行。", "依赖缺失", MessageBoxButtons.OK, MessageBoxIcon.Warning);
                return;
            }

            // 启动主业务程序
            Process.Start("YourMainApp.exe");
        }

        private static bool CheckDependency()
        {
            // 示例1：检查注册表项
            // var regKey = Microsoft.Win32.Registry.LocalMachine.OpenSubKey(@"SOFTWARE\XXX\InstallPath");
            // if (regKey == null) return false;
            // string installPath = regKey.GetValue("Path") as string;
            // return File.Exists(Path.Combine(installPath, "ThirdParty.dll"));

            // 示例2：检查系统目录中的DLL
            string dllPath = Path.Combine(Environment.SystemDirectory, "ThirdParty.dll");
            return File.Exists(dllPath);
        }
    }
}

方法2：使用延迟加载规避启动时加载 #

• 将第三方库的引用改为延迟加载，避免启动阶段直接加载依赖
• 操作步骤：
  1. 在项目引用中找到第三方库，右键设置复制本地为False，若为COM库则开启嵌入互操作类型
  2. 使用System.Lazy<T>或手动在业务代码需要时加载DLL，并在外层添加try/catch捕获加载失败
• 注意：主程序启动时不能有任何直接依赖该库的代码（如全局变量、静态构造函数中引用库类型）

示例延迟加载代码：

private static Lazy<ThirdPartyClass> _lazyThirdParty = new Lazy<ThirdPartyClass>(() =>
{
    try
    {
        return new ThirdPartyClass();
    }
    catch (DllNotFoundException)
    {
        MessageBox.Show("请安装XXX程序后再运行本应用。", "依赖缺失", MessageBoxButtons.OK, MessageBoxIcon.Error);
        Environment.Exit(1);
        return null;
    }
});

// 业务代码中调用
var thirdPartyInstance = _lazyThirdParty.Value;

方法3：通过程序集解析事件捕获加载失败（.NET Framework适用） #

• 在app.config中配置程序集绑定，同时注册AppDomain.CurrentDomain.AssemblyResolve事件捕获加载失败
• 核心代码：

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)
{
    // 匹配目标缺失的程序集名称
    if (args.Name.StartsWith("ThirdPartyAssemblyName,"))
    {
        MessageBox.Show("请先安装XXX程序，否则本应用无法正常运行。", "依赖缺失", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        Environment.Exit(1);
    }
    return null;
}

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