使用Django+Docker执行makemigrations时出现主机名解析错误

报错信息 #

root@debian:/home/suportenpd1/Documentos/setorT# docker-compose run web python manage.py makemigrations
[+] Creating 1/0
 ✔ Container setort-db-1  Created                                                                                                                                                                             0.0s 
[+] Running 1/1
 ✔ Container setort-db-1  Started                                                                                                                                                                             1.1s 
/usr/local/lib/python3.12/site-packages/django/core/management/commands/makemigrations.py:160: RuntimeWarning: Got an error checking a consistent migration history performed for database connection 'default': could not translate host name "db" to address: Name or service not known

  warnings.warn(
No changes detected

相关配置 #

docker-compose.yml #

services:
  db:
    image: postgres:15.6
    volumes:
      - ./data/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=setorT
      - POSTGRES_USER=setorT
      - POSTGRES_PASSWORD=setorT@2024$
    ports:
      - "5432:5432"
  web:
    build: .
    command: ["./wait-for-it.sh", "db:5432", "--", "python", "manage.py", "runserver", "0.0.0.0:8000"]
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    environment:
      - POSTGRES_NAME=setorT
      - POSTGRES_USER=setorT
      - POSTGRES_PASSWORD=setorT@2024$
    depends_on:
      - db

settings.py数据库配置 #

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.environ.get('POSTGRES_NAME'),
        'USER': os.environ.get('POSTGRES_USER'),
        'PASSWORD': os.environ.get('POSTGRES_PASSWORD'),
        'HOST': 'db',
        'PORT': 5432,
    }
}

原因分析 #

• docker-compose run 会创建全新的web容器，不会沿用原服务定义的command逻辑，直接跳过了你配置的wait-for-it.sh等待db就绪的步骤。
• 虽然命令执行时会启动db容器，但PostgreSQL需要时间完成初始化，此时新web容器尝试连接时，db的Docker网络DNS解析可能未生效，或者db服务还未就绪，导致主机名"db"无法解析。

解决办法 #

方案1：先确保db容器完全就绪再执行命令 #

# 启动db容器并后台运行
docker-compose up -d db
# 等待PostgreSQL初始化完成（根据机器性能调整等待时间）
sleep 30
# 执行迁移命令
docker-compose run web python manage.py makemigrations

方案2：在run命令中加入等待逻辑 #

直接在命令中调用wait-for-it.sh，确保db就绪后再执行makemigrations：

docker-compose run web ./wait-for-it.sh db:5432 -- python manage.py makemigrations

注意：需确保web镜像中已包含wait-for-it.sh脚本（从你的配置看已存在）。

方案3：使用exec进入运行中的容器执行（推荐） #

如果整个服务已经启动（web服务自带等待逻辑），直接进入运行中的web容器执行命令：

# 启动所有服务并后台运行
docker-compose up -d
# 进入web容器执行迁移命令
docker-compose exec web python manage.py makemigrations

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