Django的settings.py在单元测试中无法读取环境变量

咱们一步步排查这个问题——既然开发、CI和生产环境都能正常读取变量，说明你的核心配置逻辑没问题，问题大概率出在测试环境的环境变量加载规则或者Django测试的特殊行为上，常见的几个原因如下：

• 测试环境没加载环境变量源
  很多开发者会用.env文件管理本地环境变量，比如通过python-dotenv在settings.py开头加载：

  from dotenv import load_dotenv
  load_dotenv()
  

  但如果测试命令（比如python manage.py test）没触发这个加载逻辑，或者.env文件的路径不对（比如测试时工作目录改变），就会导致变量读不到。另外，如果你在IDE里运行测试，IDE的环境变量可能没配置这些POSTGRES_*变量——毕竟终端和IDE的环境变量是隔离的。

• Django测试被强制覆盖了数据库配置
  检查你的settings.py或者测试专用配置文件（比如settings/test.py）里有没有针对测试环境的条件判断，比如：

  if 'test' in sys.argv:
      DATABASES['default'] = {
          'ENGINE': 'django.db.backends.sqlite3',
          'NAME': ':memory:'
      }
  

  这种配置会直接覆盖你原本的Postgres设置，导致测试时根本不会去读取那些环境变量——很多教程会推荐用SQLite做测试数据库来提速，可能你之前加了这段代码但忘了。

• 环境变量加载时机不对
  如果你的os.getenv调用早于环境变量加载逻辑，也会出问题。比如你把load_dotenv()放在了DATABASES配置之后，那读取变量时环境变量还没被加载，自然拿不到值。一定要确保环境变量加载代码（不管是dotenv还是其他方式）放在DATABASES配置之前。

• 测试命令的上下文差异
  比如你在终端运行runserver时，先通过export POSTGRES_NAME=xxx或source脚本加载了变量，但运行test时是在新的终端会话里，没加载这些变量；或者用了虚拟环境，测试时激活的虚拟环境和开发时的不一样，环境变量没同步。

快速排查步骤 #

1. 加调试代码：在settings.py的DATABASES配置下方加一行print(os.environ.get("POSTGRES_NAME"))，运行python manage.py test，看看终端有没有输出预期值——如果没有，说明环境变量确实没加载。
2. 检查IDE配置：如果用PyCharm、VS Code跑测试，去测试运行器的环境变量设置里确认有没有添加POSTGRES_*变量。
3. 明确指定配置文件：运行python manage.py test --settings=myproject.settings，避免加载错误的测试配置。

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