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

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

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

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

1. 检查端口脚本

   将以下脚本保存到容器内（例如 /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

2. 在启动命令中使用

   修改你的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 伪设备。

1. 检查端口脚本

   将以下脚本保存到容器内：

   #!/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

2. 启动命令

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

关键点说明

特性/方案	使用 netcat (nc)	使用 /dev/tcp
原理	使用网络工具 nc 的 -z 参数进行端口扫描。	利用 bash 的 /dev/tcp 伪文件系统进行 TCP 连接。
依赖	需要安装 netcat-openbsd 或 nmap-ncat 包。	仅依赖 bash（多数镜像已包含）。
优点	语法标准，功能明确，最常用。	无需额外安装任何包，脚本简洁。
潜在缺点	部分极简基础镜像可能未预装。	需要 Bash 环境，若容器使用 sh 可能不支持。

实施建议

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的安装步骤，可以告诉我，我能提供更具体的修改建议。