Docker Compose部署MySQL时如何调整SQL文件注入顺序？

遇到这种因为文件名排序导致的初始化错误确实挺头疼的，除了重命名文件，还有几个实用的方法可以控制SQL脚本的执行顺序：

方法1：自定义初始化脚本（最灵活） #

MySQL官方镜像会按字母顺序执行/docker-entrypoint-initdb.d下的所有.sh、.sql和.sql.gz文件，我们可以写一个shell脚本，手动指定先执行结构文件，再执行数据文件，然后让这个脚本优先运行。

步骤： #

1. 在项目根目录创建一个初始化脚本，比如00-run-in-order.sh（开头加00确保它最先被执行）：

#!/bin/bash
set -e

# 先执行数据库结构文件（file2.sql）
echo "Executing database structure file..."
mysql -u root -p"${MYSQL_ROOT_PASSWORD}" "${MYSQL_DATABASE}" < /docker-entrypoint-initdb.d/file2.sql

# 再执行数据导入文件（file1.sql）
echo "Executing data import file..."
mysql -u root -p"${MYSQL_ROOT_PASSWORD}" "${MYSQL_DATABASE}" < /docker-entrypoint-initdb.d/file1.sql

2. 给脚本添加执行权限：

chmod +x 00-run-in-order.sh

3. 修改docker-compose.yml的volumes配置，把这个脚本也挂载进去：

version: '3.1'
services:
  db:
    image: mysql
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    volumes:
      - ./mysql-dump/samples:/docker-entrypoint-initdb.d
      - ./00-run-in-order.sh:/docker-entrypoint-initdb.d/00-run-in-order.sh
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: db_example
  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

这样启动容器时，会先运行我们的自定义脚本，严格按照指定顺序执行结构和数据文件。

方法2：合并SQL文件 #

如果你的脚本不多，可以直接把结构文件和数据文件合并成一个，确保结构代码在数据代码之前：

1. 在mysql-dump/samples目录下创建一个combined-init.sql文件：

cat file2.sql file1.sql > combined-init.sql

2. 删掉原来的file1.sql和file2.sql（或者修改docker-compose的挂载路径，只挂载合并后的文件），这样容器初始化时只会执行合并后的文件，顺序自然正确。

方法3：利用子目录+脚本批量处理（适合多文件场景） #

如果有多个结构文件和数据文件，可以把它们分成两个子目录，然后用脚本批量执行：

1. 调整本地目录结构：

mysql-dump/
  samples/
    structure/
      file2.sql
      other-structure-files.sql
    data/
      file1.sql
      other-data-files.sql

2. 创建自定义脚本00-run-in-order.sh：

#!/bin/bash
set -e

# 批量执行所有结构文件（按字母顺序）
echo "Executing all structure files..."
for sql_file in /docker-entrypoint-initdb.d/structure/*.sql; do
    mysql -u root -p"${MYSQL_ROOT_PASSWORD}" "${MYSQL_DATABASE}" < "$sql_file"
done

# 批量执行所有数据文件（按字母顺序）
echo "Executing all data files..."
for sql_file in /docker-entrypoint-initdb.d/data/*.sql; do
    mysql -u root -p"${MYSQL_ROOT_PASSWORD}" "${MYSQL_DATABASE}" < "$sql_file"
done

3. 修改docker-compose的volumes配置：

volumes:
  - ./mysql-dump/samples/structure:/docker-entrypoint-initdb.d/structure
  - ./mysql-dump/samples/data:/docker-entrypoint-initdb.d/data
  - ./00-run-in-order.sh:/docker-entrypoint-initdb.d/00-run-in-order.sh

这个方法适合脚本数量较多的场景，既能分组控制顺序，又能保持组内的字母排序。

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