Docker部署的Django后端无法连接PostgreSQL求助

核心问题分析 #

报错ModuleNotFoundError: No module named 'None'明确说明Django数据库配置中的ENGINE参数被设置为字符串'None'，这是因为对应的环境变量POSTGRES_ENGINE没有被正确传递到Django容器，或者未在.env文件中定义。

分步修复方案 #

1. 检查并完善.env文件 #

确保项目根目录的.env文件包含完整的数据库配置变量，示例：

# 数据库引擎，必须为django.db.backends.postgresql
POSTGRES_ENGINE=django.db.backends.postgresql
# 数据库名称
POSTGRES_DB=your_db_name
# 数据库用户名
POSTGRES_USER=your_db_user
# 数据库密码
POSTGRES_PASSWORD=your_db_password
# 生产库主机映射端口（容器内部默认5432）
POSTGRES_PROD_PORT=5432
# 开发库主机映射端口（容器内部默认5432）
POSTGRES_DEV_PORT=5433
# Django连接容器内部的端口，固定为5432
POSTGRES_PORT=5432

2. 确保Django容器获取所有必要环境变量 #

当前docker-compose.yml中prod和dev服务仅传递了部分变量，需补充数据库相关环境变量，有两种方式：

方式一：显式传递变量

修改prod和dev服务的environment块：

prod:
  # ...其他配置项
  environment:
    LOG_PATH: /var/log
    POSTGRES_HOST: db_prod
    POSTGRES_ENGINE: ${POSTGRES_ENGINE}
    POSTGRES_DB: ${POSTGRES_DB}
    POSTGRES_USER: ${POSTGRES_USER}
    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    POSTGRES_PORT: ${POSTGRES_PORT} # 容器内部端口固定5432

dev:
  # ...其他配置项
  environment:
    LOG_PATH: /var/log
    POSTGRES_HOST: db_dev
    POSTGRES_ENGINE: ${POSTGRES_ENGINE}
    POSTGRES_DB: ${POSTGRES_DB}
    POSTGRES_USER: ${POSTGRES_USER}
    POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    POSTGRES_PORT: ${POSTGRES_PORT} # 容器内部端口固定5432

方式二：直接加载.env文件（推荐）

在prod和dev服务中添加env_file配置，自动加载所有.env变量：

prod:
  # ...其他配置项
  env_file:
    - .env
  environment:
    LOG_PATH: /var/log
    POSTGRES_HOST: db_prod # 覆盖.env中的默认值

dev:
  # ...其他配置项
  env_file:
    - .env
  environment:
    LOG_PATH: /var/log
    POSTGRES_HOST: db_dev # 覆盖.env中的默认值

3. 优化Django配置，添加默认值 #

修改Django的settings.py中数据库配置，给环境变量添加默认值，避免变量缺失时出现None：

# Database
# https://docs.djangoproject.com/en/4.1/ref/settings/#databases
DATABASES = {
    'default': {
        'ENGINE': os.getenv('POSTGRES_ENGINE', 'django.db.backends.postgresql'),
        'NAME': os.getenv('POSTGRES_DB', 'default_db'),
        'USER': os.getenv('POSTGRES_USER', 'default_user'),
        'PASSWORD': os.getenv('POSTGRES_PASSWORD', ''),
        'HOST': os.getenv('POSTGRES_HOST', 'localhost'),
        'PORT': os.getenv('POSTGRES_PORT', '5432'),
    }
}

4. 清理并重新启动容器 #

修改配置后，执行以下命令重置容器：

# 停止并删除所有容器
docker-compose down

# 重新构建Django服务镜像（避免缓存影响）
docker-compose build --no-cache

# 启动所有服务
docker-compose up -d

额外优化建议 #

• 删除db_prod和db_dev服务中的POSTGRES_ENGINE环境变量，PostgreSQL容器不需要该参数。
• 确认Django的依赖文件requirements.txt中包含psycopg2-binary或psycopg2，这是连接PostgreSQL的必要库。
• 检查.env文件权限，确保容器能读取（当前配置已挂载为只读，需保证文件所有者权限正确）。

内容的提问来源于stack exchange，提问作者B. Mohammad