构建Docker容器时导入MySQL备份文件出现空表问题求助

问题根源 #

你当前的Dockerfile写法有个关键问题：构建阶段（RUN指令）启动的MySQL服务，在指令执行完成后就会终止，且数据不会被持久化到最终镜像中。

官方MySQL镜像把/var/lib/mysql（MySQL的数据存储目录）设置成了VOLUME，而Docker的VOLUME在构建过程中是不会被保存到镜像层的——你在RUN里启动MySQL、创建数据库、导入dump的操作，都只在临时构建容器的VOLUME里生效，临时容器销毁后这些数据就丢失了，所以最终启动容器时看到的是空表。

推荐解决方案：利用官方镜像的初始化脚本机制 #

官方MySQL镜像提供了自动初始化的功能：容器第一次启动时（当/var/lib/mysql为空时），会自动执行/docker-entrypoint-initdb.d/目录下的.sql、.sql.gz或.sh脚本。这是最规范的做法，修改后的Dockerfile如下：

FROM mysql:5.7
ARG MYSQL_DATABASE
ARG MYSQL_USER
ARG MYSQL_PASSWORD
ARG MYSQL_ROOT_PASSWORD

# 通过环境变量让镜像自动创建目标数据库
ENV MYSQL_DATABASE=${MYSQL_DATABASE}
ENV MYSQL_USER=${MYSQL_USER}
ENV MYSQL_PASSWORD=${MYSQL_PASSWORD}
ENV MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}

# 把备份文件放到初始化目录，容器首次启动时会自动执行
COPY dump.sql /docker-entrypoint-initdb.d/
COPY mysql.cnf /etc/mysql/conf.d/mysql.cnf

为什么这样有效？

1. 启动容器时，镜像的entrypoint脚本会先检查/var/lib/mysql是否为空：
   • 如果是空的，先根据MYSQL_DATABASE环境变量创建指定数据库
   • 然后自动执行/docker-entrypoint-initdb.d/下的dump.sql，把数据导入到目标库中
2. 导入的数据会被持久化到/var/lib/mysql（无论是镜像自带的目录，还是你挂载的外部数据卷），不会丢失。

备选方案：构建阶段完成数据导入（不推荐） #

如果因为特殊需求必须在构建镜像时就把数据导入进去，可以绕过VOLUME的限制，临时修改MySQL的数据目录完成导入，再复制到默认目录：

FROM mysql:5.7
ARG MYSQL_DATABASE
ARG MYSQL_USER
ARG MYSQL_PASSWORD
ARG MYSQL_ROOT_PASSWORD

COPY dump.sql /usr/sql/dump.sql
COPY mysql.cnf /etc/mysql/conf.d/mysql.cnf

# 临时修改数据目录，避免VOLUME的影响
RUN mkdir -p /tmp/mysql && \
    # 修改配置文件中的datadir为临时目录
    sed -i 's/datadir\s*=\s*\/var\/lib\/mysql/datadir = \/tmp\/mysql/' /etc/mysql/my.cnf && \
    # 初始化临时数据库
    mysqld --initialize-insecure --user=mysql && \
    # 启动MySQL服务
    mysqld --user=mysql & \
    # 等待服务启动完成
    sleep 10 && \
    # 创建目标数据库并导入备份
    mysql -u root -e "CREATE DATABASE ${MYSQL_DATABASE}" && \
    mysql -u root ${MYSQL_DATABASE} < /usr/sql/dump.sql && \
    # 关闭MySQL服务
    mysqladmin -u root shutdown && \
    # 把临时数据复制到默认的VOLUME目录
    cp -r /tmp/mysql/* /var/lib/mysql/ && \
    chown -R mysql:mysql /var/lib/mysql && \
    # 恢复原配置
    sed -i 's/datadir\s*=\s*\/tmp\/mysql/datadir = \/var\/lib\/mysql/' /etc/mysql/my.cnf && \
    # 清理临时文件
    rm -rf /tmp/mysql

注意事项：

• 这种方法会让镜像体积大幅增加（包含了MySQL的数据）
• 如果启动容器时挂载了外部数据卷，外部卷的内容会覆盖镜像中的/var/lib/mysql，还是会看到空表
• 每次构建镜像都要重新导入数据，构建速度慢

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