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 最难保障的。