Docker部署Django项目仅读取部分.env环境变量问题排查

问题复现 #

通过Docker部署的Django项目，仅能读取数据库相关环境变量及SECRET_KEY，但DJANGO_DEBUG、EMAIL、EMAIL_PASSWORD、DOMAIN等变量无法正常加载。

相关配置 #

• .env文件内容：

DJANGO_DEBUG=changeme(1/0)
DB_NAME=changeme
DB_USER=changeme
DB_PASS=changeme
SECRET_KEY=changeme
EMAIL_PASSWORD=changeme
EMAIL=email@example.com
DOMAIN=example.com

• settings.py中环境变量读取逻辑：

DEBUG = bool(int(os.environ.get('DJANGO_DEBUG', 0)))

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'HOST': os.environ.get('DB_HOST'),
        'NAME': os.environ.get('DB_NAME'),
        'USER': os.environ.get('DB_USER'),
        'PASSWORD': os.environ.get('DB_PASS'),
    }
}

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.gmail.com.'
EMAIL_USE_TLS = True
EMAIL_PORT = 587
EMAIL_HOST_USER = os.environ.get('EMAIL')
EMAIL_HOST_PASSWORD = os.environ.get('EMAIL_PASSWORD')

可能的原因及解决方法 #

1. .env文件格式错误（优先排查） #

DJANGO_DEBUG的值changeme(1/0)包含括号、斜杠等特殊字符，会导致环境变量解析失败；后续转int时会触发异常，最终使用默认值0，表现为“未加载到变量”。

解决： 修改.env中DJANGO_DEBUG为合法值：

DJANGO_DEBUG=1  # 启用调试模式
# 或
DJANGO_DEBUG=0  # 关闭调试模式

2. Docker未正确加载.env文件 #

如果数据库相关变量是通过docker-compose.yml的environment字段直接定义，而非读取.env，就会出现部分变量能读、部分不能读的情况。

检查Docker配置：

• 若使用docker-compose.yml，确保服务配置中添加env_file字段：

services:
  web:
    build: .
    env_file: .env  # 指定加载根目录的.env文件
    # 其他配置...

• 若使用docker run命令，需添加--env-file参数：

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

3. 容器内未正确注入环境变量 #

即使本地.env配置正确，也可能因为挂载路径错误或权限问题导致容器无法读取。

验证方法：
进入容器查看所有环境变量，确认目标变量是否存在：

docker exec -it <你的容器名称/ID> bash
# 进入容器后执行
env

• 如果EMAIL、EMAIL_PASSWORD等变量未出现在输出中，说明Docker未成功注入，需检查.env路径是否正确、挂载权限是否足够。
• 如果变量已存在，说明问题出在Django的读取逻辑。

4. Django未主动加载.env文件 #

原生os.environ.get()仅读取容器的系统环境变量，不会主动读取项目目录下的.env文件。如果数据库变量是通过Docker直接注入（而非.env），就会出现部分变量可用的情况。

解决： 使用django-environ库主动加载.env（推荐）：

1. 安装依赖：

pip install django-environ

2. 在settings.py开头添加加载逻辑：

import environ
import os

# 初始化环境变量读取器
env = environ.Env(
    # 设置默认值，避免未定义时报错
    DJANGO_DEBUG=(bool, False),
)

# 读取项目根目录的.env文件
environ.Env.read_env(os.path.join(os.path.dirname(os.path.abspath(__file__)), '.env'))

# 修改变量读取方式
DEBUG = env('DJANGO_DEBUG')
EMAIL_HOST_USER = env('EMAIL')
EMAIL_HOST_PASSWORD = env('EMAIL_PASSWORD')
# 其他变量同理修改...

5. 变量名拼写或大小写错误 #

再次确认：

• .env中的变量名与settings.py中的os.environ.get()参数完全一致（环境变量大小写敏感）
• 例如：是否把EMAIL写成了EMAIL_USER，EMAIL_PASSWORD写成了EMAIL_PASS等

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