EF Core连接MySQL排序规则不一致问题及解决方案咨询

这绝对不是EF Core的锅——核心矛盾出在两台机器的MySQL默认编码/排序规则配置不一致，再加上EF Core 2.x版本默认不会在迁移中明确指定字符集，才导致了多语言插入的异常。

为什么会出现这个问题？ #

• 你的机器MySQL默认用了latin1编码，这种单字节编码完全不支持中日西等多语言字符，插入这类内容自然会抛出异常；另一台机器用的utf8（准确说是MySQL的utf8mb3，最多支持3字节字符）能覆盖大部分多语言场景，所以运行正常。
• EF Core 2.x在生成迁移时，不会主动给表或列指定字符集/排序规则，完全依赖MySQL的全局默认配置，这就导致不同环境下生成的数据库结构不一致。

彻底解决的步骤 #

1. 统一MySQL全局默认编码（从根源避免环境差异） #

修改MySQL的配置文件（Linux是my.cnf，Windows是my.ini），添加以下配置，确保新创建的数据库默认使用真正的UTF-8（utf8mb4，支持4字节字符，涵盖所有语言和emoji）：

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

修改后重启MySQL服务，这样后续新建的数据库都会默认使用正确的编码和排序规则。

2. 修复已存在的数据库和表 #

如果已经有创建好的数据库，手动执行SQL修改编码：

-- 修改数据库编码
ALTER DATABASE YourDatabaseName CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 修改现有表的编码（逐个表执行）
ALTER TABLE YourTableName CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 在EF Core中强制指定字符集（让迁移生成统一的结构） #

在你的DbContext的OnModelCreating方法里，通过Fluent API给字符串列指定字符集和排序规则，确保迁移生成的表结构不受MySQL默认配置影响：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 全局配置所有字符串列使用utf8mb4
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        foreach (var property in entityType.GetProperties())
        {
            if (property.ClrType == typeof(string))
            {
                // 根据你的列长度调整，比如varchar(64)
                property.SetColumnType("varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
                // 如果是长文本字段，替换为text类型："text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"
            }
        }
    }

    // 也可以单独配置某个实体的特定列
    // modelBuilder.Entity<YourEntity>()
    //     .Property(e => e.YourMultiLangColumn)
    //     .HasColumnType("varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
}

然后重新生成迁移并更新数据库：

# 生成新的迁移
Add-Migration SpecifyUtf8mb4Collation

# 更新数据库
Update-Database

4. 连接字符串中指定字符集 #

在appsettings.json的连接字符串里加上CharSet=utf8mb4，确保EF Core与MySQL通信时使用正确的字符集：

"ConnectionStrings": {
    "DefaultConnection": "server=localhost;database=YourDb;user=root;password=YourPassword;CharSet=utf8mb4;"
}

额外说明：为什么用utf8mb4而不是utf8？ #

MySQL自带的utf8实际上是utf8mb3，最多只能存储3字节的字符，无法支持一些生僻汉字、emoji等4字节字符。utf8mb4才是真正符合标准的UTF-8编码，能覆盖所有语言场景，建议优先使用。

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