MongoDB 运行事务时报“Transaction numbers are only allowed on a replica set member or mongos“错误

已于 2023-06-08 20:10:51 修改
阅读量9.9k 收藏 9
点赞数 7
分类专栏： MongoDB 文章标签： mongodb
于 2022-07-03 00:15:27 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_43665821/article/details/125579864
版权
本文介绍如何在MongoDB中启用副本集以使用事务功能。通过修改配置文件并初始化复制集，可以实现在多副本环境中进行事务操作。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

MongoDB 的事务只能在开启副本集的时候才能使用，Windows 上的 MongoDB 安装后默认是单副本，我们可以将其转换成多副本后再运行事务

  1. 在安装目录下找到 MongoDB 的配置文件 mongod.cfg
  2. 添加如下配置，注意格式：replSetName 前面是 4 个空格而不是 tab 字符
replication:
    replSetName: rs0
  1. 重启 MongoDB 服务
  2. 进入 MongoDB 的 bin 目录，cmd 执行 mongo 命令，执行 rs.initiate() 初始化复制集
  3. （可能会提示需要身份验证）
use admin;
db.auth("admin", "123123");
  1. 返回如下信息则代表成功
    在这里插入图片描述

参考资料

  • https://blog.csdn.net/weixin_39639505/article/details/110855860?spm=1001.2101.3001.6661.1&utm_medium=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7ECTRLIST%7Edefault-1-110855860-blog-111152880.pc_relevant_default&depth_1-utm_source=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7ECTRLIST%7Edefault-1-110855860-blog-111152880.pc_relevant_default&utm_relevant_index=1
