pymongo在django中不支持跨文档事务的自动集成，因其事务需显式会话管理（start_session、start_transaction）、仅限副本集/分片集群、所有操作须传入session参数，且无法与django的transaction.atomic()或middleware兼容。
PyMongo 在 Django 中不支持跨文档事务？
Django 的 ORM 天然绑定关系型数据库，而 PyMongo 是 MongoDB 的原生驱动，它本身支持事务（从 MongoDB 4.0+、副本集或分片集群启用时），但 PyMongo 的事务必须在同一个 Client 实例下的单个会话（Client.start_session()）中显式开启和提交。Django 并不管理 PyMongo 的会话生命周期，也不会自动注入事务上下文——这意味着你无法像用 transaction.atomic() 那样简单包裹视图函数就生效。
手动管理 PyMongo 事务的最小可行步骤
要真正用上 MongoDB 事务，你得绕过 Django ORM，直接用 PyMongo，并严格控制会话与事务边界。关键不是“集成”，而是“共存”：让 PyMongo 按 MongoDB 规则跑事务，同时不干扰 Django 的常规流程。
- 确保 MongoDB 部署为副本集（单机启动需加
--replSet rs0并运行rs.initiate()），事务不支持单节点 standalone 模式 - 连接时复用同一个
pymongo.MongoClient实例（全局或 Django 的AppConfig.ready()中初始化），避免每次新建 client 导致会话丢失 - 事务代码必须显式调用
session.start_transaction()，并在try/except/finally中确保session.commit_transaction()或session.abort_transaction() - 所有涉及事务的集合操作（
collection.insert_one()、collection.update_one()等）都必须传入session=session参数，漏掉就脱离事务上下文
示例片段：
from pymongo import MongoClient
client = MongoClient('mongodb://localhost:27017/')
db = client['myapp']
def transfer_money(from_user_id, to_user_id, amount):
with client.start_session() as session:
try:
session.start_transaction()
db.users.update_one(
{'_id': from_user_id},
{'$inc': {'balance': -amount}},
session=session
)
db.users.update_one(
{'_id': to_user_id},
{'$inc': {'balance': amount}},
session=session
)
session.commit_transaction()
except Exception:
session.abort_transaction()
raise
为什么不能把 PyMongo 事务塞进 Django 的 middleware 或 signals？
因为事务会话（Session）是短生命周期对象，不可跨请求复用，也不能被序列化或暂存。Django middleware 的每个请求是独立线程/协程，session 对象一旦离开 with 块就会失效；signals 更是异步触发，完全无法保证在同一个会话内执行。常见错误包括：
- 在
settings.py中直接创建session = client.start_session()—— 会话会快速超时或被回收，后续操作报InvalidSession - 把
session存进request对象再传递给 views —— 多线程下不安全，且未绑定到具体事务周期 - 误以为给
MongoClient加maxPoolSize=1就能串行化事务 —— 这只影响连接池，不影响会话隔离性
事务失败时最容易被忽略的兼容性细节
MongoDB 事务不是黑盒魔法，它有明确约束，硬写进去却不管会默默失败：
- 事务内所有读写必须发生在同一个数据库（
db），跨库操作（如db1.users+db2.logs）直接报TransactionNumbersMismatch - 事务默认最大运行时间 60 秒（
maxCommitTimeMS），长耗时操作（如批量导入）需显式延长，否则自动 abort - 使用
$lookup聚合时，被关联集合若不在同一数据库，或未建好索引，可能触发不可恢复的 snapshot 错误 - PyMongo 3.12+ 才完整支持
read_concern="snapshot"，旧版本在事务中做多文档读可能看到不一致快照
事务逻辑越复杂，越要提前在 MongoDB shell 里用 session.startTransaction() 手动验证路径，而不是依赖 Django 层“封装”。
