Docker容器中Django无法读取环境变量的问题求助

问题复现 #

Docker Compose环境下，PostgreSQL服务能正常读取环境变量，但Django服务读取时所有变量都返回None，尝试过env_file、environment配置及django-dotenv均无效。

排查与解决步骤 #

1. 验证Docker Compose是否正确加载环境变量

先确认Docker Compose本身是否成功读取到.env文件的变量：

• 在终端执行docker-compose config，查看输出中web服务的environment字段，确认变量是否已被正确填充（比如SECRET_KEY是否显示为你设置的值）。
• 如果docker-compose config里变量为空，检查.env文件是否和docker-compose.yml在同一目录，或者手动指定env_file路径：

  web:
    env_file:
      - ./path/to/your/.env  # 替换为实际路径
  

2. 检查容器内是否存在环境变量

启动服务后，进入Django容器查看环境变量：

docker exec -it <你的web容器名> printenv

如果输出中没有目标变量，说明Docker Compose未将变量传递到容器，检查：

• docker-compose.yml中environment的语法是否正确（每个变量单独一行，用- 变量名=${变量名}格式）。
• 终端运行docker-compose up时，当前环境是否能读取到.env变量（可以先在终端执行echo ${SECRET_KEY}测试）。

3. 验证Gunicorn启动时是否继承环境变量

修改web服务的启动命令，先打印环境变量再启动Gunicorn：

web:
  command: bash -c "printenv && gunicorn myapp.wsgi:application --access-logfile /logs/gunicorn/access.log --error-logfile /logs/gunicorn/error.log --bind 0.0.0.0:8000"

查看容器启动日志，如果日志里能看到目标变量，说明问题出在Django代码；如果看不到，说明变量未传递到Gunicorn进程。

4. 检查Django代码的变量读取逻辑

• 确保settings.py中读取环境变量的代码在文件最顶部，且未被后续逻辑覆盖：

  import os
  
  # 放在文件最开头，确保没有被其他代码修改
  print(f"SECRET_KEY: {os.environ.get('SECRET_KEY')}")
  SECRET_KEY = os.environ.get("SECRET_KEY")
  DEBUG = os.environ.get("DEBUG", "0") == "1"
  

• 如果使用django-dotenv，确保在settings.py最开头加载，且路径正确：

  import os
  import dotenv
  
  # 加载项目根目录的.env文件
  dotenv.load_dotenv(os.path.join(os.path.dirname(os.path.abspath(__file__)), '../.env'))
  

5. 排查Dockerfile是否干扰环境变量

查看./src/Dockerfile，确认：

• 没有用ENV指令设置相同的变量（比如ENV SECRET_KEY=xxx会覆盖Compose的配置）。
• 启动命令（CMD/ENTRYPOINT）没有重置环境变量。
• WORKDIR设置是否正确，导致相对路径的.env文件无法被找到。

6. 硬编码变量测试（快速定位问题）

暂时在docker-compose.yml中硬编码变量，测试Django是否能读取：

web:
  environment:
    - SECRET_KEY=3df-81ioo^5cx(p9cl$)s%m3mlu3t7*yh#1lr5h0po4_sab3*5
    - DATABASE_NAME=mydb
    - DEBUG=0

如果此时Django能正常读取，说明问题出在.env文件的加载或变量替换环节；如果还是不行，重点排查Django代码或容器启动流程。

内容的提问来源于stack exchange，提问作者B A.J Amar