rs.initiate()报illegaloperation首要排查版本混用与replsetname未加载：执行db.version()核对各节点真实版本，用--dryrun验证配置中replication.replsetname是否生效，确保systemd重载后重启。
rs.initiate() 报 IllegalOperation 怎么快速定位
这不是配置写错了，八成是版本混用或 replSetName 根本没加载成功。MongoDB 5.0 对版本一致性极其敏感，4.4 和 5.0 节点混跑，握手阶段就会触发 IllegalOperation，但错误里不提版本。
- 登录每个节点，执行
mongosh --eval "db.version()"，逐个比对输出——别信yum list installed或docker images显示的 tag，得看实际进程加载的版本 - 运行
which mongod和mongod --version，确认二进制路径和真实版本一致 - 用
mongod --config /etc/mongod.conf --dryRun检查配置是否生效，重点看输出里replication.replSetName是否存在且非空 - 如果用了 systemd，改完配置后必须执行
systemctl daemon-reload，否则systemctl restart mongod仍读旧缓存
启动失败提示 “Keyfile permissions are too open”
MongoDB 5.0 强制要求 keyFile 权限必须是 400，600 都不行——这不是建议，是启动拦截。而且权限正确还可能被 SELinux/AppArmor 静默拒绝。
- 执行
ls -l /etc/mongo-keyfile，末三位必须是400；不是就立刻chmod 400 /etc/mongo-keyfile -
chown必须在chmod之后做，顺序反了某些系统会重置权限位；属主必须是运行mongod的用户（如mongod），不能是root - 检查 SELinux：临时测试用
setenforce 0；永久修复需semanage fcontext -a -t mongod_etc_t "/etc/mongo-keyfile"+restorecon -v /etc/mongo-keyfile - Ubuntu/Debian 用户检查 AppArmor 规则是否含
/etc/mongo-keyfile r，用aa-status | grep mongod确认
rs.status() 显示成员 not reachable 或 healthy 为 false
常见于反复 rs.remove() + rs.add() 后 ID 错乱，或者节点用 IP 地址初始化过又被 DNS 替换——MongoDB 会保留旧成员 ID，导致握手失败。
- 停掉所有节点：
systemctl stop mongod（或 Windows 下net stop） - 清理数据目录下的
local.*文件（如local.0、local.ns），这些是副本集元数据缓存，不删会继承旧 ID - 确保
rs.initiate()只在 PRIMARY 节点执行一次，且members数组中所有host字段都用 DNS 主机名（如"node1.example.com:27017"），不能夹杂 IP - 添加新成员前，先用
ping node2.example.com和nslookup node2.example.com确保双向解析通，防火墙放行27017端口
连接副本集后事务仍报 “Transaction numbers only allowed on replica set member”
说明客户端根本没连上副本集上下文，而是退化成直连单节点模式。Spring Boot、Node.js driver 等常因连接串或自动发现逻辑失效导致此问题。
- 检查连接字符串是否含
?replicaSet=rs0（rs0替换为你实际的replSetName），且 host 列表是逗号分隔的多个节点（如mongodb://node1:27017,node2:27017,node3:27017/?replicaSet=rs0） - 在 mongosh 中执行
db.runCommand({isMaster:1})，返回里必须有hosts数组和setName字段，否则就是没走 replica set discovery - Spring Boot 用户注意：
spring.data.mongodb.uri必须完整包含所有节点和replicaSet参数，不要只写一个地址再靠 auto-discovery——很多环境会跳过发现逻辑直接直连 - 验证时用
rs.status().members[n].stateStr看状态，若出现STARTUP或RECOVERING超过 30 秒，大概率是 oplog 不同步或磁盘 I/O 延迟，不是配置问题
rs.initiate() 成功了但客户端连的是 IP 地址而非 host 名——日志里不会明说，得一层层剥。动手前先看 journalctl -u mongod -n 50 --no-pager，倒数几行通常就是破局点。
