.NET Framework 4.8控制台程序依赖程序集放子目录启动失败排查

问题背景 #

你将托管依赖DLL移至lib子目录后，通过App.config添加<probing>配置仍触发FileNotFoundException，核心原因是<probing>的生效范围或依赖类型不匹配，以下是具体排查和解决办法：

1. 检查是否包含非托管依赖 #

<probing>仅对托管.NET程序集生效，若a.dll/b.dll是非托管（原生）DLL，Windows加载器不会遵循该配置，只会在系统路径、exe目录、当前工作目录查找。

解决方式：

• 若为非托管DLL，可在程序启动时手动设置加载路径：

using System.Runtime.InteropServices;
using System.IO;

class Program
{
    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern bool SetDllDirectory(string lpPathName);

    static void Main(string[] args)
    {
        // 指向lib子目录
        SetDllDirectory(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "lib"));
        // 后续业务逻辑
    }
}

• 或临时将非托管DLL放回exe同目录验证是否为此问题。

2. 确认所有托管依赖已放入lib #

使用工具检查referenced.dll的完整依赖链：

• 打开Visual Studio开发者命令提示符，运行：

dumpbin /dependents referenced.dll

确保输出的所有托管DLL都已复制到lib子目录中。

3. 验证配置文件正确性 #

• 确认my_console_app.exe.config与exe在同一目录，且内容和修改后的App.config一致。
• 在Visual Studio中，右键App.config→属性，设置复制到输出目录为「始终复制」或「如果较新则复制」。

4. 查看程序集绑定日志定位具体错误 #

使用fuslogvw.exe（程序集绑定日志查看器）获取详细加载失败信息：

• 打开Visual Studio开发者命令提示符，输入fuslogvw.exe启动工具。
• 勾选「启用程序集绑定失败日志」，选择「日志到磁盘」。
• 重新运行程序，查看生成的日志，明确是哪个程序集加载失败。

替代方案：使用<codeBase>指定特定程序集路径 #

若依赖为强名称托管程序集，可直接为单个程序集指定加载路径：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <probing privatePath="lib" />
            <!-- 替换为实际的程序集名称、公钥令牌和版本 -->
            <dependentAssembly>
                <assemblyIdentity name="a" publicKeyToken="xxxxxx" culture="neutral" />
                <codeBase version="1.0.0.0" href="lib/a.dll" />
            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>

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