上周三，我在将老项目的MySQL数据库迁移到MariaDB 10.6时，遭遇了一个令人头疼的问题——系统存入的中文数据全都变成了乱码。作为一名有五年经验的DBA，我本以为这只是简单的字符集配置问题，没想到整个排查过程竟如此曲折。今天就把这次解决问题的完整过程记录下来，希望能帮到遇到同样问题的同行。

第一阶段：问题初现

迁移完成后，我首先注意到用户表中的中文姓名和地址字段显示为"???"和"æ··å·´è¡—é"这样的乱码。最初的直觉告诉我，这肯定是连接字符集的问题。于是我在JDBC连接字符串后加上了熟悉的参数：

java jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8

重启应用后，问题依旧。这让我有些意外，因为在MySQL 5.7上同样的配置一直工作良好。看来MariaDB虽然与MySQL兼容，但在字符集处理上可能有自己的特点。

第二阶段：深入排查

我决定系统地检查整个数据流的字符集配置：

1. 数据库层面检查：
   sql SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%';

   结果发现character_set_server和character_set_database都是latin1，这显然是问题所在。但奇怪的是，我在创建数据库时明确指定了字符集：

   sql CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

   为什么服务器变量没有继承这些设置？

2. 表结构检查：
   sql SHOW CREATE TABLE users;

   表确实使用了utf8mb4字符集，但为什么数据还是乱码？

3. 客户端检查：
   在MariaDB命令行客户端执行插入语句：
   sql INSERT INTO users (name) VALUES ('测试中文');
   查询结果依然显示乱码。

第三阶段：全面解决方案

经过多轮测试，我发现需要从多个层面同时解决这个问题：

1. 服务器级配置修改

编辑MariaDB配置文件（通常是/etc/mysql/mariadb.conf.d/50-server.cnf），在[mysqld]段添加：

ini [mysqld] character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci skip-character-set-client-handshake

关键点说明：
- skip-character-set-client-handshake强制服务器使用配置的字符集，忽略客户端请求
- 需要同时设置character-set-server和collation-server

2. 连接层配置优化

对于JDBC连接，除了之前的参数，还需要确保使用最新驱动：

java jdbc:mariadb://localhost:3306/mydb?useUnicode=yes&characterEncoding=UTF-8&useSSL=false&serverTimezone=UTC

特别注意：
- MySQL Connector/J和MariaDB Java Driver处理字符集的方式不同
- 推荐使用MariaDB官方驱动（版本2.7+）

3. 客户端工具配置

对于命令行客户端，在/etc/mysql/mariadb.conf.d/50-client.cnf中添加：

ini [client] default-character-set = utf8mb4

4. 应用层预防措施

在Java应用中，我增加了以下防御性代码：

java // 启动时验证数据库连接字符集 try (Connection conn = dataSource.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery("SHOW VARIABLES LIKE 'character_set_connection'")) { if (rs.next()) { String charset = rs.getString("Value"); if (!"utf8mb4".equalsIgnoreCase(charset)) { throw new IllegalStateException("数据库连接字符集不是utf8mb4"); } } }

第四阶段：验证与测试

完成所有配置后，我进行了全面测试：

1. 命令行插入验证：
   sql INSERT INTO test VALUES (NULL, '中文测试'); SELECT * FROM test;
   显示正常

2. 应用程序插入验证：
   通过界面提交包含中文的表单，检查数据库存储和页面显示

3. 数据迁移验证：
   使用mysqldump导出的数据重新导入，确保历史数据正常显示

第五阶段：问题根源分析

为什么在MySQL上正常的配置，在MariaDB上会出现问题？深入研究发现：

1. 默认配置差异：

   
   
   
   • MySQL 5.7+默认使用utf8mb4
   • MariaDB 10.x默认仍使用latin1（出于历史兼容性考虑）

2. 字符集协商机制：
   MariaDB对客户端的字符集请求处理更严格，特别是在没有明确指定时

3. 驱动实现细节：
   MariaDB的JDBC驱动对useUnicode参数的解释与MySQL驱动略有不同

最终解决方案总结

经过多次验证，确保中文不乱码需要同时满足以下条件：

1. 服务端配置utf8mb4为默认字符集
2. 客户端连接明确指定UTF-8编码
3. 数据库、表、列都使用utf8mb4字符集
4. 应用程序正确处理字符串编码

完整的工作配置示例：

服务端配置（/etc/mysql/mariadb.conf.d/50-server.cnf）:
ini [mysqld] character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci init_connect = 'SET NAMES utf8mb4' skip-character-set-client-handshake

客户端配置（/etc/mysql/mariadb.conf.d/50-client.cnf）:
ini [client] default-character-set = utf8mb4

JDBC连接字符串:
jdbc:mariadb://host:3306/db?useUnicode=yes&characterEncoding=UTF-8&useSSL=false

经验与教训

1. 不要假设默认配置：即使是兼容的数据库系统，默认值也可能不同
2. 全链路检查：字符集问题需要检查客户端、连接、服务器、数据库、表、列各个层面
3. 版本差异：MariaDB 10.2、10.3、10.6等版本在字符集处理上也有细微差别
4. 测试方法：直接通过多种客户端工具测试，不要依赖单一入口

这次问题解决耗时约6个小时，但收获的经验非常宝贵。现在我们的系统可以完美处理各种语言文字，包括中文、emoji等4字节UTF-8字符。希望这篇记录能帮助其他开发者少走弯路。