解决mongo报错(IllegalOperation) Transaction numbers are only allowed on a replica set member
chmod111的博客
08-01 2095
mongo未开启复制,进行事务管理时，在发生异常时session无法完成回滚。mongo开启副本集功能.
docker搭建mongo单机单节点副本集模式
weixin_42211693的博客
06-07 1460
现有如下问题：后续解答这两个问题。
【MongoDB】事务Transaction numbers are only allowed on a replica set member or mongos
liuty的博客
08-30 4201
monodb报错"Transaction numbers are only allowed on a replica set member or mongos"解决方案。
yum安装MongoDB实例配置为副本集问题
qq_37675219的博客
03-14 523
遇到错误，表明您正在尝试在一个非副本集（standalone）MongoDB 实例上执行事务，而事务只能在副本集或 MongoDB Sharded 集群（mongos）上使用。由于您是通过yum。
MongoServerError: Transaction numbers are only allowed on a replica set member or mongos 事务解决
Mr. David 专栏
09-04 2095
【代码】MongoServerError: Transaction numbers are only allowed on a replica set member or mongos 事务解决。
navicat - Transaction numbers are only allowed on a replica set member or mongos
长门有希的博客
07-03 7148
取消选中图中选项即可
MongoBDTemplate 集群插入报错 Transaction numbers are only allowed on a replica set member or mongos
爱吃薯片的博客
12-14 4815
报错信息 Caused by: com.mongodb.MongoWriteException: Transaction numbers are only allowed on a replica set member or mongos at com.mongodb.client.internal.MongoCollectionImpl.executeSingleWriteRequest(MongoCollectionImpl.java:1017) at com.mongodb.client.inte
java replica set_springboot访问mongo异常Transaction numbers are only allowed on a replica set member or ...
weixin_39639622的博客
02-24 843
java 使用springboot访问mongo副本集分片集群pomorg.springframework.bootspring-boot-starter-data-mongodbapplication.properties#mongodbspring.data.mongodb.uri=mongodb://10.10.22.191:29000/project_datajava代码@Autowire...
Mongodb副本集和分片示例详解
12-16
MongoDB 是一个流行的开源文档型数据库，以其高性能、高可用性和可扩展性著称。在本文中，我们将探讨 MongoDB 的两个关键特性：副本集和分片，并通过示例进行详细解释。 **一、MongoDB 副本集** 副本集是 MongoDB ...
MongoDB副本集（Replica Set）详解与实战操作
2301_81446229的博客
06-17 2348
MongoDB副本集（Replica Set）是一种数据冗余和故障恢复机制，它允许你维护相同数据的一个或多个副本，并提供自动故障转移和数据恢复能力。副本集是一个包含多个MongoDB实例（通常称为成员）的集合，其中一个成员被选举为主节点（Primary），其他成员作为从节点（Secondary）或仲裁节点（Arbiter）。主节点（Primary）：负责处理客户端的读写请求，并将数据更改写入其本地数据文件中。
MongoDB副本集（Replica Set）操作详解
2302_82205625的博客
06-18 2116
MongoDB副本集是保障MongoDB数据高可用性和灾难恢复能力的重要技术。通过合理地配置和使用副本集，我们可以提高MongoDB服务的稳定性和可靠性。在实际操作中，建议仔细阅读官方文档，并根据实际需求进行配置和优化。
tp6+mongodb.zip
01-13
修改tp6 原有的mongo 包存在的问题
tp5(thinkPHP5)操作mongoDB数据库的方法
10-18
主要介绍了tp5(thinkPHP5)操作mongoDB数据库的方法,结合实例形式简单分析了mongoDB数据库及thinkPHP5连接、查询MongoDB数据库的基本操作技巧,需要的朋友可以参考下
mongo 4 中事务的简单学习
zgrbsbf的专栏
11-16 7350
我也的mongo的版本是4.0.4 这是一个新增的功能，以前不支持事务 1. run-rs与replica set 事务操作如果连接的mongo不是副本集的话，会报错： Transaction numbers are only allowed on a replica set member or mongos 所以还要想办法弄个副本集出来，为了方便，使用了run-rs这个npm包，开启副本集...
使用run-rs启动mongodb
solocao的专栏
07-20 835
为什么需要： 因为在mac上直接使用社区版，进行备份数据导入时，会报错： MongoError: Transaction numbers are only allowed on a replica set member or mongos run-rs可以零配置启动mongodb 1、npm install run-rs -g 2、run-rs -v 4.0.0 --shell ...
mongodb 报"when a host is not a member of a replica set' on server 127.0.0.1:27017" 解决方案
lanhaics的专栏
04-10 1741
在部署本地服务器运行的MONGODB数据库，可能会报上述错误； 从字面意思上看，与服务器备份有关； stackoverflow.com给出的解决方案如下； 个人配置如下: <mongo:mongo-client id="mongo" host="${mongo.host}" port="${mongo.port}" credentials="${mongo.credenti...
在 Windows 系统中开启 MongoDB 事务操作
80后大叔的自学之路
10-18 895
在 Windows 系统下安装 MongoDB 后默认是单副本，而 MongoDB 的事务操作需要在副本集的状态下才可以使用，不然会报错 “Transaction numbers are only allowed on a replica set member or mongos”，所以需要修改 MongoDB 的配置文件来开启副本集。
关于解决MongoDB集群搭建问题中由于非正常关闭服务导致出现error:child process failed, exited with error number 1 无法启动服务
weixin_42594251的博客
12-12 481
** 关于解决MongoDB集群搭建问题中由于非正常关闭服务导致出现error:child process failed, exited with error number 1 无法启动服务 ** 关于MongoDB正常退出的参考链接 关于repair的参考链接 问题图： 主要问题文件：mongod.lock （mongod.lock文件存放的是：启动mongod的进程号） 首先，删除mongo...
Caused by: com.mongodb.MongoCommandException: Command failed with error 20 (IllegalOperation): 'Transaction numbers are only allowed on a replica set member or mongos' on server 192.168.3.220:28017. The full response is {"ok": 0.0, "errmsg": "Transaction numbers are only allowed on a replica set member or mongos", "code": 20, "codeName": "IllegalOperation"}
最新发布
04-03
<think>好的，我现在需要处理用户提出的另一个MongoDB错误：“Caused by: com.mongodb.MongoCommandException: Command failed with error 20 (IllegalOperation): 'Transaction numbers are only allowed on a replica set member or mongos'”。用户之前询问过关于retryWrites的问题，现在遇到了新错误，可能与事务有关。首先，我要理解这个错误的根本原因。 根据错误信息，事务编号只能在副本集成员或mongos上使用。这说明用户可能是在单节点部署上尝试使用事务，而MongoDB的事务功能需要副本集或分片集群支持。我需要确认这一点，并回忆MongoDB的事务支持条件。MongoDB从4.0版本开始支持副本集的事务，4.2开始支持分片集群的事务。如果用户的环境是单机部署，事务无法运行，导致此错误。 接下来，用户可能是在开发环境中使用单节点，或者配置了副本集但未正确初始化。需要指导用户检查他们的部署类型。可能的解决步骤包括：建议用户将部署改为副本集，或者如果不需要事务，则禁用相关功能。此外，还要检查连接字符串是否正确指向mongos（分片集群的情况），或者是否存在配置错误。 另外，用户之前遇到的retryWrites问题可能与当前问题相关，因为retryWrites和事务都依赖于副本集或分片环境。可能需要提醒用户确保他们的MongoDB版本符合要求，并正确配置副本集。如果用户是在测试环境中使用单节点，可以指导他们如何将单节点转换为单节点副本集，这是开发中的常见做法。 还需要考虑用户是否在代码中错误地启用了事务，而他们的环境并不支持。比如，即使MongoDB版本足够，但如果是单节点未配置为副本集，仍然会失败。因此，解决方案可能包括环境配置调整或代码修改。 最后，总结步骤：确认部署类型，升级或重新配置MongoDB，调整连接字符串，检查代码中的事务使用。同时，提供具体的命令示例，如如何初始化副本集，如何修改连接字符串，以及相关注意事项，如版本要求和配置细节，确保用户能逐步解决问题。</think>--- ### 问题分析 这个错误是由于在 **单机模式（Standalone）** 的 MongoDB 实例上尝试使用**事务（Transactions）**，而 MongoDB 要求事务必须运行在 **副本集（Replica Set）** 或 **分片集群（Sharded Cluster）** 环境中。以下是详细的解决步骤： --- ### 1. **根本原因** - **事务依赖的底层机制**： MongoDB 事务需要依赖副本集的 `oplog` 或分片集群的协调节点（`mongos`）来保证原子性和隔离性。 - **单机模式限制**： 单机部署的 MongoDB（非副本集或分片集群）不支持事务操作。 - **常见触发场景**： - 开发环境中使用了单节点 MongoDB。 - 副本集未正确初始化（例如未执行 `rs.initiate()`）。 - 连接字符串错误指向了单机节点而非 `mongos`。 --- ### 2. **验证部署类型** 通过 MongoDB Shell 检查当前部署模式： ```javascript // 检查是否为副本集成员 rs.status(); // 若返回错误 "Not running with --replSet"，则为单机模式 // 检查分片集群状态（仅在分片部署中有效） sh.status(); ``` --- ### 3. **解决方案** #### 方案一：将单机转换为副本集（推荐开发环境） 1. **停止 MongoDB 服务**： ```bash sudo systemctl stop mongod ``` 2. **修改配置文件**： 在 `mongod.conf` 中添加副本集配置： ```yaml replication: replSetName: "rs0" # 副本集名称（例如 rs0） ``` 3. **重启 MongoDB 服务**： ```bash sudo systemctl start mongod ``` 4. **初始化副本集**： 连接到 MongoDB Shell 并执行： ```javascript rs.initiate({ _id: "rs0", members: [{ _id: 0, host: "localhost:27017" }] // 单节点副本集 }); ``` 5. **验证副本集状态**： ```javascript rs.status(); // 确认状态为 PRIMARY ``` --- #### 方案二：连接分片集群（生产环境） 确保连接字符串指向 `mongos` 路由器（而非单机节点）： ```uri mongodb://username:password@mongos-host:port/dbname ``` --- #### 方案三：禁用事务（临时绕过） 如果事务非必需，在代码中关闭事务逻辑： ```java // Java 示例：禁用事务 try (ClientSession session = client.startSession()) { // 明确不启用事务 session.withTransaction(() -> { // 无事务的操作 return null; }, TransactionOptions.builder().build()); } ``` --- ### 4. **版本兼容性** - **MongoDB 4.0+**：支持副本集事务。 - **MongoDB 4.2+**：支持分片集群事务。 若版本低于 4.0，需升级到支持事务的版本。 --- ### 5. **其他注意事项** - **连接字符串检查**： 确保未误用单机节点 IP，例如 `192.168.3.220:28017` 应为副本集成员或 `mongos`。 - **驱动配置**： 某些驱动（如 Java 驱动 4.0+）默认尝试启用事务，需显式配置或降级驱动。 --- ### 总结步骤 1. **检查部署模式**：确认 MongoDB 是副本集或分片集群。 2. **转换单机为副本集**（开发环境）或连接 `mongos`（生产环境）。 3. **验证事务功能**：通过简单事务操作测试。 4. **调整代码或配置**：禁用事务或升级环境。 通过以上方法，可解决事务在单机模式下的非法操作问题。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值