MYSQL_ROOT_PASSWORD仅在首次启动且数据目录为空时设置root密码,不触发建库、授权或自定义初始化;真正可靠的初始化必须通过/docker-entrypoint-initdb.d/下的SQL或Shell脚本实现。

云原生环境里,MySQL 的环境变量不是用来“动态初始化”的,而是用于控制容器启动时的行为;真正的初始化逻辑靠 docker-entrypoint-initdb.d 下的 SQL 或 shell 脚本驱动。
为什么 MYSQL_ROOT_PASSWORD 不等于初始化完成
很多人以为只要设置了 MYSQL_ROOT_PASSWORD,MySQL 就自动建库、授权、跑脚本——其实不是。这个变量只在容器首次启动且数据目录为空时生效,作用仅限于:创建 root 用户、设置密码、跳过权限表加载。它不触发任何自定义逻辑。
- 如果 PVC 已挂载旧数据(比如上次运行留下的
/var/lib/mysql),MYSQL_ROOT_PASSWORD完全被忽略 - 即使首次启动,它也不会执行
CREATE DATABASE或GRANT,除非你额外提供初始化脚本 - 在 Kubernetes 中,若 StatefulSet 重建 Pod 但复用同一 PVC,环境变量就彻底失效
真正起作用的初始化路径是 /docker-entrypoint-initdb.d/
官方 MySQL 镜像(如 mysql:8.0)内置了 entrypoint 脚本,会按字母序执行该目录下所有 .sql、.sh、.sql.gz 文件。这是唯一可靠、可复现的初始化方式。
- SQL 文件必须以 UTF-8 编码,不能含 BOM;否则
mysql客户端报错退出,初始化中断 - Shell 脚本需有可执行权限(
chmod +x),且第一行必须是#!/bin/bash - 脚本内若调用
mysql命令,要用mysql -h localhost -P 3306 -u root -p"$MYSQL_ROOT_PASSWORD",不能省略-h localhost(否则走 socket 连接,在容器里常失败) - 不要在脚本里写
DROP DATABASE IF EXISTS xxx—— 若数据库已存在,后续CREATE DATABASE会报错,整个初始化流程终止
如何把环境变量注入到初始化脚本中
你不能直接在 .sql 文件里引用 $MYSQL_DATABASE,但可以在 .sh 脚本里拼接 SQL 字符串并执行。例如:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
#!/bin/bash
set -e
<h1>使用环境变量生成数据库名</h1><p>DB_NAME=${MYSQL_DATABASE:-myapp}
mysql -h localhost -P 3306 -u root -p"$MYSQL_ROOT_PASSWORD" </p>
注意:MYSQL_APP_PASSWORD 需作为 Secret 挂入容器,不能硬编码;MYSQL_DATABASE 是官方支持的变量,仅用于创建默认库名,不参与权限分配。
Kubernetes 中 ConfigMap + Secret 的典型组合
在 K8s 里,别把初始化逻辑塞进 Deployment 的 env: 字段。正确做法是:
- 用 ConfigMap 挂载
/docker-entrypoint-initdb.d/init.sh(含上面的脚本) - 用 Secret 挂载
/run/secrets/mysql_app_password,并在 init.sh 里读取:MYSQL_APP_PASSWORD=$(cat /run/secrets/mysql_app_password) - PVC 必须为空或首次绑定;若已有数据,删掉 PVC 再重建,否则 init 目录完全不执行
- StatefulSet 的
initContainers不适合做这个——entrypoint 机制本身已足够,加 initContainer 反而破坏原子性
最容易被忽略的一点:**初始化只发生一次,且不可逆。** 后续配置变更(比如新增用户、改字符集)必须通过外部运维操作或应用层迁移工具完成,不能指望重启容器重跑 init 脚本。










