Docker Compose 中 Django 运行卡在"Attaching to"的原因分析

在使用 Docker Compose 部署 Django 项目时，有时会遇到容器启动后卡在 "Attaching to" 状态的情况。这通常表示 Docker 正在尝试附加到容器的标准输入输出流，但遇到了某种阻塞或问题。

常见原因分析

1. Django 应用启动阻塞

Django 应用在启动时可能执行了某些阻塞操作，导致无法继续输出日志：

• 数据库连接等待超时

• 外部服务依赖未就绪

• 长时间运行的初始化任务

• 死循环或无限等待

2. 日志驱动配置问题

Docker 的日志驱动配置可能导致输出缓冲：

• 默认日志驱动可能缓冲输出

• 自定义日志驱动配置错误

• 日志轮转设置不当

3. 容器健康检查配置

不恰当的健康检查配置可能导致容器状态异常：

• 健康检查命令执行时间过长

• 健康检查间隔设置不合理

• 健康检查的初始延迟不足

4. 资源限制问题

系统资源不足可能导致容器无法正常启动：

• 内存不足导致 OOM

• CPU 资源受限

• 磁盘空间不足

解决方案

方案1：优化 Django 应用启动

检查并优化 Django 应用的启动流程：

# settings.py
import time
import os

# 添加启动延迟，确保数据库等服务就绪
def wait_for_db():
    import django
    django.setup()
    from django.db import connections
    from django.db.utils import OperationalError
    
    max_retries = 30
    retry_count = 0
    
    while retry_count < max_retries:
        try:
            db_conn = connections['default']
            db_conn.cursor()
            print("Database connection established")
            return True
        except OperationalError:
            print(f"Database unavailable, waiting... ({retry_count + 1}/{max_retries})")
            retry_count += 1
            time.sleep(2)
    
    raise Exception("Database connection failed after multiple attempts")

# 在 ready() 方法中调用
class MyAppConfig(AppConfig):
    name = 'myapp'
    
    def ready(self):
        # 仅在主进程中执行，避免重复执行
        if os.environ.get('RUN_MAIN') == 'true':
            wait_for_db()

方案2：调整 Docker Compose 配置

优化 docker-compose.yml 文件配置：

version: '3.8'

services:
  web:
    build: .
    command: >
      sh -c "
      python manage.py migrate &&
      python manage.py collectstatic --noinput &&
      gunicorn myproject.wsgi:application --bind 0.0.0.0:8000
      "
    ports:
      - "8000:8000"
    depends_on:
      - db
      - redis
    environment:
      - DJANGO_SETTINGS_MODULE=myproject.settings.production
    # 禁用日志缓冲
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
    # 添加健康检查
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000/health/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  db:
    image: postgres:13
    environment:
      POSTGRES_DB: myproject
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    # 数据库健康检查
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d myproject"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  postgres_data:

方案3：使用非交互式终端

修改 Dockerfile 或使用不同的运行方式：

# Dockerfile
FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

# 创建非root用户
RUN adduser --disabled-password --gecos '' appuser && chown -R appuser:appuser /app
USER appuser

# 使用 exec 形式的 CMD
CMD ["gunicorn", "myproject.wsgi:application", "--bind", "0.0.0.0:8000"]

方案4：调试和诊断

使用以下方法进行深入诊断：

# 查看容器详细日志
docker-compose logs --tail=100 web

# 进入容器进行调试
docker-compose run --rm web bash

# 检查容器状态和资源使用
docker stats $(docker-compose ps -q)

# 检查容器详细信息
docker inspect $(docker-compose ps -q web)

预防措施

1. 实施渐进式启动

在服务间依赖复杂的环境中，实施渐进式启动策略：

• 使用健康检查确保依赖服务就绪

• 实现重试机制和超时控制

• 添加启动顺序依赖管理

2. 优化日志配置

合理配置日志系统以避免缓冲问题：

# settings.py
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'verbose',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['console'],
            'level': 'INFO',
            'propagate': True,
        },
    },
}

3. 监控和告警

建立完善的监控体系：

• 设置容器启动时间监控

• 配置服务可用性告警

• 实施性能基线监控

总结

Docker Compose 中 Django 卡在 "Attaching to" 状态通常由应用启动阻塞、日志配置问题或资源限制引起。通过优化应用启动流程、调整 Docker 配置、实施适当的健康检查以及建立监控机制，可以有效预防和解决此类问题。建议在生产环境中采用渐进式启动策略和全面的监控方案，以确保服务的可靠性和稳定性。

Docker ComposeDjango容器启动阻塞Attaching to解决方案Docker日志缓冲容器健康检查修改时间：2026-05-04 06:47:44