.NET6用Pomelo.EntityFrameworkCore.MySql连MySQL报CS1503/CS0121错

• 开发环境：Mac 环境下使用 .NET 6 开发，.NET 6 已移除 Startup.cs 文件，所有配置逻辑统一在 Program.cs 中编写
• 改造目标：项目原本对接 SQL Server 数据库，现计划改造为对接 MySQL，引入 Pomelo.EntityFrameworkCore.MySql 实现数据库连接
• 异常表现：编写数据库上下文配置代码后，编译阶段出现与 serverVersion 相关的报错

使用的配置代码如下：

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");

var serverVersion = new MySqlServerVersion(new Version(8, 0, 28));

builder.Services.AddDbContext<BirdProjectContext>(
    dbContextOptions => dbContextOptions
        .UseMySQL(connectionString, serverVersion)
        // 以下三个选项用于调试，生产环境需移除或调整
        .LogTo(Console.WriteLine, LogLevel.Information)
        .EnableSensitiveDataLogging()
        .EnableDetailedErrors()
);

触发的编译错误分为两类：

1. CS1503 错误：参数 3 无法从 Microsoft.EntityFrameworkCore.MySqlServerVersion 转换为 System.Action<MySql.Data.EntityFrameworkCore.Infrastructure.MySQLDbContextOptionsBuilder> 类型
2. 移除 UseMySQL 方法中的 serverVersion 参数后，触发 CS0121 歧义调用错误：两个不同命名空间下的 UseMySQL 扩展方法重载匹配冲突，分别来自：
   • Microsoft.EntityFrameworkCore.MySQLDbContextOptionsExtensions.UseMySQL（对应命名空间 MySql.Data.EntityFrameworkCore.Infrastructure）
   • Microsoft.EntityFrameworkCore.MySQLDbContextOptionsExtensions.UseMySQL（对应命名空间 MySql.EntityFrameworkCore.Infrastructure）

项目中同时安装了 Oracle 官方推出的两款 MySQL EF Core 包（MySql.Data.EntityFrameworkCore、MySql.EntityFrameworkCore）和 Pomelo 第三方 EF Core 包，三个包都定义了同名的数据库配置扩展方法，导致编译器无法匹配到 Pomelo 包提供的、支持传入 MySqlServerVersion 参数的正确方法重载；同时代码中使用的 UseMySQL（MySQL 全大写）是官方包的方法签名，和 Pomelo 包的方法签名本身就存在差异，进一步加剧了类型匹配错误。

按以下步骤操作即可修复问题：

1. 卸载冲突NuGet包
   仅保留 Pomelo.EntityFrameworkCore.MySql 作为唯一的 MySQL EF Core 提供程序，卸载两个Oracle官方的冲突包，可在NuGet包管理器中操作，或执行以下命令：

   dotnet remove package MySql.Data.EntityFrameworkCore
   dotnet remove package MySql.EntityFrameworkCore
   

2. 清理冗余命名空间引用
   打开 Program.cs 文件，删除顶部所有指向官方MySQL包的using引用，仅保留必要的命名空间：

   // 保留以下引用
   using Microsoft.EntityFrameworkCore;
   using Pomelo.EntityFrameworkCore.MySql.Infrastructure;
   
   // 删除以下两类引用（如果存在）
   // using MySql.Data.EntityFrameworkCore;
   // using MySql.EntityFrameworkCore;
   

3. 修正配置代码
   注意Pomelo包提供的扩展方法名为UseMySql（MySql中s为小写），和官方包的UseMySQL（全大写）不同，修正后的配置代码如下：

   var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
   var serverVersion = new MySqlServerVersion(new Version(8, 0, 28));
   
   builder.Services.AddDbContext<BirdProjectContext>(
       dbContextOptions => dbContextOptions
           .UseMySql(connectionString, serverVersion)
           .LogTo(Console.WriteLine, LogLevel.Information)
           .EnableSensitiveDataLogging()
           .EnableDetailedErrors()
   );
   

4. 重新生成项目
   执行dotnet clean && dotnet build命令重新编译项目，所有编译错误即可消除。

生产环境部署时记得移除EnableSensitiveDataLogging、EnableDetailedErrors这两个调试配置，避免泄露敏感数据、产生额外性能开销。

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