macOS下Docker Compose中MongoDB单节点副本集暴露至宿主机问题

问题根源 #

你遇到的错误是因为MongoDB副本集节点对外暴露的地址是容器内部的mongo:27017，宿主机客户端连接后，MongoDB会将这个内部地址返回给客户端，导致客户端无法正确识别并连接到主节点——即使在/etc/hosts中添加映射，也无法解决副本集拓扑信息不匹配的核心问题。

解决步骤 #

1. 修改docker-compose配置 #

更新你的docker-compose.yml，添加副本集广告地址和绑定IP的环境变量：

version: "3"
services:
  mongo:
    image: bitnami/mongodb:4.4
    restart: always
    ports:
      - 27017:27017
    volumes:
      - ./db:/bitnami/mongodb
    environment:
        - MONGODB_REPLICA_SET_MODE=primary
        - ALLOW_EMPTY_PASSWORD=yes
        # 设置副本集对外暴露的地址，让宿主机客户端能正确识别
        - MONGODB_REPLICA_SET_ADVERTISED_HOSTNAME=localhost
        # 允许MongoDB监听所有网卡，确保容器外请求能被接收
        - MONGODB_BIND_IP=0.0.0.0

2. 重新部署容器 #

先清理旧容器，再启动新配置的服务：

# 停止并删除旧容器
docker-compose down
# 启动新配置的MongoDB服务
docker-compose up -d

注意：如果之前的数据库数据存在初始化残留问题，可先备份./db目录后将其删除，确保副本集重新完成正确初始化。

3. 验证连接 #

使用MongoDB Shell连接副本集：

mongosh "mongodb://localhost:27017/?replicaSet=rs0"

连接成功后，可执行rs.status()查看副本集状态，确认主节点已正常运行。

内容的提问来源于stack exchange，提问作者tyteen4a03