Django执行makemigrations命令时读取PostgreSQL环境变量出现KeyError问题

看起来你遇到的是环境变量加载时机或路径导致的典型问题，我来帮你梳理几个最可能的原因和对应的解决办法：

1. load_dotenv路径指向错误（最常见） #

你当前的代码是load_dotenv(os.environ.get('ENV_CONFIG', ''))，如果ENV_CONFIG这个环境变量没设置，相当于给load_dotenv传了空字符串，它根本不会加载任何.env文件。

你说直接运行应用时能看到变量，大概率是因为IDE或终端会话已经自动加载了.env，但执行makemigrations时的工作目录和项目根目录不一致，导致找不到.env文件。

解决办法：
明确指定.env的绝对路径，摆脱对工作目录的依赖：

from pathlib import Path

# 假设.env文件和manage.py在同一级目录，根据你的实际层级调整parent的次数
BASE_DIR = Path(__file__).resolve().parent.parent.parent
load_dotenv(BASE_DIR / '.env')

2. 直接索引环境变量容错性差 #

你的base.py用了os.environ.get('SECRET_KEY', '')这种安全写法（变量不存在时返回默认值），但dev.py里直接用os.environ['DB_NAME']，一旦变量没加载就会触发KeyError。

解决办法：
统一换成get方法，还能顺便加默认值和调试检查：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.environ.get('DB_NAME', ''),
        'USER': os.environ.get('DB_USER', ''),
        'PASSWORD': os.environ.get('DB_PASS', ''),
        'HOST': os.environ.get('DB_HOST', ''),
        'PORT': os.environ.get('DB_PORT', '5432'),  # PostgreSQL默认端口当兜底
    }
}

# 加一行断言快速排查变量是否加载成功
assert os.environ.get('DB_NAME'), "⚠️ DB_NAME环境变量未加载，请检查.env文件路径！"

3. Django配置加载顺序问题 #

Django运行管理命令时，可能会多次加载配置文件，如果你先导入了base.py再加载环境变量，可能导致基础配置里的逻辑提前执行，覆盖或干扰了后续的变量加载。

解决办法：
把加载环境变量的代码移到最顶部，在导入base.py之前执行：

import os
from dotenv import load_dotenv
from pathlib import Path

# 先加载环境变量，再导入基础配置
BASE_DIR = Path(__file__).resolve().parent.parent.parent
load_dotenv(BASE_DIR / '.env')

from app.settings.base import *
# 后续的dev配置代码...

4. .env文件格式问题 #

检查你的.env文件是否有格式错误：

• 避免等号前后加空格，比如DB_NAME = 'value'会导致解析失败，应该写成DB_NAME='value'或DB_NAME=value（值无空格时可以不用引号）
• 确保变量名拼写完全正确，比如别把DB_NAME写成DB_NAM

5. 系统环境变量覆盖问题 #

load_dotenv默认不会覆盖已存在的系统环境变量（override=False），如果你的系统环境变量里恰好有一个空值的DB_NAME，.env里的正确值就不会生效。

解决办法：
设置override=True强制覆盖：

load_dotenv(BASE_DIR / '.env', override=True)

先试试第一种指定路径的方法，这是绝大多数人遇到这类问题的根源——执行命令时的工作目录不对，导致.env没被正确加载。

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