mysql如何在Docker环境下实现数据持久化_挂载宿主机目录与环境变量设置-mysql教程-PHP中文网

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

mysql如何在docker环境下实现数据持久化_挂载宿主机目录与环境变量设置

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 自动加载）。

MySQL

编写正确的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

注意：