C# 连接 MySQL 插入中文数据乱码的解决方案

问题现象

当使用 C# 向 MySQL 数据库插入包含中文字符的数据，或者从数据库读取中文内容时，如果字符集设置不正确，数据通常会显示为乱码（如 "???" 或不可识别符号）。这是因为 .NET 默认可能与 MySQL 使用的默认字符集（如 latin1）不匹配，而现代 Web 应用通常统一使用 UTF-8 编码。

解决方法

要解决这个问题，核心在于确保 C# 程序与 MySQL 服务器之间沟通时使用相同的字符集，通常推荐使用通用的 utf8 或 utf8mb4。以下是两种经过验证的操作方案：

第 1 步：在连接命令中动态设置字符集

如果你使用的是 MySqlCommand 对象来执行操作，可以在执行任何数据操作之前，先发送一条设置字符集的 SQL 指令。这种方法适用于已经建立了连接但尚未初始化字符集的场景。

1. 目的：在当前的数据库会话中指定使用的字符编码。
2. 入口：MySqlConnection 已建立连接。
3. 动作：创建一个新的 MySqlCommand，其 CommandText 设置为 "SET NAMES utf8"（注意：现代开发建议使用 utf8mb4 以支持生僻字和 Emoji），并关联现有的连接对象。
4. 完成状态：随后执行的插入或查询语句将自动使用该字符集进行转换。

 // 假设 m_Connection 是已打开的 MySqlConnection 实例
 MySQLCommand setCharCmd = new MySQLCommand("SET NAMES utf8", m_Connection);
 setCharCmd.ExecuteNonQuery(); 
 // 此时再执行你的 Insert/Select 命令即可正确显示中文

第 2 步：在连接字符串中直接指定 Charset（推荐）

这是一种更简洁且更稳健的方法。通过在定义数据库连接配置（如 Web.config 或 App.config，或在代码中构建连接字符串时）直接添加 charset 属性，可以一劳永逸地解决所有会话中的编码问题。

1. 目的：强制客户端在建立连接时立即协商使用 UTF-8 编码。
2. 入口：修改项目的配置文件或连接字符串变量。
3. 动作：在 connectionString 字符串末尾追加或添加 Charset=utf8 参数。
4. 重要参数：Charset 的值应设为 utf8 或 utf8mb4。

// 示例：在 config 文件或代码中使用
<add name="dbConnection" 
     connectionString="server=127.0.0.1;database=test;user=root;password=root;Charset=utf8;" 
     providerName="MySql.Data.MySqlClient" />

// 或者在 C# 代码中拼接：
string connStr = $"Server=127.0.0.1;Database=test;Uid=root;Pwd=root;Charset=utf8;";

注意：如果你需要存储表情符号或更多样的 Unicode 字符，请将 charset=utf8 替换为 charset=utf8mb4。虽然名称仍是 utf8，但在 MySQL 驱动中它代表真正的 4 字节 UTF-8 编码。

完成判断

完成上述任一配置后，重新启动或重新加载应用程序的配置。尝试插入一段包含多种中文汉字的数据到数据库中，并从前端或调试窗口读取该数据。如果显示的汉字清晰准确，无乱码符号，即表示问题解决。

简要总结

C# 操作 MySQL 中文乱码的本质是编码协商失败。Set Names 适合临时调整或脚本式操作，而连接字符串中设置 Charset 则是项目级最佳实践，因为它确保了连接的起点就是正确的编码环境，减少了因遗忘执行设置语句而产生的错误。建议在日常开发中统一将数据库及连接层的编码标准设定为 utf8mb4。

以上就是C#连接MySQL插入中文数据乱码的详细解决内容，更多关于数据库编程优化的资料请关注本站其它相关文章！