如何解决MongoDB事务NamespaceNotFound：确保存量集合已存在

MongoDB事务中的NamespaceNotFound错误：一个被低估的“原罪”与解决方案

在MongoDB事务处理的世界里，错误码26（NamespaceNotFound）是一个典型且容易被忽略的“翻车点”。它直接告诉你：事务内引用的集合或数据库根本不存在。MongoDB不会因为开启了事务就自动帮你创建集合——它只保证原子性，不负责存在性。这一设计逻辑与数据库基础原则高度一致。

因此，核心原则非常明确：在调用session.startTransaction()之前，目标集合必须已经创建。如果事务内的insertOne()操作遇到不存在的集合，会立即抛出错误，而不会自动尝试创建。

确保事务开始前集合已存在：关键步骤

确保集合已创建并非空谈。最佳实践是在应用启动、数据库迁移脚本或部署流程中显式创建所需集合。例如，执行db.mydb.createCollection("orders")。切记不要依赖“首次插入自动创建集合”的机制——这只适用于非事务写入，且需要先执行use mydb切换数据库。

在分片集群环境中，情况更为复杂。仅集合存在还不够，必须保证该集合已启用分片。需要依次执行sh.enableSharding("mydb")和sh.shardCollection("mydb.orders", {_id: "hashed"})。否则，即使集合存在，事务也可能因路由问题抛出类似的NamespaceNotFound错误。

检查集合存在性：避免缓存导致的误判

db.getCollectionNames()在某些版本（尤其是带缓存的mongos或旧版驱动）下可能返回过期的集合列表。即使刚创建了集合，元数据可能尚未刷新，导致仍然显示“不存在”。更可靠的方法是直接查询集合元数据：使用db.runCommand({listCollections: 1, filter: {name: "orders"}})，返回非空数组才表示集合真实存在。或者在事务之外执行db.orders.findOne({$query: {}, $explain: true})，如果不报错即表示集合存在。注意，$explain不能在事务内部使用。

在PyMongo中，可以这样检查：if "orders" in db.list_collection_names(): ...，但必须确保PyMongo驱动版本不低于4.0，并且连接的是主节点而非随机mongos。

createCollection参数选择不当引发的隐患

显式创建集合看似简单，但参数配置错误同样会导致问题。例如，未指定capped: true却在事务中对capped集合执行写入，虽然报错类型不同，但会让人困惑。在副本集上创建集合时，如果没有设置writeConcern: {w: "majority"}，而事务默认要求majority写入，可能导致集合元数据未能同步，事务内的首次写入操作因此失败。

使用timeSeries集合时，必须预先定义timeField和metaField，事务内无法动态补充。建议采用以下初始化方式：db.createCollection("events", {timeseries: {timeField: "ts", metaField: "meta"}, writeConcern: {w: "majority"}})，这样可以避免后续许多问题。

PyMongo防御性编码：捕获NamespaceNotFound并重试

预防胜于补救，但生产环境仍需防御性编码。PyMongo中不允许在事务内部创建集合，因此正确的处理逻辑是：在except块中退出当前事务，创建集合，然后重新执行业务逻辑。

try:
    with client.start_session() as session:
        with session.start_transaction():
            result = session.client.mydb.orders.insert_one({...}, session=session)
except pymongo.errors.OperationFailure as e:
    if e.code == 26:  # NamespaceNotFound
        # 必须跳出事务！不能在 session 内建集合
        db = client.mydb
        if "orders" not in db.list_collection_names():
            db.createCollection("orders")
        # 此处应重新走业务逻辑，而非继续当前 session
    else:
        raise

一个容易被忽视的细节是：当事务session抛出NamespaceNotFound错误后，该session无法再用于新事务，必须创建新的session。如果重试时重复使用原session，将引发InvalidSession错误。这就像一个人摔倒后，不能直接爬起来继续跑，需要换一双鞋才行。