MongoDB Atlas免费M0集群执行事务报错：仅副本集或mongos支持事务编号

问题根源 #

M0免费集群本身支持多文档事务，但这个报错说明你的连接或代码存在问题，导致客户端未正确识别集群的副本集结构。

排查修复步骤 #

1. 确认连接字符串有效性 #

你的连接字符串格式没问题，但要确保：

• 替换USER、PASS、DB_NAME为真实的账号、密码和数据库名
• 使用MongoDB Node.js驱动4.0及以上版本（旧版本可能存在副本集识别兼容问题）

2. 修正事务代码的错误 #

第一种实现方式的问题

代码逻辑本身无大错，但要保证connection是数据库全局连接实例，而非单个集合或模型；同时在Mongoose环境下，需确保SomeModel基于当前连接创建。

修正后的代码：

const session = await connection.startSession();
session.startTransaction();
try {
  // 确保SomeModel属于当前连接的模型实例
  const result = await SomeModel.create({ stuff }, { session });
  await session.commitTransaction();
  return result;
} catch (error) {
  console.log("回滚事务!", error);
  await session.abortTransaction();
  throw error; // 建议抛出错误让上层逻辑处理
} finally {
  await session.endSession();
}

第二种实现方式的问题

withTransaction方法会自动处理事务的提交、回滚及会话状态，无需手动调用commitTransaction、abortTransaction和endSession，手动调用会打乱会话状态，直接引发报错。

修正后的代码：

const session = await connection.startSession();
try {
  const result = await session.withTransaction(async () => {
    return await SomeModel.create({ stuff }, { session });
  });
  return result;
} catch (error) {
  console.log("事务执行失败!", error);
  throw error;
} finally {
  await session.endSession();
}

3. 额外检查项 #

• 登录Atlas控制台确认集群处于「Running」状态，无异常告警
• 使用Mongoose时，连接配置显式声明useNewUrlParser: true和useUnifiedTopology: true（新版驱动默认启用，但显式配置更稳妥）
• 避免在事务中操作不支持事务的集合类型（如capped集合，M0集群默认不会创建这类集合）

总结 #

Atlas M0集群完全支持多文档事务，报错核心原因多为事务流程的错误调用，或客户端未正确连接到副本集节点。按上述步骤修正后，事务即可正常执行。

内容的提问来源于stack exchange，提问作者goldylucks