必须提前创建宿主机目录并设属主为999:999，否则mysql 8.0容器因权限不足卡在initializing database或报permission denied；挂载路径必须为/var/lib/mysql，且旧数据须为同版本生成以防数据字典不兼容。
挂载 /var/lib/mysql 必须提前创建并修正属主
MySQL 8.0 容器默认以 UID 999（mysql 用户）运行，如果宿主机目录由 root 创建且未改属主，mysqld 会卡在 Initializing database 或直接报 Permission denied。
正确做法是分两步：
- 先创建目录：
sudo mkdir -p /data/mysql8 - 再设属主：
sudo chown -R 999:999 /data/mysql8（严禁用chmod 777）
启动时用 -v /data/mysql8:/var/lib/mysql；不要映射到 /etc/mysql 或空子目录，也不要用 ~ 路径——Docker 不展开 shell 变量。
命名卷 vs 主机目录：选哪个更“优雅”？
命名卷（如 mysql8-data）由 Docker 管理，自动处理权限和路径，适合开发/测试场景：
- 创建：
docker volume create mysql8-data - 启动：
-v mysql8-data:/var/lib/mysql - 优点：免属主干预、跨平台一致、
docker volume prune可清理
主机目录（如 /data/mysql8）更适合生产，因为：
- 备份/迁移可直接操作文件系统
- 便于监控磁盘使用（
du -sh /data/mysql8） - 能配合 LVM 或独立挂载点做 IO 隔离
注意：若宿主机目录已有旧数据，必须确认是同版本 MySQL 8.x 生成的，否则因数据字典不兼容，mysqld 会拒绝启动。
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
配置文件挂载位置必须匹配 MySQL 8.0 加载顺序
MySQL 8.0 启动时严格按顺序读取：/etc/mysql/my.cnf → /etc/mysql/conf.d/*.cnf → /etc/mysql/mysql.conf.d/*.cnf。挂错路径或后缀，配置就静默失效。
推荐做法是挂载整个 conf.d 目录：
- 宿主机准备：
/host/conf.d/01-charset.cnf，内容必须含[mysqld]段 - 启动参数：
-v /host/conf.d:/etc/mysql/conf.d - 禁止单独挂
/host/my.cnf到/etc/mysql/conf.d/my.cnf——后缀不是.cnf就不加载
常见失效原因：漏写 [mysqld]、用了已废弃参数（如 innodb_file_per_table=1 在 8.0.30+ 已默认启用）、或把 my.cnf 放在了 /etc/mysql 根下却没设 !includedir。
持久化只管数据文件，不管初始化逻辑
-v /data/mysql8:/var/lib/mysql 能保住表数据和系统表，但以下两类变更不会自动持久化：
- 容器首次启动时通过
MYSQL_DATABASE/MYSQL_USER环境变量创建的数据库和用户，仅在初始化阶段生效；重启容器后这些对象仍存在，但若删掉数据卷重来，就得重新执行 - 后续手动执行的
CREATE USER、GRANT、INSTALL PLUGIN等操作，其元数据虽存于mysql库中，但若你误删了数据卷，这些权限就全丢了
真正可靠的方案是：把初始化 SQL 和权限脚本放在 /docker-entrypoint-initdb.d/ 下挂入容器，并确保该目录内容也通过卷或构建层固化——否则每次重建容器，都得人工补一遍权限。
