添加MySql.EntityFrameworkCore 7至.NET Core 6项目后遇MSB3246错误

问题根源 #

你遇到的MSB3246警告，是因为MySQL.Data（或MySql.EntityFrameworkCore）包中的comerr64.dll是原生C/C++库，并非.NET程序集，但它被错误放置在NuGet包的lib/net6.0目录下。MSBuild在解析程序集引用时，会扫描该目录下所有文件并尝试读取.NET程序集元数据，原生库没有这类元数据，因此触发警告。

可行解决方案 #

1. 让MSBuild跳过原生库的元数据解析 #

在项目的.csproj文件中添加以下配置，全局禁用原生镜像文件的元数据检查：

<PropertyGroup>
  <ResolveAssemblyReferenceIgnoreNativeImageReferences>true</ResolveAssemblyReferenceIgnoreNativeImageReferences>
</PropertyGroup>

这个配置会直接阻止MSBuild尝试解析原生库的程序集信息，从根源消除警告。

2. 排除特定错误文件 #

如果只想针对comerr64.dll处理，可在PackageReference中添加排除规则：

<ItemGroup>
  <!-- 针对MySQL.Data包 -->
  <PackageReference Include="MySql.Data" Version="8.0.32">
    <ExcludeAssets>comerr64.dll</ExcludeAssets>
  </PackageReference>

  <!-- 若使用MySql.EntityFrameworkCore，替换为下面的配置 -->
  <PackageReference Include="MySql.EntityFrameworkCore" Version="8.0.32">
    <ExcludeAssets>comerr64.dll</ExcludeAssets>
  </PackageReference>
</ItemGroup>

3. 替换为社区维护的Pomelo包 #

官方MySQL EF Core包偶尔会有这类配置问题，推荐使用社区维护的Pomelo.EntityFrameworkCore.MySql，它更轻量化且配置更规范：

• 先移除原有的MySQL相关包：

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

• 添加Pomelo包：

dotnet add package Pomelo.EntityFrameworkCore.MySql

• 更新DbContext配置（以Program.cs为例）：

builder.Services.AddDbContext<YourDbContext>(options =>
    options.UseMySql(
        builder.Configuration.GetConnectionString("DefaultConnection"),
        new MySqlServerVersion(new Version(8, 0, 32))
    )
);

关于是否可忽略警告 #

短期可以忽略——警告不影响项目编译和运行，程序运行时会正确加载comerr64.dll。但长期建议修复，避免构建日志被无关警告干扰，同时防止后续版本更新时引发其他潜在问题。

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