Django切换PostgreSQL后Docker环境下密码认证失败求助

核心问题原因 #

PostgreSQL默认不存在root这个数据库角色，它的默认超级用户是postgres。你的Django配置还在沿用MySQL时期的root用户连接PostgreSQL，这直接导致了认证失败。

分步解决方案 #

1. 修正Django的数据库配置（settings.py）

检查settings.py中的DATABASES配置，将数据库用户从root改为postgres（或你自定义的PostgreSQL用户名）：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': os.environ.get('POSTGRES_DB'),
        'USER': os.environ.get('POSTGRES_USER', 'postgres'),  # 此处禁止使用root
        'PASSWORD': os.environ.get('POSTGRES_PASSWORD'),
        'HOST': os.environ.get('POSTGRES_HOST', 'db'),
        'PORT': os.environ.get('POSTGRES_PORT', '5432'),
    }
}

如果用环境变量注入配置，确保.env或.docker-compose.env中的POSTGRES_USER值为postgres（而非root）。

2. 检查Docker Compose的PostgreSQL服务配置

确保docker-compose.yml中的postgres服务正确传递用户、密码等环境变量：

services:
  db:
    image: postgres:14-alpine  # 推荐使用稳定版本镜像
    env_file:
      - .docker-compose.env
    environment:
      - POSTGRES_USER=${POSTGRES_USER:-postgres}  # 默认值设为postgres
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=${POSTGRES_DB}
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    networks:
      - app-network  # 确保和web服务在同一网络下

  web:
    build: ./webserver
    env_file:
      - .env
    depends_on:
      - db
    networks:
      - app-network

volumes:
  postgres_data:
networks:
  app-network:

3. 清理旧数据库卷（必要操作）

如果之前已经启动过postgres容器，可能已生成包含错误用户的持久化数据卷，需彻底清理后重新初始化：

# 停止并删除容器及关联卷
docker-compose down -v
# 先启动数据库服务等待初始化完成
docker-compose up -d db
# 约30秒后启动web服务
docker-compose up -d web

4. 重新执行数据库迁移

进入web容器执行迁移命令：

docker exec -it <web容器名> python manage.py makemigrations
docker exec -it <web容器名> python manage.py migrate

额外优化建议 #

PostgreSQL权限模型比MySQL更严格，建议不要直接用postgres超级用户连接应用，可创建专用应用用户：

1. 进入postgres容器：docker exec -it <db容器名> psql -U postgres
2. 创建新用户和数据库：

CREATE USER django_user WITH PASSWORD 'your_secure_password';
CREATE DATABASE django_db OWNER django_user;
GRANT ALL PRIVILEGES ON DATABASE django_db TO django_user;

3. 同步更新settings.py和环境变量中的POSTGRES_USER、POSTGRES_DB值。

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