我之前也碰到过几乎一模一样的问题，这个错误的核心逻辑其实很清晰：你的PostgreSQL容器里压根没创建名为falcon的数据库角色，但你的Django应用正尝试用这个角色建立连接。下面是一步步的排查和解决方法：

1. 确认PostgreSQL容器的初始化配置 #

PostgreSQL官方镜像只会在第一次启动容器且数据卷为空的时候，根据你设置的环境变量初始化数据库、用户和密码。你得确保db服务的配置里包含这些关键环境变量：

# docker-compose.yml中db服务的示例配置
services:
  db:
    image: postgres:latest
    environment:
      - POSTGRES_USER=falcon  # 必须和Django配置里的数据库用户完全一致
      - POSTGRES_PASSWORD=your_db_password  # 对应Django配置里的PASSWORD
      - POSTGRES_DB=your_django_db_name  # 对应Django配置里的NAME
    volumes:
      - postgres_data:/var/lib/postgresql/data/

如果之前你没设置这些环境变量就启动过db容器，PostgreSQL已经初始化了默认的postgres用户，这时候哪怕后来补上环境变量也不会生效——因为镜像只会做一次初始化。这种情况你需要清理掉PostgreSQL的数据卷，重新启动：

# 停止并删除现有容器
docker-compose down
# 删除数据卷（注意：这会清空所有数据库数据，谨慎操作）
docker volume rm your_project_postgres_data
# 重新启动容器
docker-compose up -d

2. 验证Django的数据库配置是否匹配 #

打开你的Django项目settings.py，确保DATABASES配置里的参数和PostgreSQL容器的初始化设置完全对应：

# settings.py中的数据库配置示例
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'your_django_db_name',
        'USER': 'falcon',  # 必须和POSTGRES_USER完全一致
        'PASSWORD': 'your_db_password',  # 必须和POSTGRES_PASSWORD完全一致
        'HOST': 'db',  # 对应docker-compose里的db服务名，Docker网络内可直接通过服务名访问
        'PORT': '5432',
    }
}

这里要特别注意HOST设为db——在Docker Compose的默认网络里，服务名就是容器的主机名，Django通过这个主机名才能正确访问到PostgreSQL容器。

3. 排查容器启动顺序问题 #

有时候哪怕配置全对，也可能因为Django容器先于PostgreSQL容器完成启动，导致连接失败。虽然你遇到的是角色不存在的错误，但添加启动依赖能避免这类时序问题：

在docker-compose.yml的api服务里增加配置：

services:
  api:
    # 其他原有配置...
    depends_on:
      - db
    # 可选：用wait-for-it工具确保PostgreSQL完全就绪后再启动Django
    command: ["./wait-for-it.sh", "db:5432", "--", "python", "manage.py", "runserver", "0.0.0.0:8000"]

按上面的步骤调整后，重新启动容器，应该就能解决角色不存在的问题了。

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