如何用Docker搭建Django+RabbitMQ+Celery环境及连接报错排查

1. CELERY_BROKER_URL 配置错误（核心问题） #

你当前的配置CELERY_BROKER_URL = 'amqp://localhost'是错误的，原因是：

• Docker Compose 内的每个容器都有独立的网络命名空间，localhost指向的是Celery容器自身的环回地址，而RabbitMQ运行在独立的rabbitmq3服务容器中，两者通过Docker内置的DNS做服务名解析通信。
• 修复方式：将settings.py中的配置修改为：

CELERY_BROKER_URL = 'amqp://guest:guest@rabbitmq3:5672//'

说明：RabbitMQ默认初始用户名、密码均为guest，地址填你docker-compose中定义的RabbitMQ服务名rabbitmq3即可。

2. docker-compose.yml 存在的优化点 #

你当前的docker-compose配置可以正常使用，但存在偶发的启动顺序问题：

• depends_on仅控制容器的启动先后顺序，不会等待RabbitMQ完全初始化就绪再启动Celery，可能会出现RabbitMQ还在启动中就被Celery请求，导致首次连接失败。
• 你已经配置了Celery的restart: always，连接失败后会自动重试，大部分场景下可以正常工作，如果需要更稳定的启动逻辑，可以给RabbitMQ服务增加健康检查配置：

rabbitmq3:
  container_name: "rabbitmq"
  image: rabbitmq:3-management-alpine
  ports:
    - 5672:5672
    - 15672:15672
  # 新增健康检查
  healthcheck:
    test: ["CMD", "rabbitmq-diagnostics", "check_port_connectivity"]
    interval: 5s
    timeout: 5s
    retries: 5

同时修改Celery的depends_on配置，等待RabbitMQ健康检查通过后再启动：

celery:
    restart: always
    build:
      context: .
    command: celery -A test_celery worker -l info
    volumes:
      - .:/test_celery
    env_file:
      - ./.env
    depends_on:
      - app
      rabbitmq3:
        condition: service_healthy

3. 验证方法 #

修改配置后重新执行docker-compose up -d，如果仍有连接问题，可以进入Celery容器执行ping rabbitmq3验证网络连通性，执行nc -zv rabbitmq3 5672验证端口是否开放。

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