/docker-entrypoint-initdb.d/ 脚本仅在容器首次启动且 /var/lib/mysql 为空时执行；挂载非空数据卷会跳过初始化，文件按字母顺序执行，推荐用 01-、02- 等数字前缀控制顺序。
直接用 /docker-entrypoint-initdb.d/ 目录，但必须满足“首次启动 + 数据目录为空”这个前提，否则脚本根本不会执行。
为什么 init.sql 没有运行？
最常见的情况是：你挂载了持久化卷（比如 -v /host/data:/var/lib/mysql），而该目录下已有数据文件。MySQL 官方镜像只在 /var/lib/mysql 为空时才触发初始化流程——它不关心你有没有改过配置或加过环境变量，只看这个目录是不是空的。
- 检查宿主机挂载路径是否为空：
ls -A /host/data；非空就跳过所有/docker-entrypoint-initdb.d/脚本 - 临时测试可删掉整个挂载目录（⚠️仅限开发环境），再
docker run启动 - 如果要用已有数据卷又想重跑初始化，得手动进容器执行 SQL，或者重建卷
SQL 文件命名和执行顺序怎么控制？
官方 entrypoint 脚本按字母顺序遍历 /docker-entrypoint-initdb.d/ 下的文件，不是按时间、也不是按文件后缀优先级。所以 01-create-tables.sql 一定比 02-insert-data.sql 先执行，但 z_init.sql 会排到最后。
- 推荐统一用两位数字前缀：
01-schema.sql、02-data.sql、03-views.sql - 避免使用空格、中文、特殊符号；文件名只保留字母、数字、下划线、短横线
-
.sh和.sql.gz也支持，但注意.sh脚本里调用mysql命令时，必须显式指定-u root -p"$MYSQL_ROOT_PASSWORD"，且不能依赖交互式输入
字符集乱码或语法报错怎么办？
很多初始化失败是因为 SQL 文件保存为 UTF-8 with BOM，或者用了 MySQL 8.0 不兼容的语法（比如 utf8 而非 utf8mb4），又或者没处理好换行和注释。
- 用
file -i init.sql确认编码是utf-8（不含 BOM）；Windows 下推荐用 VS Code 或 Notepad++ 保存为 “UTF-8 无 BOM” - 开头加上
SET NAMES utf8mb4;和SET FOREIGN_KEY_CHECKS = 0;，结尾补上SET FOREIGN_KEY_CHECKS = 1; - 避免在 SQL 文件里写
-- 注释后带空格这类易被截断的格式；多行语句每行末尾不要留空格 - 本地先用
mysql -u root -p 手动验证一遍，再扔进镜像
真正容易被忽略的是：初始化只发生一次，且完全依赖文件系统状态。一旦容器因挂载卷“记住”了数据，后续任何修改 SQL 文件、重建镜像、甚至改环境变量都无效——你得清空数据目录，或接受它永远跳过初始化这一步。
