Docker容器启动后网站长时间报Error 503问题排查求助

看起来你的问题核心是容器启动顺序和服务就绪状态不匹配——虽然所有容器都显示"启动成功"，但你的PHP/Apache服务实际要等MySQL完全初始化完成后才能正常处理请求，这中间的间隙就导致了5分钟左右的503错误。结合你提供的日志：Apache在13:22启动，但直到13:26才处理第一个成功请求，刚好对应MySQL初始化的耗时。

下面是具体的解决方案：

1. 给MySQL配置健康检查，确保应用只在DB就绪后启动 #

Docker Compose默认是并行启动所有容器的，这意味着你的Web服务可能在MySQL还没完成初始化（比如创建数据库、加载初始数据）时就已经启动了，此时应用无法连接DB，自然返回503。

在你的docker-compose.yml里给MySQL服务添加健康检查配置，让Compose知道什么时候MySQL真的就绪：

services:
  mysql:
    image: mysql:5.7 # 或你使用的版本
    environment:
      MYSQL_ROOT_PASSWORD: your_root_pass
      MYSQL_DATABASE: your_app_db
    healthcheck:
      # 用mysqladmin ping来检测DB是否可连接
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 10s # 每10秒检测一次
      timeout: 5s # 超时时间5秒
      retries: 5 # 最多重试5次
      start_period: 30s # 启动后30秒再开始检测（给MySQL初始化留基础时间）

然后修改你的Web服务（PHP/Apache、Node.js）的配置，让它们依赖MySQL的健康状态，而不是仅仅依赖容器启动：

php-apache:
    build: ./your-php-dir
    depends_on:
      mysql:
        condition: service_healthy # 只有当MySQL健康检查通过后才启动这个容器
    ports:
      - "80:80"

  nodejs:
    build: ./your-node-dir
    depends_on:
      mysql:
        condition: service_healthy

2. 给应用添加数据库连接重试逻辑 #

即使配置了容器依赖，有时候MySQL可能在健康检查通过后，还需要一点时间处理后续初始化（比如加载大的初始数据）。给你的应用添加连接重试逻辑，避免一次性失败后就无法恢复：

PHP示例（PDO）： #

function getDbConnection() {
    $maxRetries = 20;
    $retryDelay = 10; // 每次重试间隔10秒
    $attempts = 0;

    while ($attempts < $maxRetries) {
        try {
            $dsn = 'mysql:host=mysql;dbname=your_app_db;charset=utf8mb4';
            $pdo = new PDO($dsn, 'root', 'your_root_pass');
            $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
            return $pdo;
        } catch (PDOException $e) {
            error_log("Database connection failed, retrying... (Attempt $attempts/$maxRetries)");
            $attempts++;
            sleep($retryDelay);
        }
    }

    throw new Exception("Failed to connect to database after $maxRetries attempts");
}

Node.js示例（mysql2）： #

const mysql = require('mysql2/promise');

async function getDbConnection() {
    const maxRetries = 20;
    const retryDelay = 10000; // 10秒
    let attempts = 0;

    while (attempts < maxRetries) {
        try {
            const connection = await mysql.createConnection({
                host: 'mysql',
                user: 'root',
                password: 'your_root_pass',
                database: 'your_app_db'
            });
            console.log('Connected to database successfully');
            return connection;
        } catch (err) {
            console.error(`Database connection failed, retrying... (Attempt ${attempts}/${maxRetries})`, err);
            attempts++;
            await new Promise(resolve => setTimeout(resolve, retryDelay));
        }
    }

    throw new Error(`Failed to connect to database after ${maxRetries} attempts`);
}

3. 关于Apache的ServerName警告 #

日志里的AH00558警告只是Apache无法识别服务器的完整域名，不会导致503错误。如果要消除这个警告，可以在Apache的配置文件（比如/etc/apache2/apache2.conf）里添加一行：

ServerName localhost

验证修改效果 #

修改完成后，执行docker-compose down && docker-compose up --build重新部署，此时Web服务会等待MySQL完全就绪后再启动，应该就不会再出现初期的503错误了。如果还有延迟，可以调整MySQL健康检查的start_period参数，或者增加应用重试的次数/间隔。

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