mongodb副本集启动报illegaloperation，首要排查版本混用与host解析失败：执行db.version()核对各节点版本一致性，确保rs.initiate()中host可双向解析且防火墙放行27017端口。
副本集成员启动时报 IllegalOperation：先确认 MongoDB 版本是否混用
这个错误常被误判为配置问题，但真实原因可能是集群中不同节点运行了不兼容的 MongoDB 版本。4.2+ 引入的事务机制对版本一致性极其敏感——哪怕一个成员是 5.0，另一个是 4.4，rs.initiate() 或后续 rs.add() 都可能在握手阶段触发 IllegalOperation，错误信息里却不会明说版本冲突。
实操建议：
- 登录每个成员节点，执行
mongosh --eval "db.version()"，逐个核对输出，不要只信包管理器显示的安装版本（例如 yum 安装后未重启服务，旧进程仍在跑） - 检查二进制路径：运行
which mongod和mongod --version，确认实际加载的是预期版本；Docker 环境要检查镜像 tag 是否一致，docker ps+docker inspect查Image字段 - 4.4 与 5.0 之间不支持直接升级副本集，必须先统一降级或升级到中间兼容版本（如全升至 5.0），不能靠
rs.reconfig()强行覆盖
rs.initiate() 失败并报 IllegalOperation：检查配置项是否遗漏或错位
常见错误不是语法写错，而是 YAML 缩进或布尔值格式不对，导致 replSetName、enableMajorityReadConcern 等关键项未被真正加载。MongoDB 启动时若没读到 replSetName，后续任何 rs.* 命令都会因“非副本集上下文”而返回 IllegalOperation。
实操建议：
- 用
mongod --config /etc/mongod.conf --dryRun验证配置文件语法，它会输出最终生效的配置快照，重点看replication段是否完整出现且字段值非空 -
enableMajorityReadConcern必须设为true（不是"true"字符串），且需配合storage.engine: wiredTiger—— mmapv1 引擎不支持 majority read concern - 如果使用 systemd，确保
systemctl daemon-reload在修改配置后执行，否则systemctl restart mongod仍加载旧配置缓存
连接副本集后执行事务仍报 IllegalOperation：验证客户端连接串和会话初始化
即使副本集状态正常（rs.status() 显示 PRIMARY/SECONDARY），应用层仍可能因连接方式错误退回到单机模式。典型表现是 Spring Boot 的 mongoClient 自动降级为 direct connection，绕过 replica set discovery。
实操建议：
- 连接字符串必须包含
?replicaSet=rs0（与配置中replSetName严格一致），且 host 列表至少含两个地址（如mongodb://localhost:27017,localhost:27018/?replicaSet=rs0），否则驱动不启用副本集逻辑 - 事务必须绑定有效 session：Java 中不能直接
collection.insertOne()，得先client.startSession()，再session.startTransaction()；Node.js 中要用withTransaction()包裹操作 - 检查
mongosh连接时是否带--eval "rs.status()"成功，但应用连的是localhost:27017单点而非副本集地址 —— 这种“伪副本集”最易踩坑
初始化副本集后 SECONDARY 节点始终无法加入：关注 oplog 和 host 解析
rs.add("node2:27017") 返回成功，但 rs.status().members 里该节点长期卡在 STARTUP2 或直接消失，接着主节点日志刷出 IllegalOperation 类错误，大概率是 oplog 不可写或 hostname 解析失败。
实操建议：
- 确认
storage.dbPath目录下存在local.oplog.rs文件，且权限为mongod用户可读写；若用 Docker，宿主机映射路径需加:z或:ZSELinux 标签 - 所有成员的
host字段（rs.initiate()或rs.add()中）必须能被彼此反向解析：在 node1 上ping node2要通，且nslookup node2返回的 IP 必须与 node2 实际监听的 IP 一致（避免 localhost / 127.0.0.1 被其他节点解析失败） - 防火墙必须放行各节点间
27017端口的 TCP 入站连接，不只是客户端访问端口 —— 副本集内部通信也走这个端口
IllegalOperation，没有进一步线索。调试时别只盯命令返回，一定要查 /var/log/mongodb/mongod.log 里每个节点的启动和同步阶段原始日志，错误通常藏在 init 或 repl handshake 的几十行上下文里。
