MySQL容器数据持久化：避开那些“一重启就丢数据”的坑

先说一个核心判断：在Docker里跑MySQL，数据持久化不是“可选项”，而是“生存底线”。很多开发者踩的第一个大坑，就是容器重启后，发现数据库被“打回原形”。这背后的原因其实很直接，但解决方案却有几个关键细节需要拿捏。

挂载 /var/lib/mysql 是硬性要求，不挂就丢数据

这里没有灰色地带。MySQL容器一旦停止或被删除，所有写入/var/lib/mysql的数据，默认都会随着容器层的销毁而消失。这不是概率问题，而是必然结果——因为镜像层是只读的，运行时所有写入都发生在可写的容器层。所以，只要这个路径没做挂载，哪怕只是简单地重启一次，你辛苦创建的数据库、用户、表结构都会荡然无存。

因此，显式挂载这个路径是铁律，而且目标必须是空目录或由Docker管理的卷。实践中，常见的失误包括：

• 只配置了端口和密码，却漏写了关键的-v或volumes:挂载指令。
• 记得映射自定义配置文件目录（如/etc/mysql/conf.d），偏偏忘了挂载最重要的数据目录。
• 试图用docker commit保存容器状态来“曲线救国”——这种方法极不可靠，且完全无法实现增量备份。

docker run -v 绑定宿主机目录：权限和 SELinux 是两大拦路虎

直接把宿主机目录（例如/my/mysql/data）挂载进去，看起来最直观。但在Linux环境下，这恰恰是失败的高发区。问题根源通常不在Docker本身，而在于两点：MySQL进程（默认以UID 999运行）需要对挂载的目录拥有完整的读写权限；同时，如果系统启用了SELinux，其默认策略会禁止容器访问宿主机上的任意路径。

实操时，记住这几个要点能省去大量调试时间：

• 目录创建后，第一时间执行：chown -R 999:999 /my/mysql/data（针对MySQL 8.0及以上默认用户）。
• 如果系统启用了SELinux（使用getenforce命令返回Enforcing），必须在挂载时加上:z标签：-v /my/mysql/data:/var/lib/mysql:z。
• 避免一个隐蔽的坑：不要用root用户创建目录后再chown。在某些发行版（如CentOS Stream）上，这可能会保留root的能力集（capabilities），导致MySQL启动时报错mysqld: Can't create/write to file。
• 首次启动前，务必确保挂载目录是空的；如果目录里已有数据，则需要先确认文件的所有者已经是UID 999。

docker volume 命名卷：适合大多数场景，但调试不便

使用Docker管理的命名卷，是更符合容器设计哲学的方案。Docker会自动处理存储位置和权限问题，完美避开了绑定挂载的权限麻烦。它非常适合开发、CI/CD流水线以及大多数生产环境。当然，缺点也有：当你需要直接查看或备份物理数据文件时，会不那么方便。

它的关键行为是这样的：

• 当你运行docker run -v mysql-data:/var/lib/mysql时，如果mysql-data卷不存在，Docker会自动创建它。
• 卷的实际物理位置通常在/var/lib/docker/volumes/mysql-data/_data，对普通用户不可见，也不建议直接操作。
• 删除容器并不会删除关联的卷，数据得以保留。必须显式执行docker volume rm mysql-data才会清除数据。
• 想查看卷里的内容？不能直接用ls命令。一个常用的技巧是：docker run --rm -v mysql-data:/target alpine ls /target。

配置文件映射要避开 my.cnf 覆盖陷阱

MySQL官方镜像的启动过程有严格的配置加载顺序：先读内置的/etc/mysql/my.cnf，然后是/etc/mysql/conf.d/下的文件，最后是/etc/mysql/mysql.conf.d/下的文件。这里有个经典陷阱：如果你把自己的my.cnf整个挂载到/etc/mysql/my.cnf，会完全覆盖掉镜像提供的默认配置，很可能导致启动失败（比如丢失socket文件配置、禁用了必要的网络绑定）。

安全的做法是采用“片段式”配置：

• 新建一个文件，比如/my/mysql/conf.d/custom.cnf，只写入你需要修改的配置项：

  [mysqld]
  default_authentication_plugin=mysql_native_password
  character-set-server=utf8mb4
  collation-server=utf8mb4_unicode_ci

• 挂载时，只挂载这个自定义配置目录：-v /my/mysql/conf.d:/etc/mysql/conf.d:ro（建议只读挂载）。
• 尽量避免挂载整个/etc/mysql目录，因为镜像后续更新可能会在其中添加必要的配置文件。

配置挂载好后，可以进入容器执行mysql --help | grep "Default options"来确认加载顺序，用mysql -e "SHOW VARIABLES LIKE 'character_set%';"来验证配置是否生效。

最后，还有一个容易被忽略的关键点：配置文件挂载成功，并不代表MySQL会实时重读它。任何配置修改后，都必须重启容器才能生效。而且，每次重启容器时，如果数据目录（/var/lib/mysql）是空的，MySQL都会执行初始化。所以，正确的顺序是：先确保数据目录已挂载且非空，再去调整和挂载配置文件。