Django项目启动报错ImproperlyConfigured：SECRET_KEY环境变量未加载

核心问题定位 #

从代码看，最可能的原因是**.env文件的变量没有被正确加载到你创建的ENV实例中**，以下是分步解决方法：

1. 修复settings.py中的read_env调用 #

原代码中使用类方法environ.Env.read_env()加载.env文件，但该方法不会将变量注入到你已创建的ENV实例里，需改为用实例调用：

# 替换原代码中的read_env部分
ENV_FILE = Path(os.path.join(BASE_DIR, '.env'))
if ENV_FILE.exists():
    ENV.read_env(os.path.join(BASE_DIR, '.env'))  # 改为用ENV实例调用read_env

2. 验证.env文件路径是否正确 #

打印BASE_DIR确认路径：
在settings.py中添加一行：

print("当前BASE_DIR路径:", BASE_DIR)

运行python manage.py runserver，输出的BASE_DIR应为C:\new-folder（manage.py所在目录），你的.env文件必须放在这个目录下。如果你的.env放在usn_uchet目录（settings.py所在目录），需修改路径：

ENV_FILE = Path(os.path.join(os.path.dirname(os.path.abspath(__file__)), '.env'))

3. 检查.env文件格式 #

• 确保变量行无多余空格：SECRET_KEY=My_key（不要写成SECRET_KEY = My_key）
• 保存为UTF-8无BOM编码（Windows记事本保存时选择“UTF-8”而非“UTF-8带BOM”）
• 无注释符号#覆盖变量行，无空行干扰

4. 临时环境变量测试（排查用） #

如果上述方法无效，直接在启动前设置环境变量：

• Windows CMD：

set SECRET_KEY=My_key && python manage.py runserver

• Windows PowerShell：

$env:SECRET_KEY="My_key"; python manage.py runserver

若此方式能启动，说明.env文件加载逻辑仍有问题，回到步骤1-3排查。

5. 更新django-environ库 #

不同版本API可能存在差异，更新到最新版本：

pip install django-environ --upgrade

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