如何解决Django数据库配置冲突：settings.DATABASES缺少NAME值报错

这个错误是Django启动/处理请求时，读取数据库配置发现DATABASES配置块中缺少必填的NAME参数导致的配置异常。

django.core.exceptions.ImproperlyConfigured: settings.DATABASES is improperly configured. Please supply the NAME value.
[30/Jun/2021 17:31:00] "GET / HTTP/1.1" 500 194335

• 定位项目的settings.py配置文件，找到DATABASES配置段，检查是否显式配置了NAME字段。SQLite场景下NAME对应数据库文件的本地存储路径，MySQL/PostgreSQL等客户端数据库场景下NAME对应目标数据库的名称。
• 检查是否存在多环境配置覆盖逻辑：如果项目拆分了开发、生产等不同环境的配置文件，或使用了django-environ等环境变量管理工具，需确认对应运行环境的配置项/环境变量中是否正确传入了数据库名称，避免NAME参数被覆盖后丢失。
• 确认启动命令是否指定了自定义配置：如果启动项目时使用了--settings参数指定了非默认配置文件，需检查对应配置文件的DATABASES项是否完整。

• SQLite 配置示例：
  补充NAME参数指向数据库文件路径即可：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.sqlite3',
          'NAME': BASE_DIR / 'db.sqlite3',
      }
  }
  

• MySQL 配置示例：
  确保NAME字段填写已创建的数据库名称：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',
          'NAME': 'your_database_name',
          'USER': 'your_database_user',
          'PASSWORD': 'your_database_password',
          'HOST': '127.0.0.1',
          'PORT': '3306',
      }
  }
  

• 配置修改完成后，先执行python manage.py check命令校验配置合法性，无报错后再启动项目即可正常运行。

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