将MySQL迁移到Docker容器中时，挂载卷和环境变量的配置是保障数据持久化、服务正常运行的核心环节，错误的配置可能导致数据丢失、服务启动失败等问题，需要重点关注相关配置规则。
挂载卷配置注意事项
数据目录挂载
MySQL容器内的默认数据目录是/var/lib/mysql，如果不挂载该目录，容器删除后所有数据都会丢失，因此必须将该目录挂载到宿主机的持久化路径。挂载时需要注意宿主机目录的权限问题，MySQL容器内默认使用mysql用户运行，宿主机挂载目录的属主和权限需要匹配，否则会出现无法写入数据的错误。
示例挂载命令如下：
# 创建宿主机数据目录 mkdir -p /opt/mysql/data # 修改目录权限，匹配容器内mysql用户uid（通常是999） chown -R 999:999 /opt/mysql/data # 启动容器时挂载数据目录 docker run -d --name mysql-test -v /opt/mysql/data:/var/lib/mysql mysql:8.0
配置文件挂载
如果需要自定义MySQL配置，比如调整最大连接数、字符集等，可以将自定义配置文件挂载到容器内的/etc/mysql/conf.d目录，该目录下的配置文件会被MySQL自动加载。注意不要直接覆盖容器内的/etc/mysql/my.cnf主配置文件，避免破坏原有配置结构。
配置文件挂载示例：
# 创建宿主机配置目录和自定义配置文件 mkdir -p /opt/mysql/conf cat > /opt/mysql/conf/custom.cnf << EOF [mysqld] max_connections=1000 character-set-server=utf8mb4 collation-server=utf8mb4_general_ci EOF # 启动容器时挂载配置目录 docker run -d --name mysql-test -v /opt/mysql/conf:/etc/mysql/conf.d -v /opt/mysql/data:/var/lib/mysql mysql:8.0
挂载卷常见问题
- 如果迁移前宿主机已有旧的MySQL数据，直接挂载后可能出现数据不兼容问题，建议先备份原有数据，再导入到新的挂载目录中。
- 不要同时挂载多个目录到同一个容器路径，会导致配置冲突。
- 使用Docker Compose时，挂载路径可以使用相对路径，更便于项目迁移。
环境变量配置注意事项
核心环境变量说明
MySQL官方镜像提供了多个环境变量用于初始化配置，常用的核心变量如下：
| 环境变量名 | 作用说明 | 注意事项 |
|---|---|---|
| MYSQL_ROOT_PASSWORD | 设置root用户的密码 | 必填项，不能为空，否则容器无法启动 |
| MYSQL_DATABASE | 容器启动时自动创建的数据库名 | 可选，创建后可以直接使用该数据库 |
| MYSQL_USER | 自动创建的非root用户名 | 需要配合MYSQL_PASSWORD使用，可选 |
| MYSQL_PASSWORD | 自动创建的非root用户密码 | 配合MYSQL_USER使用，可选 |
| MYSQL_ALLOW_EMPTY_PASSWORD | 是否允许root密码为空 | 可选，设置为yes时可以不设置MYSQL_ROOT_PASSWORD，生产环境不建议开启 |
环境变量配置示例
启动容器时配置环境变量的示例：
docker run -d --name mysql-test -e MYSQL_ROOT_PASSWORD=MyPass@123 -e MYSQL_DATABASE=test_db -e MYSQL_USER=test_user -e MYSQL_PASSWORD=TestPass@456 -v /opt/mysql/data:/var/lib/mysql -v /opt/mysql/conf:/etc/mysql/conf.d mysql:8.0
如果使用Docker Compose配置，示例如下：
version: '3'
services:
mysql:
image: mysql:8.0
container_name: mysql-test
environment:
MYSQL_ROOT_PASSWORD: MyPass@123
MYSQL_DATABASE: test_db
MYSQL_USER: test_user
MYSQL_PASSWORD: TestPass@456
volumes:
- /opt/mysql/data:/var/lib/mysql
- /opt/mysql/conf:/etc/mysql/conf.d
ports:
- "3306:3306"
restart: always
环境变量注意事项
- 环境变量仅在容器首次启动时生效，如果容器已经初始化过，修改环境变量后重启容器不会生效，需要删除容器重新创建才会应用新配置。
- 敏感的环境变量比如密码，不建议直接写在启动命令或Compose文件中，可以使用Docker Secrets或者环境变量文件来配置。
- 不要设置过于简单的密码，避免数据库被暴力破解。
迁移完整流程示例
假设需要将宿主机上原有的MySQL数据迁移到Docker容器中，完整流程如下：
- 停止宿主机上原有的MySQL服务，备份原有数据目录，比如
/var/lib/mysql下的所有文件。 - 按照之前的说明创建宿主机的挂载目录
/opt/mysql/data和/opt/mysql/conf，并将备份的数据复制到/opt/mysql/data目录中。 - 修改
/opt/mysql/data目录的权限为999:999，避免权限错误。 - 如果需要自定义配置，在
/opt/mysql/conf目录下创建自定义配置文件。 - 使用带有环境变量和挂载卷的命令启动MySQL容器，等待容器启动完成。
- 进入容器验证数据是否完整，服务是否正常可用。
验证容器状态的命令示例：
# 查看容器运行状态 docker ps -a | grep mysql-test # 进入容器登录MySQL验证 docker exec -it mysql-test mysql -uroot -pMyPass@123 # 查看数据库是否正常 show databases;
常见错误排查
如果容器启动后立即退出，可以查看容器日志排查问题：docker logs mysql-test- 日志提示权限错误：检查挂载目录的属主和权限是否正确，是否匹配容器内mysql用户的uid。
- 日志提示root密码未设置：检查是否配置了MYSQL_ROOT_PASSWORD环境变量，或者是否开启了MYSQL_ALLOW_EMPTY_PASSWORD。
- 日志提示数据目录损坏：可能是原有数据版本和当前MySQL镜像版本不兼容，需要确认版本匹配，或者重新初始化数据。