Docker容器启动时执行SQL脚本失败，请求技术帮助

1. 初始化脚本仅在首次创建卷时运行 #

MariaDB官方镜像的/docker-entrypoint-initdb.d目录下的脚本只会在数据库数据卷第一次初始化时执行。如果之前已经启动过容器，卷内已有数据，脚本不会重复运行。

解决方法：

• 删除现有数据卷后重新启动容器：

  docker-compose down -v
  docker-compose up
  

2. 检查脚本的权限与路径 #

确保宿主机上的init目录及其中的init_db.sql文件权限正确，容器内的mysql用户需要具备读取权限：

chmod -R 644 ./init
chown -R 999:999 ./init  # 999是MariaDB容器内mysql用户的默认UID/GID

同时确认docker-compose.yaml中的卷挂载配置正确，宿主机的./init目录确实存在且包含目标SQL脚本。

3. 验证SQL脚本语法 #

脚本语法错误会导致执行失败，且可能不会在日志中给出明确提示。可以手动连接容器测试脚本：

docker exec -it my_db mysql -uroot -ppassword
source /docker-entrypoint-initdb.d/init_db.sql

根据报错信息修正脚本问题，比如创建用户和授权的标准写法：

CREATE DATABASE IF NOT EXISTS my_custom_db;
CREATE USER IF NOT EXISTS 'my_user'@'%' IDENTIFIED BY 'user_password';
GRANT ALL PRIVILEGES ON my_custom_db.* TO 'my_user'@'%';
FLUSH PRIVILEGES;
USE my_custom_db;
CREATE TABLE IF NOT EXISTS user_info (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50));

4. 环境变量配置用户/数据库的正确方式 #

若想用环境变量自动创建数据库和用户，需设置以下官方支持的变量：

environment:
  MYSQL_ROOT_PASSWORD: password
  MYSQL_DATABASE: my_custom_db
  MYSQL_USER: my_user
  MYSQL_PASSWORD: user_password

这些变量会让镜像自动完成数据库和用户的创建，无需编写初始化脚本。如果之前配置未生效，大概率是因为数据卷已存在，按第一步删除卷后重试即可。

5. 查看脚本执行日志 #

若脚本已被执行但存在错误，可通过完整日志排查：

docker-compose up --force-recreate

如果日志中出现[Note] [Entrypoint]: Running /docker-entrypoint-initdb.d/init_db.sql字样，说明脚本已被触发，此时重点排查脚本内部的语法或逻辑问题。

内容的提问来源于stack exchange，提问作者arlaine