brew安装的mongodb社区版默认不支持副本集，必须手动配置三个独立实例（不同端口、数据目录、日志路径及replsetname），全部启动后再用mongosh连接任一节点执行rs.initiate()初始化，否则会卡在startup2或选举失败。
直接用 brew 装的 MongoDB 社区版，**默认不带副本集支持**——必须手动配置多个实例、独立数据目录、不同端口和显式启用 replSetName，否则 rs.initiate() 会失败或卡在 STARTUP2 状态。
确认 brew 安装的 MongoDB 版本和路径
Homebrew 安装的 MongoDB 通常放在 /opt/homebrew/Cellar/mongodb-community/（Apple Silicon）或 /usr/local/Cellar/mongodb-community/（Intel），且 brew services start mongodb-community 只启一个默认实例（27017），无法直接用于副本集。
- 运行
brew info mongodb-community查看安装路径和版本，确保 ≥ 4.4（推荐 6.0+） - 检查实际二进制位置：
which mongod应返回类似/opt/homebrew/bin/mongod - 别依赖
brew services启动副本集节点——它只管理单实例服务，多节点必须手起mongod -f
建三个独立节点：数据、日志、配置分离
Mac 上常见错误是复用同一 dbPath 或没清空旧数据，导致启动报 lock file exists 或选举失败。每个节点必须有专属路径，且权限可写。
- 创建统一根目录：
mkdir -p ~/mongodb-rs/{nodes/{rs0-1,rs0-2,rs0-3},logs,config} - 为每个节点建数据目录：
mkdir -p ~/mongodb-rs/nodes/rs0-1/data ~/mongodb-rs/nodes/rs0-2/data ~/mongodb-rs/nodes/rs0-3/data - 设权限（关键！）：
chmod 755 ~/mongodb-rs && chmod -R 775 ~/mongodb-rs/nodes ~/mongodb-rs/logs（避免Permission denied） - 配置文件示例（存为
~/mongodb-rs/config/mongod-27017.conf）：
systemLog:
destination: file
path: /Users/$USER/mongodb-rs/logs/mongod-27017.log
logAppend: true
storage:
dbPath: /Users/$USER/mongodb-rs/nodes/rs0-1/data
journal:
enabled: true
net:
port: 27017
bindIp: 127.0.0.1
ipv6: false
replication:
replSetName: rs0
processManagement:
fork: true
另两个配置仅需改 port（27018 / 27019）、dbPath（对应 rs0-2 / rs0-3）、path 日志路径即可。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
启动三节点并初始化副本集
顺序很重要：必须**先全部启动 mongod 进程，再连任意一个端口执行 rs.initiate()**；如果只启一个就 init，其他节点会因连接超时被标记为 DOWN。
- 依次启动：
mongod -f ~/mongodb-rs/config/mongod-27017.conf，再mongod -f ~/mongodb-rs/config/mongod-27018.conf，最后mongod -f ~/mongodb-rs/config/mongod-27019.conf - 确认进程在跑：
ps aux | grep mongod | grep -v grep应看到三条带不同端口的记录 - 用
mongosh --port 27017连主候选节点，执行：
rs.initiate({
_id: "rs0",
members: [
{ _id: 0, host: "127.0.0.1:27017" },
{ _id: 1, host: "127.0.0.1:27018" },
{ _id: 2, host: "127.0.0.1:27019" }
]
})
返回 { ok: 1 } 即成功；等几秒后运行 rs.status()，应看到一个 PRIMARY 和两个 SECONDARY。
常见卡点与绕过方式
副本集搭建在 Mac 上最常卡在 DNS 解析、权限、或配置未生效——不是 MongoDB 本身问题，而是本地环境细节没对齐。
-
rs.status()显示成员状态为STARTUP2或UNKNOWN：检查各节点日志（tail -f ~/mongodb-rs/logs/mongod-*.log），大概率是某节点连不上其他节点的host；把配置里的host全部写成127.0.0.1，别用localhost（macOS 的localhost可能解析到 IPv6） - 启动时报
Failed to unlink socket file：删掉对应dbPath下的mongod.lock和journal/目录（确保 mongod 已停） -
mongosh找不到命令：brew 安装的mongosh是单独包，需brew install mongosh，不是随mongodb-community自带 - 想快速重试？别只
kill -2进程——用pgrep mongod | xargs kill -9彻底杀净，再清空所有data/目录（开发环境可接受）
真正麻烦的从来不是命令本身，而是每个节点的 dbPath 是否干净、bindIp 是否锁死在 127.0.0.1、以及 mongosh 连的端口是否真对应已启动的实例——这三点漏一个，rs.initiate() 就永远卡住。
