使用migrate-mongo执行迁移时遇MongoDB事务创建索引错误

云上老周

2026-8-10

解决MongoDB多文档事务中创建索引报错的问题

问题原因

MongoDB的多文档事务不支持在已有集合上执行创建索引的操作，这是官方明确的限制——即便集合已存在，在事务内调用createIndex仍会触发该错误。

可行解决方案

方案1：将索引创建操作移出事务

索引创建本身是幂等操作（重复创建相同索引不会报错），无需依赖事务的原子性，直接把逻辑放在事务外部即可：

exports.up = async (db, client) => {
  const fooCollection = db.collection('foo')
  const barCollection = db.collection('bar')

  // 直接在事务外创建索引
  await fooCollection.createIndex({ foo: 1 });
  await barCollection.createIndex({ bar: 1 });
}

exports.down = async (db, client) => {
  const fooCollection = db.collection('foo')
  const barCollection = db.collection('bar')
  
  await fooCollection.dropIndex({ foo: 1 });
  await barCollection.dropIndex({ bar: 1 });
}

方案2：原子性创建集合与索引（仅适用于新集合）

如果场景是需要同时创建新集合和对应索引并保证原子性，可以在事务内先创建集合再创建索引，但该方案仅适用于集合原本不存在的情况，不符合当前集合已存在的场景，仅作补充参考：

exports.up = async (db, client) => {
  const session = client.startSession();
  try {
    await session.withTransaction(async () => {
      // 先在事务内创建新集合
      await db.createCollection('new_foo', { session });
      // 再给新集合创建索引
      await db.collection('new_foo').createIndex({ foo: 1 }, { session });
    });
  } finally {
    await session.endSession();
  }
}