Docker中MySQL乱码问题分析与解决方案

问题分析

在Docker环境中MySQL出现乱码通常是由于字符集配置不正确导致的，主要原因包括：

1. 容器默认字符集配置不完整
2. 数据库创建时未指定正确的字符集
3. 客户端连接时字符集不匹配
4. 数据导入/导出时字符集转换问题

解决方案

1. 启动容器时配置字符集

在运行MySQL容器时，通过环境变量和配置文件设置正确的字符集：

docker run -d --name mysql-container \
  -e MYSQL_ROOT_PASSWORD=yourpassword \
  -e MYSQL_DATABASE=yourdb \
  -e MYSQL_CHARSET=utf8mb4 \
  -e MYSQL_COLLATION=utf8mb4_unicode_ci \
  -v /path/to/my.cnf:/etc/mysql/conf.d/custom.cnf \
  mysql:5.7

2. 自定义MySQL配置文件

创建自定义配置文件my.cnf并挂载到容器中：

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect='SET NAMES utf8mb4'

3. 数据库创建时指定字符集

如果数据库已存在，可以修改其字符集：

ALTER DATABASE yourdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

对于表级别的修改：

ALTER TABLE yourtable CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

4. 检查当前字符集配置

进入MySQL容器后执行以下命令检查当前字符集设置：

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

5. 客户端连接设置

确保客户端连接时也使用正确的字符集：

mysql -u username -p --default-character-set=utf8mb4

或者在连接后立即执行：

SET NAMES 'utf8mb4';

6. 数据导入导出注意事项

导出数据时：

mysqldump -u username -p --default-character-set=utf8mb4 yourdb > backup.sql

导入数据时：

mysql -u username -p --default-character-set=utf8mb4 yourdb < backup.sql

高级排查

如果问题仍然存在，可以尝试：

1. 检查应用程序连接字符串是否指定了字符集
2. 验证Docker宿主机的locale设置
3. 检查终端或客户端工具的编码设置
4. 确保所有相关组件(如PHP、Java等)都配置为使用UTF-8

推荐实践

• 始终使用utf8mb4而非utf8，以支持完整的Unicode字符(包括emoji)
• 在Docker Compose文件中统一配置字符集
• 在应用程序连接字符串中显式指定字符集
• 对所有新建数据库和表使用一致的字符集配置

通过以上方法，应该能够解决Docker中MySQL的乱码问题。如果问题仍然存在，可能需要检查特定应用程序的编码处理方式。