Docker环境下Cookiecutter Django执行manage.py命令报DATABASE_URL错误求助

1. 让容器自动加载.env配置文件 #

Cookiecutter Django生成的项目根目录自带.env文件，里面包含DATABASE_URL、SECRET_KEY等所有必需的环境变量。启动容器时必须让它加载这个文件：

• 用Docker Compose的话，修改docker-compose.yml的web服务配置：

  services:
    web:
      env_file:
        - .env  # 把本地根目录的.env挂载到容器内，自动导入所有变量
      # 其他原有配置保持不变
  

• 直接用docker run命令启动容器，加上--env-file参数：

  docker run --env-file .env your-django-image-name
  

2. 确认.env文件的配置正确性 #

检查.env里的DATABASE_URL格式是否匹配你的数据库服务，比如PostgreSQL的格式：

DATABASE_URL=postgres://用户名:密码@db服务名称:5432数据库名

注意这里的db服务名称要和你Docker Compose里数据库服务的container_name一致。

3. 进入容器执行命令时确保变量加载 #

如果是手动进入容器后执行python manage.py：

• 要么挂载.env后再进入：

  docker exec -it --env-file .env 你的容器名 /bin/bash
  

• 要么进入容器后手动加载已挂载的.env文件（假设文件在项目根目录）：

  source .env
  python manage.py migrate  # 之后再执行你的管理命令
  

4. 验证环境变量是否生效 #

进入容器后执行以下命令，确认变量已正确加载：

echo $DATABASE_URL

能输出正确的数据库连接字符串，再执行python manage.py就不会报初始错误了。

5. 处理后续其他环境变量异常 #

如果还有其他变量缺失，直接检查.env文件，确保Cookiecutter Django要求的变量（比如DEBUG、ALLOWED_HOSTS）都已配置，自定义的环境变量也要同步添加到文件中，再重新启动容器加载。

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