Docker配置PostgreSQL的Django项目出现角色“admin”不存在错误

这个错误我之前也碰到过，大概率是PostgreSQL容器的初始化逻辑或者配置不一致导致的，下面分几个步骤排查解决：

1. 先确认Django配置和Docker的一致性 #

首先打开你的Django项目的settings.py，检查DATABASES配置是否和docker-compose.yml里的PostgreSQL环境变量完全匹配：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'myproject',  # 对应POSTGRES_DB
        'USER': 'admin',      # 对应POSTGRES_USER
        'PASSWORD': 'admin_pass',  # 对应POSTGRES_PASSWORD
        'HOST': 'db',         # 必须和docker-compose里的db服务名一致
        'PORT': 5432,
    }
}

如果这里的USER写错了（比如写成了postgres），肯定会报角色不存在的错误。

2. 清理PostgreSQL的持久化数据卷（最常见原因） #

PostgreSQL有个特性：只有第一次启动容器时，才会根据POSTGRES_USER、POSTGRES_DB等环境变量初始化数据库和用户。如果你的postgres_data数据卷之前已经存在（比如之前用其他用户配置运行过），那么新的环境变量不会生效，旧的数据库里根本没有admin这个角色。

解决办法是彻底清理旧的数据卷：

# 停止并删除容器，同时删除关联的数据卷（-v参数是关键）
docker-compose down -v

# 重新构建并启动容器
docker-compose up --build

这样PostgreSQL会重新初始化，创建admin角色和myproject数据库。

3. 确保容器启动顺序正确 #

虽然Docker Compose会自动处理服务依赖，但最好在你的web服务（Django服务）里显式添加depends_on，确保PostgreSQL容器完全启动后再启动Django：
补充后的docker-compose.yml大概是这样：

version: '3'
services:
  db:
    image: postgres
    environment:
      - POSTGRES_DB=myproject
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=admin_pass
    container_name: myproject_postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data/

  web:
    build: .
    command: python manage.py runserver 0:8000
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    depends_on:
      - db  # 强制等待db服务启动

volumes:
  postgres_data:

4. 验证PostgreSQL容器里的用户是否存在 #

如果上面的步骤都试过还是有问题，可以直接进入PostgreSQL容器验证admin角色是否存在：

# 进入容器
docker exec -it myproject_postgres bash

# 用admin用户登录数据库
psql -U admin myproject

如果能成功登录，说明用户是存在的，问题可能出在Django的连接配置上；如果登录失败，说明容器初始化时没创建这个用户，那你需要检查docker-compose.yml里的环境变量有没有写错（比如拼写错误）。

内容的提问来源于stack exchange，提问作者Öykü