.NET Core控制台与WebAPI加载数据库特殊字符差异问题排查

API 探路者

2026-5-19

我之前也碰到过一模一样的问题！其实核心原因是控制台应用和WebAPI的编码处理逻辑完全不同——WebAPI的运行环境（Kestrel/IIS）默认就用UTF-8编码，EF Core在Web场景下会自动适配这种编码环境；但控制台应用的默认编码、MySQL驱动的编码配置都没对齐，才导致同一DbContext读出的特殊字符乱码。

具体原因拆解

WebAPI的请求/响应管道默认强制UTF-8，EF Core的MySQL驱动在这个环境下会自动采用UTF-8读取数据；
你用的MySql.Data.EntityFrameworkCore 6.10.6是比较旧的版本，这个版本的驱动在控制台环境下不会自动继承系统的UTF-8设置，默认可能用Latin1或其他编码读取MySQL数据；
Windows控制台默认代码页是GBK（936），哪怕你设置了Console.OutputEncoding，如果读取数据时编码就错了，输出再改编码也没用。

解决步骤（按优先级来）

1. 给MySQL连接字符串显式指定编码

这是最关键的一步！旧版本MySQL驱动不会自动用UTF-8连接数据库，必须在连接字符串里加上CharSet=utf8mb4（支持所有Unicode字符，包括emoji）或者CharSet=utf8：

"Server=你的服务器地址;Database=你的数据库;Uid=用户名;Pwd=密码;CharSet=utf8mb4;"

这样EF Core读取数据时就会用UTF-8编码，从源头上避免乱码。

2. 完整配置控制台的输入输出编码

不要只设置Console.OutputEncoding，把输入编码也改成UTF-8，而且要放在程序启动的最开头：

using System.Text;

namespace YourConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // 必须放在最前面，早于DbContext初始化
            Console.InputEncoding = Encoding.UTF8;
            Console.OutputEncoding = Encoding.UTF8;
            
            // 后续的DbContext操作代码
            var context = new YourDbContext();
            // ...
        }
    }
}

另外，Windows控制台默认代码页是GBK，你可以先手动运行命令chcp 65001切换到UTF-8代码页，再启动程序；或者在代码里通过调用系统命令切换（注意部分环境可能需要管理员权限）：

System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("cmd.exe", "/c chcp 65001") { CreateNoWindow = true }).WaitForExit();

3. 验证EF Core实体的Unicode配置

确保存储特殊字符的属性被配置为Unicode类型（对应MySQL的utf8mb4列）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<YourEntity>()
        .Property(e => e.YourSpecialCharProperty)
        .IsUnicode(true); // 确保启用Unicode支持
}

如果你的MySQL列已经是utf8mb4类型，这一步可能不是必须的，但旧版本驱动偶尔会忽略默认配置，加上更稳妥。

4. 升级MySQL驱动版本（可选但推荐）

6.10.6是比较老旧的版本了，后续官方迁移到MySql.EntityFrameworkCore后修复了很多编码相关的bug。如果你的.NET Core 2.0环境允许，升级到兼容的最新稳定版，可能直接解决这类编码问题（注意：.NET Core 2.0的支持已经终止，优先考虑升级项目到更高版本的.NET，再升级驱动）。

内容的提问来源于stack exchange，提问作者P.N.