使用MongoEngine连接Django与MongoDB时数据库配置报错求助

问题现象 #

执行python manage.py createsuperuser、migrate或登录操作时，触发报错：

"DATABASES is improperly configured. Please supply the ENGINE value. Check settings documentation for more details."

此前用SQLite、Djongo连接均正常，切换到MongoEngine模型后出现该问题。

环境信息 #

操作步骤 #

django-admin startproject projectname
python manage.py startapp appname

Models.py 代码 #

from django.db import models
from django.db.models.fields.related import ForeignKey
from django.db.models.query import EmptyQuerySet
from django.contrib.auth.models import User,AbstractUser, UserManager

import datetime

import mongoengine

# Create your models here.

class Project(mongoengine.Document):
    projectName = mongoengine.StringField()

Settings.py 关键配置 #

import mongoengine
mongoengine.connect(db="testdatabase", host="mongodb+srv://<Username>:<Password>@cluster0.qspqt0a.mongodb.net/?retryWrites=true&w=majority")

# ...其他配置省略...

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.dummy'
    }
}

Pip 依赖列表 #

asgiref             3.5.2
certifi             2022.6.15
charset-normalizer  2.1.1
Django              4.1
djangorestframework 3.13.1
dnspython           2.2.1
idna                3.3
mongoengine         0.24.2
pip                 22.2.2
pymongo             4.2.0
pytz                2022.2.1
requests            2.28.1
setuptools          63.4.3
sqlparse            0.4.2
urllib3             1.26.12

问题原因 #

django.db.backends.dummy是一个空引擎，仅用于跳过Django的数据库检查，但Django的核心组件（如auth、admin）依然依赖完整的数据库后端配置来执行操作。MongoEngine本身是独立的模型层，没有直接替换Django的数据库后端，导致这些核心组件找不到可用的数据库引擎报错。

解决步骤 #

1. 替换数据库引擎为MongoEngine兼容后端 #

修改settings.py中的DATABASES配置，使用MongoEngine提供的专属引擎，同时移除单独的mongoengine.connect()调用（配置会自动处理连接）：

DATABASES = {
    'default': {
        'ENGINE': 'mongoengine.django.mongoengine',
        'NAME': 'testdatabase',
        'HOST': 'mongodb+srv://<Username>:<Password>@cluster0.qspqt0a.mongodb.net/?retryWrites=true&w=majority'
    }
}

2. 配置Django Auth适配MongoEngine #

如果需要使用Django的用户认证系统（创建超级用户、登录），必须替换默认User模型为MongoEngine版本：

• 在settings.py中添加：

AUTH_USER_MODEL = 'mongoengine.django.auth.User'

• 若需自定义用户字段，可在app的models.py中扩展：

from mongoengine.django.auth import User

class CustomUser(User):
    bio = mongoengine.StringField(max_length=500)

然后在settings.py中更新为：

AUTH_USER_MODEL = 'your_app.CustomUser'

3. 清理无关导入 #

models.py中导入的Django ORM模块（如models、ForeignKey）完全没用，直接删除：

import datetime
import mongoengine

class Project(mongoengine.Document):
    projectName = mongoengine.StringField()

4. 重新执行数据库初始化操作 #

# 删除旧迁移文件（如果存在）
rm -rf your_app/migrations/ __pycache__/
# 创建迁移（按需执行）
python manage.py makemigrations
# 执行迁移
python manage.py migrate
# 创建超级用户
python manage.py createsuperuser

验证 #

启动Django服务，尝试登录admin后台或执行数据库操作，确认错误是否消失。

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