本地NestJS应用连接bitnami/mongodb失败的解决方法

问题场景 #

本地运行的NestJS应用尝试连接由Bitnami镜像搭建的MongoDB副本集，但无法正常建立连接。相关配置如下：

Docker Compose配置 #

version: "2"
services:
  mongodb-primary:
    image: docker.io/bitnami/mongodb:5.0
    environment:
      - MONGO_INITDB_ROOT_USERNAME=root
      - MONGO_INITDB_ROOT_PASSWORD=password123
      - MONGODB_ADVERTISED_HOSTNAME=localhost
      - MONGODB_REPLICA_SET_MODE=primary
      - MONGODB_ROOT_PASSWORD=password123
      - MONGODB_REPLICA_SET_KEY=replicasetkey123
    volumes:
      - "mongodb_master_data:/bitnami/mongodb"
    ports:
      - "27017:27017"

  mongodb-secondary:
    image: docker.io/bitnami/mongodb:5.0
    depends_on:
      - mongodb-primary
    environment:
      - MONGODB_ADVERTISED_HOSTNAME=mongodb-secondary
      - MONGODB_REPLICA_SET_MODE=secondary
      - MONGODB_INITIAL_PRIMARY_HOST=mongodb-primary
      - MONGODB_INITIAL_PRIMARY_ROOT_PASSWORD=password123
      - MONGODB_REPLICA_SET_KEY=replicasetkey123

  mongodb-arbiter:
    image: docker.io/bitnami/mongodb:5.0
    depends_on:
      - mongodb-primary
    environment:
      - MONGODB_ADVERTISED_HOSTNAME=mongodb-arbiter
      - MONGODB_REPLICA_SET_MODE=arbiter
      - MONGODB_INITIAL_PRIMARY_HOST=mongodb-primary
      - MONGODB_INITIAL_PRIMARY_ROOT_PASSWORD=password123
      - MONGODB_REPLICA_SET_KEY=replicasetkey123

volumes:
  mongodb_master_data:
    driver: local

NestJS根模块配置 #

@Module({
  imports: [
    ConfigModule.forRoot({
      envFilePath: '.env',
      isGlobal: true,
    }),

    MongooseModule.forRoot('mongodb://root:password123@localhost:27017/'),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

问题原因分析 #

1. Primary节点hostname配置错误：MONGODB_ADVERTISED_HOSTNAME=localhost会导致副本集内部节点无法正确识别primary的网络地址，secondary和arbiter无法与primary建立复制关系，直接导致副本集初始化失败。
2. 连接字符串未指定副本集信息：当前NestJS的连接字符串仅指向单个primary节点，既未声明副本集名称，也未包含secondary节点地址，无法触发MongoDB的副本集模式连接逻辑。
3. 缺少副本集连接参数：Mongoose连接时未配置replicaSet、authSource等关键参数，导致客户端无法以副本集模式完成身份验证和连接。

修复步骤 #

1. 修正Docker Compose配置 #

• 将primary节点的MONGODB_ADVERTISED_HOSTNAME改为容器名mongodb-primary，确保副本集内部节点能通过Docker网络正常通信。
• 给所有节点添加MONGODB_REPLICA_SET_NAME环境变量，统一副本集名称（示例设为rs0）。

修改后的mongodb-primary服务配置：

mongodb-primary:
  image: docker.io/bitnami/mongodb:5.0
  environment:
    - MONGO_INITDB_ROOT_USERNAME=root
    - MONGO_INITDB_ROOT_PASSWORD=password123
    - MONGODB_ADVERTISED_HOSTNAME=mongodb-primary  # 改为容器名
    - MONGODB_REPLICA_SET_MODE=primary
    - MONGODB_ROOT_PASSWORD=password123
    - MONGODB_REPLICA_SET_KEY=replicasetkey123
    - MONGODB_REPLICA_SET_NAME=rs0  # 添加统一的副本集名称
  volumes:
    - "mongodb_master_data:/bitnami/mongodb"
  ports:
    - "27017:27017"

给mongodb-secondary和mongodb-arbiter服务添加相同的MONGODB_REPLICA_SET_NAME=rs0环境变量。

2. 更新NestJS连接配置 #

修改Mongoose连接参数，指定副本集名称、认证源，并包含可访问的节点地址：

MongooseModule.forRoot({
  uri: 'mongodb://root:password123@localhost:27017',
  dbName: 'your-target-db', // 替换为实际要连接的数据库名称
  replicaSet: 'rs0', // 与Docker Compose中配置的副本集名称一致
  readPreference: 'primaryPreferred', // 根据业务需求选择读偏好策略
  authSource: 'admin', // root用户的认证源为admin数据库
})

如果NestJS也运行在Docker容器中，需使用容器网络地址连接：

uri: 'mongodb://root:password123@mongodb-primary:27017,mongodb-secondary:27017'

3. 重新部署副本集 #

停止并清理现有容器，重新启动副本集：

docker-compose down -v
docker-compose up -d

等待3-5分钟让副本集完成初始化，可通过以下命令验证状态：

docker exec -it $(docker ps -q --filter name=mongodb-primary) mongosh -u root -p password123 --eval "rs.status()"

验证连接 #

重新启动NestJS应用，检查应用日志是否有连接成功的提示，或通过简单的数据库读写操作验证连接有效性。

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