Docker Compose中如何让Maven容器等待MySQL容器完全就绪

关于无apt-get环境下安装网络检测工具的说明 #

如果容器内已经移除了所有包管理器组件，不建议强行安装ping、nc这类工具：

• 手动拷贝静态编译的二进制需要匹配容器的CPU架构、libc版本，很容易出现兼容性问题，还会额外增加镜像维护成本
• 这类工具根本无法满足核心需求：ping仅能检测主机是否存活，完全感知不到服务状态；nc仅能检测端口是否被监听，无法判断MySQL是否完成初始化脚本执行、是否能正常响应SQL请求——很多场景下MySQL端口已经处于监听状态，但初始化流程还没跑完，此时建立连接依然会报错。

零额外依赖的MySQL就绪等待实现方案 #

以下方案全部不需要在Maven容器内安装额外软件，完全通过CLI或编排配置实现：

方案1：编排层健康检查（维护成本最低，最推荐） #

直接利用docker-compose的健康检查依赖能力，把就绪判断逻辑放到MySQL容器侧，不需要修改Maven容器的任何启动命令：

services:
  mysql:
    image: mysql:8.0
    # 其余原有mysql配置（环境变量、卷挂载、初始化脚本配置等）保持不变
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 3s
      timeout: 2s
      retries: 100
  maven:
    # 其余原有maven配置保持不变
    depends_on:
      mysql:
        condition: service_healthy

配置后Maven容器会等待MySQL健康检查连续通过（即服务完全可用）后才启动，不需要在容器内写任何等待逻辑。

方案2：利用Maven原生插件实现CLI等待 #

如果不想修改编排层的健康检查配置，可以直接在Maven的启动命令前加一行SQL执行探测，利用Maven自带的SQL插件自动重试，直到能正常执行查询语句，完全不需要侵入业务代码：

# 等待MySQL可正常响应查询后，再执行原有maven启动命令
mvn sql:execute -Dsql.driver=com.mysql.cj.jdbc.Driver -Dsql.url=jdbc:mysql://mysql:3306/你的业务库名 -Dsql.username=你的数据库账号 -Dsql.password=你的数据库密码 -Dsql.sql="SELECT 1" -Dsql.maxRetries=100 -Dsql.retryInterval=3000 && 替换为你原有的maven启动命令

这个方案直接复用Maven的原生能力，不需要额外引入任何组件。

方案3：利用容器自带JDK实现单文件检测脚本 #

Maven容器默认预装JDK环境，Java 11+支持直接运行单文件Java源码，不需要提前编译，几行代码就能实现精准的就绪检测：

cat > /tmp/WaitMysql.java << 'EOF'
import java.net.*;
public class WaitMysql {
    public static void main(String[] args) throws Exception {
        String host = args[0];
        int port = Integer.parseInt(args[1]);
        for(int i=0; i<100; i++){
            try(Socket s = new Socket()){
                s.connect(new InetSocketAddress(host, port), 1000);
                System.out.println("MySQL service is ready");
                return;
            }catch(Exception e){
                System.out.printf("Wait for MySQL, retry %d/100...\n", i+1);
                Thread.sleep(3000);
            }
        }
        throw new RuntimeException("Wait MySQL timeout after 5 minutes");
    }
}
EOF
java /tmp/WaitMysql.java mysql 3306 && 替换为你原有的maven启动命令

如果需要更精准的检测，只需要把本地Maven仓库中已经缓存的MySQL JDBC驱动加入classpath，加几行JDBC连接逻辑执行SELECT 1即可，检测精度远高于nc等网络工具。

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