NamespaceNotFound（错误码26）表示事务中引用的集合或数据库不存在，MongoDB不会在事务内自动创建；必须在startTransaction前显式创建集合，且需确保分片配置、writeConcern及timeseries参数正确，PyMongo中捕获后须新建session重试。
NamespaceNotFound（错误码 26）在 MongoDB 事务中出现，基本意味着事务里引用的集合或数据库根本没被创建——MongoDB 不会在事务内自动建库建集，也不会因 use 或写入操作隐式创建。你不能指望事务“兜底”，它只管原子性，不管存在性。
事务开始前必须确保集合已存在
MongoDB 事务要求所有读写涉及的命名空间（db.collection）在 session.startTransaction() 之前就存在。事务内执行 db.collection.insertOne() 时，如果 collection 不存在，直接报 NamespaceNotFound，不会尝试创建。
- 正确做法：在应用启动、迁移脚本或部署流程中，显式创建所需集合，例如
db.mydb.createCollection("orders") - 不要依赖“第一次插入自动建集”——那仅适用于非事务性写入，且需先
use mydb切换数据库 - 在分片集群中，还需确保该集合已启用分片（
sh.enableSharding("mydb")+sh.shardCollection("mydb.orders", {_id: "hashed"})），否则即使集合存在，事务仍可能因路由失败触发类似错误
检查集合是否存在不能只靠 db.getCollectionNames()
db.getCollectionNames() 在某些版本（尤其是带缓存的 mongos 或旧驱动）下可能返回过期列表，尤其刚创建完集合还没刷新元数据时。更可靠的方式是直接尝试访问集合元数据：
- 用
db.runCommand({listCollections: 1, filter: {name: "orders"}})—— 返回非空数组才表示真实存在 - 或在事务外执行
db.orders.findOne({$query: {}, $explain: true})，不报错即存在（注意别加$explain在事务内） - Python 中用 PyMongo：
if "orders" in db.list_collection_names(): ...，但需确认驱动版本 ≥ 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，会得到 InvalidSession 错误。
