EF Core添加迁移失败及版本兼容异常排查求助

场景1：EF Core 6.0.12 + Pomelo.EntityFrameworkCore.MySql 6.0.2 迁移异常 #

问题表现：VS提示构建失败，CLI无法创建RequestContext对象 #

排查解决步骤： #

• 确保类库与WebAPI项目的目标框架一致（均为.NET 6），跨框架引用会导致构建异常。
• 检查RequestContext的构造函数，必须正确接收DbContextOptions<RequestContext>参数：

  public class RequestContext : DbContext
  {
      public RequestContext(DbContextOptions<RequestContext> options) : base(options)
      {
      }
      // 其他DbSet定义
  }
  

• 在WebAPI的Program.cs中正确注册DbContext，确保读取到连接字符串：

  builder.Services.AddDbContext<RequestContext>(options =>
      options.UseMySql(
          builder.Configuration.GetConnectionString("YourConnectionStringName"),
          new MySqlServerVersion(new Version(8, 0, 28)) // 替换为你的MySQL版本
      ));
  

• 执行迁移时明确指定启动项目和DbContext所在项目（因为DbContext在类库，需要WebAPI提供配置）：
  • Package Manager Console命令：

    add-migration Katje-Init -StartupProject YourWebApiProjectName -Project YourDbContextLibraryName
    

  • .NET CLI命令：

    dotnet ef migrations add Katje-Init --startup-project ../YourWebApiProject --project .
    

• 清理NuGet缓存并重建解决方案：
  1. 删除所有项目的bin、obj文件夹
  2. 执行命令清理缓存：dotnet nuget locals all --clear
  3. 重新构建整个解决方案

场景2：升级至.NET 7 + MySql.EntityFrameworkCore 6.0.7 出现MissingMethodException #

问题根源：版本不兼容 #

MySql.EntityFrameworkCore 6.x是适配.NET 6的版本，升级到.NET 7后，EF Core 7的API已发生变化（例如RelationalStrings.NoConnectionOrConnectionString方法被移除/重命名），旧驱动调用不存在的方法导致异常。

解决步骤： #

• 卸载旧版本的MySql.EntityFrameworkCore 6.0.7，安装适配.NET 7的版本（如7.0.5，需与EF Core 7.x版本严格对应）。
• 修正WebAPI中DbContext的注册代码（MySql.EntityFrameworkCore 7.x使用UseMySQL方法）：

  builder.Services.AddDbContext<RequestContext>(options =>
      options.UseMySQL(
          builder.Configuration.GetConnectionString("YourConnectionStringName"),
          new MySqlServerVersion(new Version(8, 0, 28))
      ));
  

• 重复场景1中的缓存清理和重建步骤，确保所有依赖包都是最新兼容版本。

通用迁移排查准则 #

• 版本严格匹配：.NET版本、EF Core版本、MySQL驱动版本必须一一对应（如.NET 6 ↔ EF Core 6 ↔ Pomelo/MySql.EntityFrameworkCore 6；.NET 7 ↔ EF Core 7 ↔ Pomelo/MySql.EntityFrameworkCore 7）。
• 先解决构建错误：迁移依赖成功构建的项目，若VS提示构建失败，优先修复编译错误（如缺失引用、语法错误、配置文件问题）。
• 禁止无参DbContext构造：迁移时EF Core需要通过依赖注入获取配置，必须保留接收DbContextOptions<T>的构造函数，不要仅保留无参构造。

内容的提问来源于stack exchange，提问作者Wim ten Brink