Django部署服务器时出现ImproperlyConfigured：SECRET_KEY不能为空错误

针对Docker部署场景的核心排查步骤 #

• 验证.env.prod文件有效性
  • 确认文件内存在SECRET_KEY=你的密钥内容，无前置空格、注释符号（如#）或多余引号（除非代码逻辑兼容引号）
  • 检查docker-compose.prod.yml中web服务是否配置了env_file: .env.prod，路径需与docker-compose文件的相对位置匹配
• 检查settings.py的环境变量读取逻辑
  • 确认SECRET_KEY是通过os.environ.get('SECRET_KEY')或对应env工具（如python-dotenv的env('SECRET_KEY')）获取，变量名无拼写错误
  • 若本地使用python-dotenv加载.env，部署时需注释掉load_dotenv()相关代码——Docker通过compose注入环境变量时，本地加载逻辑可能导致冲突
• 确认DJANGO_SETTINGS_MODULE配置
  • 检查docker-compose.prod.yml的environment字段是否设置了正确的模块路径，如DJANGO_SETTINGS_MODULE=你的项目名.settings.prod
  • 进入容器执行echo $DJANGO_SETTINGS_MODULE和echo $SECRET_KEY，直接验证环境变量是否成功注入
• 排除其他settings加载异常
  • 检查wsgi.py/asgi.py文件，确认os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')中的项目名和模块路径正确
  • 排查自定义启动脚本、管理命令是否存在硬编码SECRET_KEY或错误加载settings模块的情况

快速验证手段 #

临时在settings.py中硬编码一个测试用SECRET_KEY：

SECRET_KEY = '临时测试密钥'

若部署后不再报错，说明问题根源是环境变量未正确传递；若仍报错，需排查是否存在隐性循环依赖（如第三方APP在初始化时提前加载settings）或settings模块的其他加载逻辑问题

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