.NET 6动态加载任意程序集的依赖包版本匹配问题求助

方案1：配置程序集绑定重定向 #

在你的.NET 6应用的runtimeconfig.json文件中添加绑定重定向规则，让运行时自动将对目标版本的请求重定向到已安装的兼容版本。示例配置：

{
  "runtimeOptions": {
    "assemblyBinding": {
      "dependentAssembly": [
        {
          "assemblyIdentity": {
            "name": "Microsoft.Data.SqlClient",
            "publicKeyToken": "23ec7fc2d6eaa4a5"
          },
          "bindingRedirect": {
            "oldVersion": "5.0.0.0",
            "newVersion": "5.1.4.0"
          }
        }
      ]
    }
  }
}

注意替换正确的publicKeyToken（可从已安装程序集的属性中查看），该方式适合提前已知常见依赖版本的场景。

方案2：在AssemblyResolve事件中手动匹配兼容版本 #

注册AssemblyLoadContext.Default.Resolving事件，在处理逻辑里遍历NuGet包目录，查找目标程序集的兼容版本，读取版本信息后匹配加载：

AssemblyLoadContext.Default.Resolving += (alc, assemblyName) =>
{
    if (assemblyName.Name != "Microsoft.Data.SqlClient") return null;

    var nugetRoot = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".nuget", "packages", "microsoft.data.sqlclient");
    foreach (var versionDir in Directory.GetDirectories(nugetRoot))
    {
        var assemblyPath = Path.Combine(versionDir, "lib", "net6.0", "Microsoft.Data.SqlClient.dll");
        if (File.Exists(assemblyPath))
        {
            var loadedAssemblyName = AssemblyName.GetAssemblyName(assemblyPath);
            // 仅匹配主版本和次版本，忽略修订号与构建号
            if (loadedAssemblyName.Version.Major == assemblyName.Version.Major && 
                loadedAssemblyName.Version.Minor == assemblyName.Version.Minor)
            {
                return alc.LoadFromAssemblyPath(assemblyPath);
            }
        }
    }
    return null;
};

该方式无需提前知晓具体版本，自动查找NuGet目录下的兼容版本，灵活性更强。

方案3：使用自定义AssemblyLoadContext隔离加载 #

创建自定义AssemblyLoadContext，重写依赖解析逻辑，将动态加载的程序集及其依赖与主应用隔离，避免版本冲突：

public class CustomAssemblyLoadContext : AssemblyLoadContext
{
    private readonly string _nugetPackageRoot = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".nuget", "packages");

    protected override Assembly Load(AssemblyName assemblyName)
    {
        var assembly = base.Load(assemblyName);
        if (assembly != null) return assembly;

        var packageDir = Path.Combine(_nugetPackageRoot, assemblyName.Name.ToLower());
        if (!Directory.Exists(packageDir)) return null;

        foreach (var versionDir in Directory.GetDirectories(packageDir))
        {
            var assemblyPath = Path.Combine(versionDir, "lib", "net6.0", $"{assemblyName.Name}.dll");
            if (File.Exists(assemblyPath))
            {
                var loadedName = AssemblyName.GetAssemblyName(assemblyPath);
                if (IsCompatibleVersion(assemblyName.Version, loadedName.Version))
                {
                    return LoadFromAssemblyPath(assemblyPath);
                }
            }
        }
        return null;
    }

    private bool IsCompatibleVersion(Version requested, Version loaded)
    {
        // 自定义兼容规则：主版本+次版本相同即视为兼容
        return requested.Major == loaded.Major && requested.Minor == loaded.Minor;
    }
}

使用时通过自定义上下文加载用户程序集：

var customAlc = new CustomAssemblyLoadContext();
var userAssembly = customAlc.LoadFromAssemblyPath(@"path\to\DataAccess.dll");

该方案适合复杂场景，能有效隔离不同程序集的依赖，避免影响主应用运行。

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