mysql Docker容器持久化数据目录配置方式

来源：这里教程网时间：2026-02-28 20:39:09 作者：

MySQL 容器启动时挂载

/var/lib/mysql

目录必须用绝对路径

宿主机目录没写成绝对路径（比如写成

./mysql-data

）会导致 Docker 自动创建匿名卷，容器重启后数据看似“还在”，实则新卷覆盖旧数据，实际已丢失。Docker 不会把相对路径自动解析为当前 shell 路径，而是按 daemon 工作目录处理，极不可控。

正确做法是显式声明完整路径：

docker run -d \
  --name mysql-dev \
  -v /home/user/mysql-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -p 3306:3306 \
  mysql:8.0

/home/user/mysql-data
必须提前
mkdir -p
并确保属主可写（MySQL 容器内用
mysql
用户 UID 999 写入） 若宿主机目录为空，首次启动会自动初始化数据库；若已有合法 MySQL 数据文件，容器会直接加载 不要挂载父目录（如
/home/user/data
），避免权限混乱或误删其他文件

挂载前必须修正宿主机目录的属主和权限

MySQL 容器默认以 UID 999（

mysql

用户）运行

mysqld

，若宿主机目录属主不是 999 或权限不足（如无写权限），容器会卡在初始化阶段并报错：

mysqld: Can't create/write to file '/var/lib/mysql/is_writable'

或直接退出。

修复方式（在挂载前执行）：

mkdir -p /home/user/mysql-data
chown -R 999:999 /home/user/mysql-data
chmod -R 700 /home/user/mysql-data

chown 999:999
比
chown mysql:mysql
更可靠，避免宿主机无
mysql
用户导致失败
chmod 700
是 MySQL 8.0+ 强制要求，宽松权限（如 755）会导致启动拒绝若用 Docker Compose，可在
init
容器或
entrypoint
脚本中做 chown，但不如宿主机预设稳妥

Docker Compose 中配置数据卷要避开命名卷自动初始化陷阱

用

volumes:

声明命名卷（如

mysql-data:

）时，Docker 会自动创建空卷，即使你同时写了

driver_opts

指向本地路径，也可能因初始化顺序问题导致数据目录被清空。

最稳方案是显式使用绑定挂载（bind mount）并禁用命名卷：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    volumes:
      - /home/user/mysql-data:/var/lib/mysql:rw
    environment:
      MYSQL_ROOT_PASSWORD: "123456"
    ports:
      - "3306:3306"

去掉
volumes:
顶层定义，不声明命名卷；否则 Compose 可能优先初始化它
:rw
显式声明读写，避免某些 Docker 版本默认只读若坚持用命名卷，必须配合
driver: local
和
driver_opts.type: none
等绕过自动格式化，复杂且易错

容器内修改

datadir

配置后挂载点必须同步调整

如果自定义了 MySQL 的

datadir

（比如改到

/data/mysql

），就不能再挂载

/var/lib/mysql

——否则配置与挂载冲突，

mysqld

启动失败并报错：

Can't find messagefile '/usr/share/mysql/errmsg.sys'

或更隐蔽的权限拒绝。

此时必须同步调整三处：

在
my.cnf
中设置
datadir = /data/mysql
挂载目标改为
-v /home/user/mysql-data:/data/mysql
确保宿主机目录
/home/user/mysql-data
同样
chown 999:999
且
chmod 700
若用配置文件挂载，需加
-v /path/to/my.cnf:/etc/mysql/conf.d/custom.cnf:ro
，注意路径和只读标识

改