Node.js+Mongoose环境下事务中配置secondaryPreferred读偏好触发MongoError的问题求助

这个错误其实是MongoDB的硬性规则导致的——事务的ACID特性要求所有事务内的操作必须在主节点（primary）上执行，副本集的secondary节点仅用于只读的非事务查询，没法处理事务相关的一致性和原子性要求，所以不管你全局配置的readPreference是什么，事务内的操作都会强制要求使用primary。

解决方案：区分事务与非事务操作的readPreference #

我们可以保持全局的secondaryPreferred配置来优化非事务查询的性能，同时为事务操作单独使用MongoDB会话（Session）来自动适配primary的要求：

• 保留全局连接配置：你的现有连接代码没问题，secondaryPreferred依然可以为非事务查询提供从secondary节点读取的能力
• 事务操作使用会话执行：所有需要事务的API，必须通过Mongoose的会话来包裹操作，会话在事务期间会自动将readPreference强制设为primary，无需额外修改

下面是事务操作的代码示例：

async function updateUserWithTransaction(userId, newAge) {
  // 启动一个会话
  const session = await mongoose.startSession();
  session.startTransaction();

  try {
    const User = mongoose.model('User');
    // 事务内的所有操作都必须绑定这个session
    const user = await User.findById(userId).session(session);
    if (!user) throw new Error('User not found');

    user.age = newAge;
    await user.save({ session });

    // 提交事务
    await session.commitTransaction();
    console.log('Transaction committed successfully');
    return user;
  } catch (err) {
    // 出错时回滚事务
    await session.abortTransaction();
    console.error('Transaction aborted:', err);
    throw err;
  } finally {
    // 结束会话
    session.endSession();
  }
}

为什么不能在事务中使用secondaryPreferred？ #

MongoDB的事务依赖主节点的写操作能力和数据一致性保障：

• secondary节点的数据是异步同步自primary的，存在一定延迟，无法保证事务操作所需的实时一致性
• 事务涉及的写入操作只能在primary执行，而事务内的读写必须在同一个节点完成，所以查询也必须指向primary

这样调整后，非事务的API依然可以从secondary节点读取数据，事务API则会自动使用primary节点，既满足了性能优化需求，又符合MongoDB的事务约束。

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