.NET6项目引用.NET Core3.1 EF Core项目遇Npgsql类型加载异常求助

问题场景 #

我有两个EF Core项目：

• 项目A：目标框架为.NET 6.0，引用包如下：

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.11" />
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="6.0.11" />
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="6.0.7" />

• 项目B：目标框架为.NET Core 3.1，引用包如下：

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="2.2.6" />
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="2.2.4" />

将B引用到A后编译正常，但在A中解析B的上下文时抛出异常：

System.TypeLoadException
Could not load type 'Microsoft.EntityFrameworkCore.NpgsqlDbContextOptionsExtensions' from assembly 'Npgsql.EntityFrameworkCore.PostgreSQL, Version=6.0.7.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7'.

问题原因 #

这是.NET程序集加载机制导致的：当高版本项目A引用低版本项目B时，运行时会优先加载A依赖的高版本Npgsql程序集，而B的DbContext代码是基于低版本Npgsql编译的——低版本中的NpgsqlDbContextOptionsExtensions类型在高版本程序集中可能已被重命名、移动命名空间，或者类型结构发生了破坏性变更，导致运行时无法在高版本程序集中找到B代码需要的类型，最终抛出TypeLoadException。

简单来说：B需要的是低版本包中的特定类型，但运行时给它的是高版本包的程序集，两者类型定义不匹配。

不升级B/不降级A的解决方案 #

方案1：使用AssemblyLoadContext隔离依赖 #

通过.NET的AssemblyLoadContext创建独立的加载上下文，专门加载B项目及其依赖的低版本EF Core、Npgsql程序集，让A的高版本依赖和B的低版本依赖完全隔离，互不干扰。

具体实现步骤：

1. 在A项目中添加对System.Runtime.Loader包的引用（如果未引用）。
2. 创建自定义的AssemblyLoadContext：

using System.Runtime.Loader;
using System.IO;

public class BProjectLoadContext : AssemblyLoadContext
{
    private readonly string _dependencyPath;

    public BProjectLoadContext(string dependencyPath) : base(isCollectible: true)
    {
        _dependencyPath = dependencyPath;
    }

    protected override Assembly Load(AssemblyName assemblyName)
    {
        // 优先从B项目的依赖目录加载低版本程序集
        string assemblyPath = Path.Combine(_dependencyPath, $"{assemblyName.Name}.dll");
        if (File.Exists(assemblyPath))
        {
            return LoadFromAssemblyPath(assemblyPath);
        }
        // 其他程序集回退到默认加载上下文
        return null;
    }
}

3. 使用该上下文加载B的程序集并实例化DbContext：

// 指定B项目输出目录（或包含低版本依赖的目录）
string bProjectDir = @"path\to\projectB\bin\Debug\netcoreapp3.1";
var loadContext = new BProjectLoadContext(bProjectDir);

// 加载B的程序集
Assembly bAssembly = loadContext.LoadFromAssemblyPath(Path.Combine(bProjectDir, "ProjectB.dll"));
// 获取DbContext类型
Type dbContextType = bAssembly.GetType("ProjectB.MyDbContext");
// 实例化DbContext（根据B的构造函数调整参数）
var dbContext = Activator.CreateInstance(dbContextType, dbContextOptions);

方案2：修改B项目的DbContext配置（需少量修改B） #

如果允许修改B的代码，可以避免直接使用Npgsql的静态扩展方法，改用手动配置数据库提供程序，减少对特定版本扩展方法的依赖：

在B的DbContext的OnConfiguring方法中，替换原来的UseNpgsql扩展方法，改为直接添加Npgsql提供程序：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Infrastructure;
using Npgsql.EntityFrameworkCore.PostgreSQL.Infrastructure;

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        // 替换原来的 optionsBuilder.UseNpgsql("connectionString")
        optionsBuilder.UseProvider(new NpgsqlOptionsExtension().WithConnectionString("connectionString"));
    }
}

这种方式绕开了对NpgsqlDbContextOptionsExtensions的直接依赖，降低版本冲突的概率，但需要确保B项目的代码能兼容这种写法。

内容的提问来源于stack exchange，提问作者Дмитрий Смирнов