MongoDB事务明确禁止createIndex操作，因其属不可回滚的DDL元数据变更；即使4.4+曾短暂允许普通索引，当前所有版本（含2026最新版）均已统一禁止，必须在事务外独立执行并确认就绪后方可进行业务写入。
MongoDB事务中执行createIndex会直接报错，不是驱动问题，而是服务端硬性禁止——哪怕你用db.collection.createIndex()或db.runCommand({createIndexes: ...})，只要在session.startTransaction()之后调用，就会返回CommandNotSupported: createIndex is not supported in multi-document transactions。
为什么createIndex被事务明确禁止
根本原因在于：索引创建属于元数据变更（DDL），而MongoDB事务的原子性依赖于oplog中可回滚的操作。但索引一旦写入WiredTiger文件、更新system.indexes、刷新内存结构，就无法安全“撤回”——没有dropIndex的逆操作能保证事务回滚后状态完全一致。
这和createCollection被禁逻辑一致，但有个关键区别：createIndex在MongoDB 4.4+中曾短暂允许在事务内对**已存在集合**创建普通索引（非唯一、非TTL等），但该行为已被回退；当前所有版本（包括2026年最新稳定版）均统一禁止。
- 事务只允许CRUD类操作（
insertOne、updateMany、find等） -
createIndex无论是否带{background: true}或{unique: false}，一律不被接受 - 即使集合刚在事务外创建完毕，事务块内仍不可立即建索引——元数据同步可能存在毫秒级延迟，驱动可能因缓存未刷新而误判
DDL与DML必须物理分离：建索引不能和业务写入混在同一个事务里
典型错误场景是迁移脚本或初始化逻辑中写成：
session.withTransaction(() => {
db.users.insertOne({...});
db.users.createIndex({ email: 1 }); // ❌ 这里立刻失败
});
正确做法是把DDL提前到事务之外，并确保它完成后再启动事务：
- 先独立执行
db.users.createIndex({ email: 1 }, { background: true })（生产环境必须加background: true，否则阻塞） - 用
db.users.getIndexes()轮询确认索引状态为"ready"，而非"building" - 再调用
session.withTransaction(...)执行业务数据写入 - 若需幂等保障（如多租户动态建索引），捕获
NamespaceExists或IndexOptionsConflict错误，而不是依赖事务回滚
替代方案：如何在“逻辑原子性”要求下安全建索引
有些业务要求“建索引 + 写数据”看起来像一个原子动作（例如上线新字段并立即查询）。MongoDB不提供跨DDL/DML的原子性，只能靠应用层协调：
- 用两阶段标记：先写一条
{_id: "index_ready_email", status: "pending"}到专用配置集合，再建索引；索引就绪后更新为"ready"；业务代码读到"ready"才开始走新查询路径 - 避免在高并发入口处动态建索引——索引创建本身有资源开销，且
background: true仍会争抢I/O和CPU - 不要试图用聚合管道或
$function封装createIndex绕过限制——该命令在事务内调用仍被拦截，且$function在4.4+默认禁用，5.0+需显式启用
最易被忽略的一点：background: true只影响建索引时是否阻塞其他操作，它**不改变createIndex的DDL属性**，所以哪怕加了这个参数，依然不能放进事务——这是设计边界，不是配置问题。
