Docker环境下Django读取.env文件配置CSRF_TRUSTED_ORIGINS失败

问题现象 #

直接在settings.py中硬编码CSRF_TRUSTED_ORIGINS时应用正常运行，但从.env.dev文件读取环境变量DJANGO_CSRF并赋值给该变量时，触发错误：AttributeError: 'NoneType' object has no attribute 'split'。

相关代码片段：
settings.py：

# CSRF_TRUSTED_ORIGINS=["https://www.site1.fr", "http://www.site1.fr"]
CSRF_TRUSTED_ORIGINS= os.environ.get("DJANGO_CSRF").split(" ")

.env.dev：

DJANGO_CSRF=https://www.site1.fr http://www.site1.fr

核心原因 #

1. 环境变量未正确注入：Docker-Compose可能未将.env.dev中的变量加载到Django容器的运行环境中，导致os.environ.get("DJANGO_CSRF")返回None。
2. 无空值容错处理：直接对os.environ.get的返回值调用split()，若变量不存在则触发属性错误。

解决方案 #

1. 确保Docker-Compose正确加载.env.dev #

检查docker-compose.yml配置，确认已通过env_file指定.env.dev路径，示例：

services:
  web:
    build: .
    # 加载.env.dev中的环境变量
    env_file:
      - .env.dev
    ports:
      - "8000:8000"
    # 其他服务配置...

注意：文件路径需与实际位置一致，避免拼写错误（比如把.env.dev写成.env_dev）。

2. 修改settings.py增加容错逻辑 #

避免直接对可能为None的变量调用split()，添加默认值和空元素过滤：

import os

# 获取环境变量，不存在则返回空字符串
csrf_origins_raw = os.environ.get("DJANGO_CSRF", "")
# 分割后过滤空字符串，防止环境变量为空时生成无效列表元素
CSRF_TRUSTED_ORIGINS = [origin.strip() for origin in csrf_origins_raw.split(" ") if origin.strip()]

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

可在settings.py中临时添加打印语句，确认变量是否被正确读取：

print("DJANGO_CSRF value:", os.environ.get("DJANGO_CSRF"))

运行容器后查看日志，若输出为None，说明环境变量未加载，需检查docker-compose.yml和.env.dev的路径/拼写。

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