Docker部署Django应用时Celery-Beat无法连接PostgreSQL求助

核心原因 #

celery_beat容器尝试连接127.0.0.1:5432，但在Docker Compose的默认网络环境中，PostgreSQL服务的主机名是db（对应docker-compose.yml中的服务名），而非127.0.0.1。127.0.0.1在容器内指向自身，自然无法连接到PostgreSQL容器。

具体修复步骤 #

1. 修正数据库连接配置 #

检查你的Django配置文件（docerized_app_settings）或.env文件中的数据库HOST配置：

• 确保DATABASES中的HOST字段值为db，而非127.0.0.1或localhost
• 如果使用.env文件，确认其中类似DB_HOST=db的变量设置正确

示例配置（settings.py中）：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.getenv('POSTGRES_DB'),
        'USER': os.getenv('POSTGRES_USER'),
        'PASSWORD': os.getenv('POSTGRES_PASSWORD'),
        'HOST': 'db',  # 关键：用服务名代替127.0.0.1
        'PORT': 5432,
    }
}

2. 处理服务启动时序问题（可选） #

depends_on仅保证容器启动顺序，不保证PostgreSQL服务完全就绪。如果偶尔仍出现连接失败，可以：

• 给celery_beat添加restart: always配置，让容器在连接失败后自动重启重试
• 或者在启动命令前添加等待脚本，确保PostgreSQL就绪后再启动celery_beat

修改docker-compose.yml中的celery-beat服务：

celery-beat:
  build: ./backend
  command: >
    sh -c "until pg_isready -h db -p 5432 -U postgres; do sleep 1; done && celery -A docerized_app_settings beat -l info"
  volumes:
    - ./backend:/usr/src/backend
  env_file:
    - ./.env
  depends_on:
    - db
    - redis
    - app
  restart: always  # 添加自动重启策略
  container_name: docerized_app_celery_beat_dev

注意：使用pg_isready需要容器内安装postgresql-client，可在backend的Dockerfile中添加RUN apk add --no-cache postgresql-client（基于alpine镜像时）

3. 验证网络连通性 #

进入celery_beat容器测试与db的连通性，确认网络无问题：

docker exec -it docerized_app_celery_beat_dev ping db
# 或测试端口连通性
docker exec -it docerized_app_celery_beat_dev telnet db 5432

如果能ping通或telnet连接成功，说明网络正常，问题仍出在配置上。

为什么其他服务正常？ #

app和celery_worker的数据库连接配置正确（使用db作为主机名），因此能正常连接PostgreSQL；而celery_beat的配置沿用了本地环境的127.0.0.1，导致连接失败。

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