如何让MySQL Docker容器在entrypoint脚本失败时仍能启动

针对基于ubuntu/mysql:8.0-22.04_beta镜像构建容器时，/docker-entrypoint-initdb.d/下的SQL脚本执行失败导致容器无法启动的问题，有以下几种实用方案：

方案一：自定义Entrypoint捕获错误并启动Shell #

创建一个自定义的entrypoint脚本，在原初始化逻辑失败后自动进入bash，保持容器运行以便排查：

1. 编写custom-entrypoint.sh脚本：

#!/bin/bash
set -euo pipefail

# 执行官方entrypoint的初始化流程，目标是启动mysqld
/docker-entrypoint.sh mysqld || {
    echo "初始化脚本执行失败，启动交互式Shell供排查"
    # 替换为bash保持容器运行
    exec bash
}

2. 在Dockerfile中引入该脚本并替换entrypoint：

FROM ubuntu/mysql:8.0-22.04_beta

COPY custom-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/custom-entrypoint.sh

ENTRYPOINT ["custom-entrypoint.sh"]

构建镜像后启动容器，若初始化失败，容器会直接进入bash环境，你可以查看/var/log/mysql/下的日志，或手动执行SQL脚本排查问题。

方案二：启动容器时临时覆盖Entrypoint #

无需修改Dockerfile，启动容器时通过--entrypoint参数直接指定执行逻辑，适合临时调试：

docker run -it --rm \
  --entrypoint bash \
  your-mysql-image \
  -c "/docker-entrypoint.sh mysqld || exec bash"

这条命令会先尝试执行官方初始化流程，失败后立即进入bash。

方案三：修改官方Entrypoint忽略脚本执行错误 #

如果希望即使部分SQL脚本执行失败，容器仍能正常启动MySQL服务，可以修改官方entrypoint中执行初始化脚本的逻辑，忽略单个脚本的错误：

1. 从官方镜像中复制docker-entrypoint.sh脚本到本地，找到执行SQL脚本的片段（类似如下内容）：

for f in /docker-entrypoint-initdb.d/*; do
    case "$f" in
        *.sh)     echo "$0: running $f"; . "$f" ;;
        *.sql)    echo "$0: running $f"; "${mysql[@]}" < "$f"; echo ;;
        *.sql.gz) echo "$0: running $f"; gunzip -c "$f" | "${mysql[@]}"; echo ;;
        *)        echo "$0: ignoring $f" ;;
    esac
    echo
done

2. 修改执行SQL的命令，添加错误忽略（|| true）或错误提示：

for f in /docker-entrypoint-initdb.d/*; do
    case "$f" in
        *.sh)     echo "$0: running $f"; . "$f" || echo "Warning: $f execution failed" ;;
        *.sql)    echo "$0: running $f"; "${mysql[@]}" < "$f" || echo "Warning: $f execution failed"; echo ;;
        *.sql.gz) echo "$0: running $f"; gunzip -c "$f" | "${mysql[@]}" || echo "Warning: $f execution failed"; echo ;;
        *)        echo "$0: ignoring $f" ;;
    esac
    echo
done

3. 在Dockerfile中替换官方entrypoint：

FROM ubuntu/mysql:8.0-22.04_beta

COPY docker-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/docker-entrypoint.sh

这种方案会让初始化流程继续执行后续脚本，最终正常启动MySQL，适合需要容器保持运行但允许部分初始化脚本出错的场景。

注意：以上方案仅适用于开发环境，生产环境请勿忽略初始化错误，避免数据库状态不一致。

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