<p>MySQL容器启动时自动创建用户和数据库需依赖官方镜像的/docker-entrypoint-initdb.d/机制，将建库建用户SQL（如CREATE USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY '123456'; GRANT ALL ON mydb.* TO 'app'@'%'; FLUSH PRIVILEGES;）放入init.sql并挂载，且host必须用'%'而非'localhost'，8.0+须显式指定认证插件。</p>
MySQL容器启动时如何自动创建用户和数据库
容器启动后直接有可用账号，而不是进容器手动执行 CREATE DATABASE 和 CREATE USER，关键靠 MySQL 官方镜像支持的 /docker-entrypoint-initdb.d/ 初始化机制。
这个目录下所有 .sql、.sh 文件会在首次初始化（即 mysql_data 卷为空）时按字母顺序执行。注意：只在第一次运行生效，后续重启不重复执行。
- 把建库建用户 SQL 放进
init.sql，挂载到容器内/docker-entrypoint-initdb.d/init.sql - SQL 中避免用
IF NOT EXISTS判断库或用户——因为脚本根本不执行，不是“跳过”，是压根不触发 - 别在
.sh脚本里用mysql -u root -p$MYSQL_ROOT_PASSWORD连接——$MYSQL_ROOT_PASSWORD在初始化阶段不可用，要用mysql -u root --socket=/var/run/mysqld/mysqld.sock - 如果用了
mysql:8.0+，记得权限语句用CREATE USER ... IDENTIFIED WITH caching_sha2_password BY 'xxx'，否则客户端可能连不上
Docker Compose 中如何安全传入 root 密码和普通用户权限
MYSQL_ROOT_PASSWORD 是唯一被官方镜像识别的 root 密码环境变量，但它不能用于创建普通用户；普通用户的权限必须在初始化 SQL 里显式定义，不能靠环境变量自动生成。
常见错误是以为设了 MYSQL_USER 和 MYSQL_PASSWORD 就能自动建账号——其实这两个变量只在 mysql:5.7 及更早版本部分生效，8.0+ 已废弃，且即使生效也只建用户、不赋权、不指定 host。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 务必在
init.sql中写全权限语句，例如：CREATE USER 'app'@'%' IDENTIFIED BY '123456'; GRANT ALL ON mydb.* TO 'app'@'%'; FLUSH PRIVILEGES; - host 写
'%'而不是'localhost'，否则应用容器（走 bridge 网络）无法连接 - 不要把密码写死在
docker-compose.yml的environment下——改用env_file或 Docker secrets（生产环境） -
MYSQL_DATABASE环境变量只会建库，不会关联用户权限，别指望它自动授权
为什么 init.sql 执行了但新用户还是连不上
最常见原因是 MySQL 8.0 默认认证插件从 mysql_native_password 换成 caching_sha2_password，而很多客户端（尤其是老版本 PHP、某些 Python 驱动）不支持后者，报错通常是：Authentication plugin 'caching_sha2_password' cannot be loaded。
这不是权限问题，是握手失败。解决方式不是改权限，而是统一认证方式。
- 在
init.sql中创建用户时显式指定插件：CREATE USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY '123456'; - 或者启动容器时加配置项：
command: --default-authentication-plugin=mysql_native_password - 检查是否误用了
localhost用户——容器间通信走的是 TCP，不是 socket，'user'@'localhost'对容器应用完全不可见 - 确认没漏掉
FLUSH PRIVILEGES;（虽然 8.0 大多数情况不需要，但显式写上更稳）
挂载配置文件 vs 环境变量：哪些该放 my.cnf，哪些必须用 -e
my.cnf 控制服务行为（如字符集、日志、buffer 设置），而环境变量只影响初始化逻辑（root 密码、初始库名等）。两者混用容易导致预期外覆盖。
- 必须用环境变量的只有：
MYSQL_ROOT_PASSWORD（必填）、MYSQL_DATABASE（可选）、MYSQL_ALLOW_EMPTY_PASSWORD（慎用） - 字符集相关必须写进
my.cnf：比如[mysqld] character-set-server=utf8mb4，光设环境变量无效 - 如果挂载了自定义
my.cnf，确保它包含[mysqld]段，且没有语法错误，否则容器会启动失败并报mysqld: Can't read dir of '/etc/mysql/conf.d/' - 不要在
my.cnf里写skip-networking或bind-address = 127.0.0.1——这会让其他容器根本连不上
事情说清了就结束。最常卡住的地方不是语法，是 MySQL 8.0 的认证插件和网络 host 匹配——这两点不盯住，初始化脚本写得再全也没用。
