mlaunch是macOS上最快建副本集的方式，因其不下载二进制、不管理进程生命周期，仅调用本地mongod，自动分配端口、生成配置、初始化目录并执行rs.initiate()。
直接用 mlaunch 启动副本集最省事，但必须先装好 mongodb-tools（含 mlaunch），不是 mongosh 或 mongodb-community 自带的。
为什么 mlaunch 是 macOS 上最快建副本集的方式
它不下载 MongoDB 二进制，也不管理进程生命周期，只调用你本地已安装的 mongod；自动分配端口、生成配置、初始化数据目录、启动全部节点并完成 rs.initiate() —— 一条命令搞定。
- 前提是：你已通过 Homebrew 安装了完整版 MongoDB（
mongodb-community@8.0或更高），且mongod --version能正常输出 -
mlaunch不在mongodb-community包里，必须单独装：brew install mongodb/brew/mongodb-tools - 它默认使用
/data/db作为根数据路径，但会为每个节点建子目录（如/data/db/rs1/27018），避免手动清理残留 - 不支持 Apple Silicon 的 Rosetta 混合模式启动 —— 如果你用的是 M1/M2/M3 芯片，确保
mongod是原生 aarch64 架构（Homebrew 默认满足）
mlaunch init 启动三节点副本集的实操要点
运行以下命令即可拉起带仲裁节点的最小可用副本集（1 主 + 1 从 + 1 仲裁）：
mlaunch init --replicaset --nodes 2 --arbiter --port 27018
-
--nodes 2表示数据节点数（不含仲裁），所以总共 3 个mongod进程 -
--port 27018是主节点端口，其余节点自动顺延（27019、27020），避免端口冲突 - 它会自动创建
replSet名为rs0，无需额外配置文件；连接时用mongodb://localhost:27018/?replicaSet=rs0 - 日志默认写入
./data/logs/，可加--logpath /tmp/mlaunch-logs改路径，方便调试 - 若提示
command not found: mlaunch，说明mongodb-tools没装或 shell 未重载 PATH（重启终端或运行source ~/.zshrc）
常见失败现象和绕过方法
最常卡在「启动后 rs.status() 显示 OTHER 状态」或「无法选举主节点」，本质是网络绑定或权限问题：
- Mac 默认启用 IPv6，但某些
mlaunch版本对::1绑定不稳 → 加参数强制 IPv4：--bind_ip 127.0.0.1 - 如果之前手动启过
mongod占用了端口，mlaunch不会报错但节点间连不上 → 先执行lsof -i :27018 | grep LISTEN杀掉残留进程 - macOS 的 SIP（系统完整性保护）可能阻止
/data/db写入 → 改用用户目录：mlaunch init --replicaset --port 27018 --dir ~/mlaunch-rs - 遇到
Failed to connect to 127.0.0.1:27018 after 5 retries，大概率是mongod二进制缺失或版本太旧（mlaunch需要 4.4+）→ 运行mongod --version确认
停掉副本集不能只关终端窗口
mlaunch 启动的是一组后台 mongod 进程，关闭终端不会终止它们，下次再 mlaunch init 就会端口冲突：
- 正确停止方式：
mlaunch stop（在启动它的同一目录下运行） - 若忘了在哪启动的，用
mlaunch list查看当前活跃实例及工作目录 - 想彻底清空所有测试数据？删掉
mlaunch创建的data/目录即可，不影响系统 MongoDB 安装 - 别用
killall mongod—— 可能误杀你正在用的生产实例（比如 brew services 启动的那个）
真正麻烦的不是启动，而是副本集启动后没立刻进入 PRIMARY 状态，或者应用连上去发现写操作被拒绝 —— 这时候得看 rs.status().members 里每个节点的 stateStr 和 health，而不是盲目重试。每次 mlaunch init 都会覆盖旧配置，但不会自动修复已有数据损坏，这点容易被忽略。
