MySQL容器必须挂载/var/lib/mysql目录实现持久化，推荐用宿主机绝对路径如-v /data/mysql8:/var/lib/mysql；初始化SQL放/docker-entrypoint-initdb.d/，配置文件应映射至/etc/mysql/my.cnf或/conf.d/并确保含[mysqld]段及关键参数。
直接挂载 /var/lib/mysql 是最简且可靠的方式
MySQL 8.0 容器默认把数据写在 /var/lib/mysql，只要把这个路径用 -v 映射到宿主机目录，容器删了数据也不会丢。这是生产环境最主流的做法，比用 named volume 更可控、更易备份。
常见错误是挂载错路径，比如映射到 /etc/mysql 或空目录，结果容器启动失败报 Can't open the mysql.plugin table 或反复初始化；或者宿主机目录权限不对（如 root 创建但 MySQL 进程以非 root 用户运行），导致 mysqld 启动卡在 Initializing database。
- 宿主机目录必须提前创建，且建议用
sudo mkdir -p /data/mysql8避免路径不存在 - 不要对宿主机目录执行
chmod 777—— MySQL 8.0 容器内默认以用户mysql（UID 999）运行，应改属主：sudo chown -R 999:999 /data/mysql8 - 首次运行时，如果宿主机目录为空，MySQL 会自动初始化；如果已有旧数据，确保是同版本（如 8.0.33）生成的，否则可能因数据字典不兼容而拒绝启动
-v 挂载时配置文件怎么放才生效
MySQL 8.0 容器读取配置的优先级是：/etc/mysql/my.cnf → /etc/mysql/conf.d/*.cnf → /etc/mysql/mysql.conf.d/*.cnf。只挂载单个 my.cnf 文件时，必须映射到 /etc/mysql/my.cnf（全路径），不能只挂载进 /etc/mysql/conf.d/ 后缀不对或内容不完整就无效。
容易踩的坑：有人把自定义 my.cnf 挂到 /etc/mysql/conf.d/custom.cnf，但文件里没加 [mysqld] 段，或用了 MySQL 5.7 的参数（如 innodb_file_per_table=1 在 8.0 已默认开启），导致启动失败或静默忽略。
- 推荐做法：挂载整个
conf.d目录，如-v /host/conf.d:/etc/mysql/conf.d，然后在宿主机放一个/host/conf.d/01-charset.cnf，内容只写[mysqld]及其下几行关键配置 - 必须包含
default_authentication_plugin=mysql_native_password，否则客户端（尤其是旧版 Navicat、某些 JDBC 驱动）连不上 - 时区要显式设为
default-time_zone='+8:00'，否则容器内时间与宿主机不一致，影响日志和定时任务
端口冲突、--restart 和初始化 SQL 的配合要点
持久化不只是数据不丢，还要保证服务可恢复。单独挂载 /var/lib/mysql 不足以应对所有场景：比如你改了 root 密码但没持久化密码环境变量，重启后仍用旧密码；或者需要预建库/用户，但每次重跑容器都得手动执行 SQL。
典型误操作：把 -e MYSQL_ROOT_PASSWORD 和挂载数据卷混用却不注意顺序——如果宿主机目录已有初始化过的数据，MySQL 会跳过环境变量设置的密码逻辑，继续用旧密码。此时改密码只能进容器执行 ALTER USER。
- 初始化 SQL 必须放在
/docker-entrypoint-initdb.d/下，挂载时对应宿主机目录（如-v /host/initdb:/docker-entrypoint-initdb.d），且文件名以.sql或.sh结尾 - 端口映射别硬写
-p 3306:3306，尤其开发机已跑本地 MySQL 时，建议用-p 3307:3306避免冲突 -
--restart unless-stopped比always更稳妥，避免容器因配置错误反复崩溃重启
为什么不用 docker volume create 而坚持用 -v 绝对路径
named volume（docker volume create mysql-data）确实能自动管理权限和生命周期，但它把数据藏在 /var/lib/docker/volumes/... 下，对运维不友好：备份难定位、排查慢查询日志得进容器、无法用 rsync 直接同步。
更关键的是，MySQL 8.0 的 mysqld-auto.cnf（由 SET PERSIST 生成）也存在 /var/lib/mysql 下。如果用 named volume，你改了参数并持久化，但换机器部署时没迁移这个 volume，那些配置就丢了——而用宿主机绝对路径，整个目录 cp 就走人。
唯一例外是 CI/CD 测试环境，需要快速启停隔离实例，这时可用 docker run --rm -v mysql-test-data:/var/lib/mysql，但生产环境请坚持 -v /data/mysql8:/var/lib/mysql。
