Django 5.0.1本地DATABASES配置未生效的原因排查

排查步骤及解决方案 #

• 确认migrate使用的settings文件
  执行migrate时明确指定settings模块，避免使用错误的配置：

  python manage.py migrate --settings=club_site.settings
  

  如果指定后路径正确，说明默认使用的settings不是你预期的主配置文件，需要检查环境变量DJANGO_SETTINGS_MODULE的设置。

• 验证settings在manage.py中的实际值
  修改项目根目录下的manage.py，在加载settings后打印数据库路径，确认运行migrate时的真实配置：

  import os
  import sys
  
  def main():
      os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'club_site.settings')
      try:
          from django.conf import settings
          # 打印真实加载的数据库路径
          print(f"实际使用的数据库路径: {settings.DATABASES['default']['NAME']}")
          from django.core.management import execute_from_command_line
      except ImportError as exc:
          raise ImportError(
              "Couldn't import Django. Are you sure it's installed and "
              "available on your PYTHONPATH environment variable? Did you "
              "forget to activate a virtual environment?"
          ) from exc
      execute_from_command_line(sys.argv)
  
  if __name__ == '__main__':
      main()
  

  运行python manage.py migrate，如果这里打印的路径是BASE_DIR下的文件，说明你的主配置文件在导入local.py后，有其他代码修改了DATABASES配置，需要检查导入后的所有代码逻辑。

• 检查主配置文件的后续代码
  仔细查看主配置中sys.path.pop(0)之后的所有代码，确认是否存在以下情况：

  • 读取环境变量覆盖DATABASES的逻辑
  • 第三方库（如django-environ、python-decouple）自动加载配置覆盖了原有设置
  • 其他模块导入时修改了全局的DATABASES变量

• 排查配置文件导入冲突
  确认BASE_DIR.parent目录下的local.py是否存在，且其中的DATABASES配置确实是你需要的绝对路径。如果local.py不存在，才会导入club_site.settings.local_py_example，可以临时注释掉try-except块，强制导入local_py_example，测试是否路径正常。

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