Django分环境配置下执行migrate命令提示环境变量KeyError问题

local.py开头导入了base.py的所有内容，Python执行导入逻辑时会先完整运行base.py的代码。base.py中SECRET_KEY = os.environ['secret_key']这类写法会强制从环境变量读取对应值，不存在就直接抛出KeyError。你本地开发环境没有配置secret_key、allowed_host、database_name等要求的环境变量，所以哪怕你在local.py里重写了数据库配置，还没运行到local.py的重写逻辑就已经触发报错。

可以根据自己的使用场景选择以下任意一种方法：

• 方法1：修改base.py的环境变量读取逻辑，添加本地默认值
  把base.py中所有直接用os.environ['xxx']读取的配置，改成用os.environ.get()方法，传入本地开发用的默认值即可，示例：

# 原代码
# SECRET_KEY = os.environ['secret_key']
# 修改后
SECRET_KEY = os.environ.get('secret_key', 'django-insecure-随便输入一串随机字符作为本地开发密钥即可')
ALLOWED_HOSTS = os.environ.get('allowed_host', '*').split(',')
# 其余需要读取环境变量的配置（数据库账号密码、google_api_key等）都按照同样逻辑修改，给本地场景设置可用的默认值

该方法不需要额外修改本地其他配置，生产环境配置的环境变量优先级高于默认值，不会影响生产环境运行。

• 方法2：使用python-dotenv管理本地环境变量
  适合需要和生产环境配置结构保持一致的场景：

1. 执行pip install python-dotenv安装依赖包
2. 在项目根目录新建.env文件，写入所有需要的环境变量：

secret_key=自定义的本地开发密钥
allowed_host=127.0.0.1,localhost
database_name=生产用的数据库名（本地如果不需要可以随便填，反正local.py会重写数据库配置）
database_user=生产用数据库账号
database_pass=生产用数据库密码
google_api_key=你自己的谷歌地图接口密钥

3. 在base.py的import os代码之后添加加载逻辑：

from dotenv import load_dotenv
load_dotenv()

.env文件不需要上传到代码仓库，不会影响生产环境的原有配置。

• 方法3：临时在终端设置环境变量
  仅适合临时运行命令的场景，每次新开终端都需要重新设置：
  Windows CMD终端执行：

set secret_key=自定义的密钥
set allowed_host=127.0.0.1
python manage.py migrate --settings=arkb_eh.settings.local

Windows PowerShell终端执行：

$env:secret_key = "自定义的密钥"
$env:allowed_host = "127.0.0.1"
python manage.py migrate --settings=arkb_eh.settings.local

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