PyMongo 4.0+ 废弃 Database.__bool__() 导致 NotImplementedError，需降级至 pymongo==3.12.1；SITE_ID 必须设为字符串 ObjectId；Djongo 字段映射存在诸多陷阱，建议必要时直连 pymongo。
PyMongo 4.0+ 导致 NotImplementedError: Database objects do not implement truth value testing
这是最常遇到的类型兼容问题，根本原因不是 Django 配置错，而是 pymongo 4.0+ 版本废弃了 Database.__bool__()，而 djongo（如 1.3.6）仍调用 if self.connection: 这类判断。
- 错误会在
python manage.py makemigrations、runserver或任何触发数据库连接的操作中抛出 - 降级
pymongo是最快解法：pip install pymongo==3.12.1（djongo==1.3.6兼容的最高版本） - 不要装
pymongo>=4.0，哪怕只跑pip install djongo也会拉取最新pymongo，必须显式指定版本 - 验证方式：运行
python -c "import pymongo; print(pymongo.version)"，确认输出是3.12.1而非4.x
AutoField 主键报错：values must be strings representing an ObjectId
这个错误和 SITE_ID 设置强相关——Django 的 sites 框架要求 SITE_ID 是字符串格式的 ObjectId，但默认值是整数或未设，MongoDB 无法自动转换。
- 先查出实际
ObjectId：mongo your_db_name --eval "db.django_site.findOne()._id.str()" - 在
settings.py中设为字符串：SITE_ID = '60a1b2c3d4e5f67890123456'（注意单引号包裹，不能是ObjectId(...)对象） - 如果没启用
django.contrib.sites，直接注释掉或删掉'django.contrib.sites'和SITE_ID行更干净 - 该错误与 Djongo 无关，
django-mongodb-engine或mongoengine项目也可能触发，本质是 sites 框架与 MongoDB 主键语义冲突
Djongo 的字段类型映射陷阱
Djongo 声称“保持 ORM 不变”，但它对 MongoDB 特有类型的支持极弱，很多看似合法的字段定义会静默失效或报错。
Django Wrap
下载
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
-
ArrayField无法正确处理嵌套查询：filter(tags__0="python")可能返回空，但无提示；改用原生filter({"tags.0": "python"})才可靠 -
JSONField在 Djongo 下实际存为字符串，不是 BSON Object，导致__contains失效 -
DateTimeField(auto_now=True)写入时可能被忽略，因为 Djongo 不保证时间戳字段的自动更新逻辑与 MongoDB 的$currentDate对齐 - 避免依赖
ENFORCE_SCHEMA=True，它会让 Djongo 强制校验字段类型，反而放大兼容问题；设为False更贴近 MongoDB 灵活 schema 特性
绕过 Djongo 直连更可控
如果你发现字段类型、查询语义或聚合操作总在边缘反复出错，说明 Djongo 的 SQL→BSON 翻译层已成瓶颈。此时放弃 ORM 抽象，用 pymongo 直连反而是更稳的选择。
- 在
settings.py加配置：MONGODB_URI = "mongodb://localhost:27017/" - 视图里初始化：
from pymongo import MongoClient; client = MongoClient(settings.MONGODB_URI); db = client["your_db"] - 查数据用
db["users"].find({"status": "active", "tags.2": "vip"})，而不是试图写filter(tags__2="vip") - 写入前用
pydantic.BaseModel校验结构，别指望CharField(max_length=100)能约束 MongoDB 文档长度
复杂点在于你要自己管理连接生命周期（比如用 thread_local 或 Django 的 request hook），但换来的是所有 MongoDB 5.0+ 新特性可用、查询行为可预期、性能不打折扣——这些恰恰是 Djongo 最难保障的。
