项目容器启动时MySQL端口检测的问题解决

要解决容器启动时MySQL端口检测的问题，用脚本轮询并检测端口可用性是完全可行的。将下面的示例脚本替代Dockerfile或启动脚本中原来的sleep 15命令即可。

方案一：使用 netcat (nc) 命令轮询（推荐）

nc 是最常用且最可靠的工具。如果容器中没有，可以在构建镜像时安装。

检查端口脚本
将以下脚本保存到容器内（例如 /wait-for-mysql.sh）并赋予执行权限：

#!/bin/sh
# wait-for-mysql.sh

host="$1"
port="$2"
shift 2
cmd="$@"

echo "正在等待 MySQL ($host:$port) 启动..."

while ! nc -z $host $port; do
  sleep 3
done

echo "MySQL 已就绪，启动应用..."
exec $cmd

在启动命令中使用
修改你的Docker启动命令，替换掉原来的sleep 15：

# 原命令 (使用睡眠)：
# CMD nginx; echo "Waiting for MySQL to start..."; sleep 15; java -jar /app/api/app.jar ...

# 新命令 (使用轮询)：
CMD nginx; /wait-for-mysql.sh mysql 3306 java -jar /app/api/app.jar --spring.profiles.active=prod --spring.datasource.url="jdbc:mysql://${DB_HOST}:${DB_PORT:-3306}/${DB_NAME}?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&useSSL=false&allowPublicKeyRetrieval=true" --spring.datasource.username=${DB_USER} --spring.datasource.password=${DB_PASS} --sa-token.is-concurrent=${SA_TOKEN_IS_CONCURRENT:-false} --sa-token.jwt-secret-key=${SA_TOKEN_JWT_SECRET_KEY}

脚本逻辑：脚本会在 while 循环中每隔 sleep 3 秒，使用 nc -z 尝试连接 mysql:3306。成功后，再执行后面的Java启动命令 (exec $cmd)。

方案二：使用 bash 内置的 /dev/tcp（无需额外工具）

如果容器环境（如Alpine基础镜像）没有安装 nc，并且不便安装，可以利用bash内置的 /dev/tcp 伪设备。

检查端口脚本
将以下脚本保存到容器内：

#!/bin/bash
# wait-for-mysql-tcp.sh

host="$1"
port="$2"
shift 2
cmd="$@"

echo "正在等待 MySQL ($host:$port) 启动..."

until bash -c "(echo > /dev/tcp/$host/$port) >/dev/null 2>&1"; do
    sleep 3
done

echo "MySQL 已就绪，启动应用..."
exec $cmd

启动命令
修改启动命令，调用这个脚本，用法与方案一相同。

关键点说明

实施建议

1. 选择方案：如果你的镜像基于 alpine，建议使用方案二（/dev/tcp），因为安装 nc 会增加镜像大小。如果是 ubuntu 或 debian 等较完整的镜像，两个方案都可行，使用 nc 的命令更直观。
2. 修改 Dockerfile：确保将上述脚本复制到镜像中，并在 CMD 指令中使用。

   # 以方案一为例，需在Dockerfile中安装nc并复制脚本
   FROM your-base-image
   # 安装netcat (例如在基于Debian的镜像中)
   RUN apt-get update && apt-get install -y netcat-openbsd && rm -rf /var/lib/apt/lists/*
   # 复制等待脚本
   COPY wait-for-mysql.sh /usr/local/bin/
   RUN chmod +x /usr/local/bin/wait-for-mysql.sh
   # 修改启动命令
   CMD ["sh", "-c", "nginx; wait-for-mysql.sh mysql 3306 java -jar /app/api/app.jar ..."]
   

这个方案能精确控制等待时机，解决了固定时间可能过长或过短的问题。如果你需要根据特定基础镜像（例如Alpine）调整Dockerfile的安装步骤，可以告诉我，我能提供更具体的修改建议。

到此这篇关于项目容器启动时MySQL端口检测的问题解决的文章就介绍到这了,更多相关MySQL端口检测内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论