### Docker 中 MySQL 初始化脚本创建数据库时乱码问题解决方案 在 Docker 容器中运行 MySQL 并通过初始化脚本创建数据库时，如果遇到乱码问题，通常是因为字符集设置不一致或者未正确配置环境变量所致。以下是详细的分析和解决方法： #### 1. 确保 MySQL 配置文件支持 UTF-8 或 UTF-8MB4 为了防止乱码问题，在启动容器之前可以通过修改 MySQL 的配置文件来指定默认字符集为 `utf8mb4`。可以在自定义的 `my.cnf` 文件中加入如下内容[^2]: ```ini [mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci ``` 将此配置文件挂载到容器中的 `/etc/mysql/conf.d/` 路径下。 --- #### 2. 修改初始化 SQL 脚本以显式声明字符集 在初始化脚本中，除了建库语句外，还需要明确设定该数据库及其表使用的字符集为 `utf8mb4`。例如，可以参考以下示例代码： ```sql -- 建立测试数据库并指定字符集 CREATE DATABASE IF NOT EXISTS `test` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE test; -- 创建用户表并指定字符集 CREATE TABLE IF NOT EXISTS `user` ( `id` INT(4) PRIMARY KEY, `name` VARCHAR(20) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO `user` VALUES (1, '小明'); ``` 上述脚本不仅设置了整个数据库的字符集，还针对具体的数据表进行了进一步约束，从而减少潜在的编码冲突风险。 --- #### 3. 启动容器时传递正确的环境变量 当使用官方提供的 MySQL 镜像时，可通过 `-e` 参数向容器传入必要的环境变量以控制其行为。对于字符集相关参数来说，推荐至少设置以下几个选项[^3][^4]： ```bash docker run --name=mysql-container \ -v /path/to/init.sql:/docker-entrypoint-initdb.d/init.sql \ -e MYSQL_ROOT_PASSWORD=rootpassword \ -e MYSQL_DATABASE=test \ -e LANG=C.UTF-8 \ -d mysql:5.7 ``` 其中： - **MYSQL_ROOT_PASSWORD**: 设定 root 用户密码； - **MYSQL_DATABASE**: 自动创建的目标数据库名； - **LANG=C.UTF-8**: 明确告知操作系统采用 UTF-8 编码方式处理输入输出流； 注意：这里提到的路径 `/docker-entrypoint-initdb.d/` 是官方镜像预设用于加载初始化脚本的位置目录。 --- #### 4. 检查客户端连接时所用字符集 即使服务器端已经调整完毕，但如果客户端（比如命令行工具或其他应用程序）仍然沿用了旧有的编码模式，则仍可能出现显示异常的情况。因此建议每次登录前都执行下面这条指令确认当前会话正在应用合适的字符集[^1]： ```sql SET NAMES utf8mb4; ``` 此外也可以将其写入 `.my.cnf` 文件以便长期生效: ```ini [client] default-character-set=utf8mb4 ``` --- ### 总结 综上所述，要彻底解决 Docker 环境下的 MySQL 初始数据导入过程中产生的乱码现象，需从三个方面入手——即全局层面调整服务端默认编码规则、局部细化各对象内部属性以及同步优化前端访问接口的行为习惯。只有三者协调统一才能达到预期效果。 ```python # 示例 Python 连接代码片段展示如何设置编码 import pymysql connection = pymysql.connect( host='localhost', port=3306, user='root', password='your_password_here', db='test', charset='utf8mb4' # 关键字参数确保通信过程遵循UTF-8标准 ) cursor = connection.cursor() result = cursor.execute("SELECT * FROM user;") print(cursor.fetchall()) ```