必须挂载/var/lib/mysql到宿主机绝对路径，否则容器删除数据全丢；推荐bind mount方式，宿主机目录需提前创建并chown -R 999:999，配置文件应挂载至/etc/mysql/conf.d/且含[mysqld]段。
/var/lib/mysql 必须挂载，否则容器一删数据全丢。这是唯一不可妥协的硬性要求，其他配置都建立在此基础之上。
必须挂载 /var/lib/mysql 到宿主机绝对路径
MySQL 8.0 容器默认把所有数据库文件（表结构、ibdata、redo log、系统库等）全写在 /var/lib/mysql 下。不挂载，就等于存在容器临时文件系统里，docker rm 后彻底消失。
推荐用 Bind Mount（而非 named volume），因为更易备份、排查、迁移：
- 宿主机目录需提前创建：
sudo mkdir -p /data/mysql8 - 必须设对属主：
sudo chown -R 999:999 /data/mysql8（MySQL 8.0 官方镜像内以 UID 999 用户运行） - 不能是空父目录（如
/data），也不能已有非 MySQL 文件（会干扰初始化） - 挂载命令示例：
docker run -v /data/mysql8:/var/lib/mysql ... mysql:8.0
MYSQL_ROOT_PASSWORD 不生效？大概率是数据目录非空
环境变量只在首次初始化时起作用。如果 /data/mysql8 已存在旧数据（哪怕是上次跑一半留下的残留），MySQL 会跳过初始化流程，直接加载现有数据——此时 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE 全部被忽略。
常见表现：
- 容器卡在
Initializing database或反复重启 - 连上去发现 root 密码还是旧的，或
app_db没自动建 - 日志里出现
mysqld: Can't open the mysql.plugin table
解决方法：确认目录为空，或删掉重来：sudo rm -rf /data/mysql8 && sudo mkdir -p /data/mysql8 && sudo chown -R 999:999 /data/mysql8
配置文件挂载到 /etc/mysql/conf.d/ 才能生效
MySQL 8.0 容器按顺序加载配置：/etc/mysql/my.cnf → /etc/mysql/conf.d/*.cnf → /etc/mysql/mysql.conf.d/*.cnf。只挂一个文件，必须放在 /etc/mysql/conf.d/ 下，且后缀为 .cnf，内容必须含 [mysqld] 段。
典型错误配置：
- 挂到
/etc/mysql/my.cnf但覆盖了整个文件 → 升级镜像时丢失兼容性设置 - 挂到
/etc/mysql/conf.d/my.cnf但文件里没写[mysqld]→ 静默忽略 - 用了 MySQL 5.7 参数如
innodb_file_per_table=1→ 8.0 已默认开启，部分版本报错
安全做法：在宿主机建 /host/conf.d/01-charset.cnf，内容只写：
[mysqld] default_authentication_plugin=mysql_native_password default-time_zone='+8:00' character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci
别碰 chmod 777，也别挂错路径到 /etc/mysql 或 /tmp
权限和路径错位是启动失败最常被忽略的两个点：
-
chmod 777 /data/mysql8会导致 SELinux 或某些发行版（如 CentOS Stream）拒绝访问；正确做法永远是chown -R 999:999 - 挂载到
/etc/mysql或/conf.d（少一级路径）→ 容器找不到配置，用默认参数启动，可能连不上、中文乱码、认证失败 - 挂载到
/tmp/mysql这类临时目录 → 系统清理后数据丢失，且权限模型混乱 - 用相对路径如
./mysql-data→ Docker 直接忽略，等效于没挂载
初始化 SQL 脚本要放 /docker-entrypoint-initdb.d/，但仅当数据目录为空时才执行——它和持久化是两件事，别指望靠它“救活”一个已有损坏数据的目录。
