MySQL容器数据丢失是因为未挂载宿主机目录,正确做法是用-v将/var/lib/mysql映射到宿主机绝对路径(如/mydata/mysql),且该目录需为空、属主为999;环境变量仅首次初始化生效;自定义配置应挂载到/etc/mysql/conf.d/并设只读。

MySQL容器启动时数据丢失,是因为没挂载宿主机目录
默认用 docker run mysql:8.0 启动的容器,所有数据都存在容器内部的临时文件系统里。容器一删,/var/lib/mysql 里的数据库全没了。持久化的前提是把这目录映射到宿主机一个固定路径,让 MySQL 写数据时实际落在宿主机磁盘上。
正确做法是用 -v 挂载,例如:
docker run -d \ --name mysql-dev \ -v /mydata/mysql:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORD=123456 \ -p 3306:3306 \ -d mysql:8.0
注意三点:
-
/mydata/mysql必须是宿主机已存在的空目录(首次启动前手动mkdir -p /mydata/mysql),且 MySQL 容器内用户(uid 999)要有写权限,常见坑是 SELinux 或 root 创建的目录导致容器启动失败 - 不要挂载到
/mydata这种父级目录,否则容器初始化时可能因已有文件干扰而卡在 “Starting MySQL” 状态 - 挂载点必须是绝对路径,相对路径如
./mysql在 Docker 中会被忽略或报错
MYSQL_ROOT_PASSWORD 不生效?检查环境变量拼写和启动时机
MySQL 官方镜像只认几个特定环境变量,且仅在容器**首次初始化数据库时**起作用。如果挂载的 /var/lib/mysql 目录非空(比如之前跑过、或误拷贝了旧数据),容器会跳过初始化流程,此时 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 全部被忽略。
关键环境变量只有这些:
-
MYSQL_ROOT_PASSWORD:必填,否则容器启动失败(8.0+ 镜像强制要求) -
MYSQL_DATABASE:自动创建指定库名,仅首次初始化有效 -
MYSQL_USER和MYSQL_PASSWORD:配对使用,自动建用户并授权,同样只在初始化阶段执行 -
MYSQL_ALLOW_EMPTY_PASSWORD:设为yes可跳过密码强制校验(不推荐生产)
常见错误:改了 MYSQL_ROOT_PASSWORD 但重启容器后密码还是旧的——因为数据目录有残留,MySQL 直接复用了原有 mysql 系统库。
想自定义配置(如修改 max_connections),不能直接改容器内 my.cnf
官方镜像不建议覆盖容器内的 /etc/mysql/my.cnf,因为升级镜像时容易丢失。正确方式是挂载自定义配置文件到 /etc/mysql/conf.d/(该目录下所有 .cnf 文件会被 MySQL 自动加载)。
例如:
echo "[mysqld]\nmax_connections = 500" > /mydata/mysql/conf/my-custom.cnf docker run -d \ -v /mydata/mysql:/var/lib/mysql \ -v /mydata/mysql/conf/my-custom.cnf:/etc/mysql/conf.d/my-custom.cnf:ro \ -e MYSQL_ROOT_PASSWORD=123456 \ -p 3306:3306 \ mysql:8.0
注意:
- 挂载配置文件必须加
:ro(只读),否则 MySQL 启动时报错“Can’t open the mysql.plugin table” - 配置项必须放在
[mysqld]段落下,放错位置(比如顶格或写成[client])不会生效 - 某些参数如
datadir、socket已被镜像固化,强行修改会导致启动失败
挂载目录权限问题最常导致容器反复重启
MySQL 容器以 UID 999(mysql 用户)运行,若宿主机挂载目录属主不是 999 或无写权限,容器日志会卡在 Initializing database 并不断重启。
快速验证方法:
ls -ld /mydata/mysql
修复方式(二选一):
- 改宿主机目录属主:
sudo chown -R 999:999 /mydata/mysql - 或启动时用
--user指定 UID:docker run --user 999:999 ...(前提是宿主机目录对 999 可写)
Mac 或 Windows 上用 Docker Desktop 时,挂载目录默认权限较松,但 Linux 主机上几乎必踩这个坑。别信“我 chmod 777 就行”,MySQL 8.0 默认拒绝 world-writable datadir,反而会报错退出。


















