如何配置docker-compose健康检查让NodeJS容器在MySQL就绪后启动

解决方案 #

你只需要修改docker-compose.yml的两处配置即可实现需求：

1. 给mysql服务添加健康检查规则，验证MySQL完成初始化、可以正常处理连接
2. 给app服务的depends_on参数添加启动条件，只有mysql服务处于健康状态时才启动app容器

修改后的完整docker-compose.yml #

version: "3.0"
services:
    mysql:
        image: mysql
        restart: unless-stopped
        environment:
          MYSQL_ROOT_PASSWORD: root
          MYSQL_DATABASE: crud
        ports:
          - "3306:3306"
        hostname: mysql
        volumes:
          - ./mysql/employees.sql:/docker-entrypoint-initdb.d/employees.sql
        # 新增健康检查配置
        healthcheck:
          # 检查命令：尝试登录MySQL并访问初始化的crud库，验证服务和数据都就绪
          test: ["CMD", "mysql", "-u", "root", "-proot", "-e", "USE crud;"]
          # 每5秒检查一次
          interval: 5s
          # 单次检查超时时间3秒
          timeout: 3s
          # 最多重试10次
          retries: 10
          # 启动后先等30秒再开始检查，适配你的SQL初始化耗时
          start_period: 30s
    app:
        build: .
        container_name: employees_app
        hostname: app
        depends_on:
          mysql:
            # 指定依赖mysql的健康状态为健康才启动
            condition: service_healthy
        ports:
          - "3000:3000"

参数说明 #

• 健康检查的test命令选择直接访问crud库，而不是仅用mysqladmin ping，是为了确保初始化SQL执行完成、业务库可用，避免出现MySQL进程启动但数据未初始化完成的假就绪状态
• start_period设为30秒刚好匹配你提到的初始化耗时，这段时间内检查失败不会计入重试次数，不会误判服务不健康
• 不需要修改你的Dockerfile，也不需要在NodeJS代码中加重试逻辑，该配置完全由Docker Compose层面控制启动顺序

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