为什么MySQL服务无法访问？Docker容器启动顺序引发连接拒接问题

嘿，这个问题我太熟了！咱们先把根源说透：你在docker-compose.yml里用的depends_on，只是保证MySQL容器先启动，但它完全不管MySQL服务是不是真的准备好接受连接了——MySQL容器启动后还得初始化数据库、加载配置，这得花个几秒，而你的Flask容器一启动就急着连数据库，肯定会触发连接拒绝的错误。

你的临时修复（故障重启策略）虽然能让容器最终跑起来，但属于被动补救，下面给你几个更可靠的主动解决方案：

方案1：在Flask代码里加连接重试逻辑 #

最简单的方式，直接在数据库连接代码里加个循环，直到成功连上为止。修改你的Python代码：

import mysql.connector
from mysql.connector.errors import InterfaceError
import time

# 循环重试连接MySQL，直到成功
mydb = None
while not mydb:
    try:
        mydb = mysql.connector.connect(
            host="mysqldb", 
            user="root",
            password="root", 
            database="myapp", 
            port="3306"
        )
        print("✅ 成功连接到MySQL数据库")
    except InterfaceError:
        print("⏳ MySQL还没准备好，5秒后重试...")
        time.sleep(5)

这个方案不用改Docker配置，代码层面就能搞定，适合快速调试。

方案2：用wait-for-it.sh脚本等待端口就绪 #

这是个通用的小工具，能让Flask容器等MySQL的3306端口可用后再启动：

1. 把wait-for-it.sh脚本放到你的项目根目录（这是个专门用来等待服务就绪的工具，你可以手动创建或从可信渠道获取）
2. 修改docker-compose.yml里flask-app的启动命令：

flask-app:
    build: .
    ports:
      - "5000:5000"
    depends_on:
      - mysqldb
    command: ["./wait-for-it.sh", "mysqldb:3306", "--", "python3", "app.py"]

3. 在你的Dockerfile里给脚本加执行权限：

RUN chmod +x wait-for-it.sh

这个方案通用性强，适合各种服务依赖的场景。

方案3：用Docker原生Healthcheck（推荐） #

利用Docker的健康检查功能，让Flask容器只在MySQL服务真正健康后才启动——刚好你的docker-compose.yml用的是3.7版本，完全支持这个特性。

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

version: '3.7'
services:
  mysqldb:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: myapp
      MYSQL_PASSWORD: root
    ports:
      - "3333:3306"
    volumes:
      - ./db:/docker-entrypoint-initdb.d/:ro
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
      interval: 5s  # 每5秒检查一次服务状态
      timeout: 5s   # 单次检查超时时间5秒
      retries: 5    # 最多重试5次，还是不健康就判定失败
  flask-app:
    build: .
    ports:
      - "5000:5000"
    depends_on:
      mysqldb:
        condition: service_healthy  # 只在MySQL服务健康后才启动Flask

这个方案完全用Docker原生能力实现，不用额外脚本或代码修改，是生产环境最推荐的方式。

小补充 #

你之前的临时修复（故障重启）虽然能工作，但容器会反复退出重启，直到MySQL就绪，体验不太好。上面的几个方案都是主动等待，能让容器一次启动成功。

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