Django切换Docker+PostgreSQL后AUTH_USER_MODEL引发连接及模型冲突问题

一、解决PostgreSQL连接失败问题 #

你的核心错误是混淆了主机端口和容器内部端口，加上服务启动顺序不匹配导致的连接拒绝：

1. 修正Docker端口映射与Django数据库配置 #

• 在docker-compose.yml中，PostgreSQL服务的端口映射要把主机的5433映射到容器内部默认的5432端口：

services:
  db:
    image: postgres:latest
    environment:
      POSTGRES_USER: zane15
      POSTGRES_PASSWORD: zane15
      POSTGRES_DB: zane15
    ports:
      - "5433:5432" # 主机端口:容器内部端口

• 修改settings.py中的数据库端口为容器内部的5432（Django在容器内连接PostgreSQL，用的是容器内网端口，不是主机端口）：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'zane15',
        'USER': 'zane15',
        'PASSWORD': 'zane15',
        'HOST': 'db',
        'PORT': 5432 # 改为容器内部端口
    }
}

2. 确保PostgreSQL就绪后再启动Django #

在docker-compose.yml中给web服务添加健康检查依赖，避免Django在PostgreSQL未启动完成时尝试连接：

services:
  db:
    # ... 其他配置
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U zane15 -d zane15"]
      interval: 5s
      timeout: 5s
      retries: 5
  web:
    # ... 其他配置
    depends_on:
      db:
        condition: service_healthy

二、解决反向访问器冲突与主键警告 #

1. 修复反向访问器冲突 #

出现fields.E304错误是因为Django同时加载了默认的auth.User和你自定义的accounts.User，导致反向关联的名称冲突。解决方法：

• 如果你是新项目：直接保留AUTH_USER_MODEL = 'accounts.User'，清空现有数据库卷后重新迁移：

docker-compose down -v
docker-compose up --build
docker-compose exec web python manage.py migrate

• 如果你是中途更换用户模型（不推荐）：在自定义User中显式指定关联字段的related_name：

class User(AbstractUser):
    is_student = models.BooleanField(default=False)
    is_professor = models.BooleanField(default=False)
    token = models.CharField(max_length=200, blank=True)
    signup_confirmation = models.BooleanField(default=False)

    # 自定义关联名称避免冲突
    groups = models.ManyToManyField(
        'auth.Group',
        related_name='custom_user_groups',
        blank=True,
        verbose_name='groups'
    )
    user_permissions = models.ManyToManyField(
        'auth.Permission',
        related_name='custom_user_permissions',
        blank=True,
        verbose_name='user permissions'
    )

2. 解决主键类型警告 #

在settings.py中添加全局默认主键配置：

DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

或者在accounts/apps.py中为当前应用单独设置：

from django.apps import AppConfig

class AccountsConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'accounts'

三、完整执行流程 #

1. 按上述要求修改docker-compose.yml、settings.py和models.py（如需）。
2. 清理旧的Docker数据卷：docker-compose down -v。
3. 重新构建并启动服务：docker-compose up --build。
4. 执行数据库迁移：docker-compose exec web python manage.py migrate。

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