Docker Compose部署MongoDB 5副本集后仍遭$changeStream不支持错误排查

我尝试通过Docker Compose部署MongoDB 5，应用使用pymongo 3.13.0和motor 2.5连接实例。启动后遇到错误：
pymongo.errors.OperationFailure: The $changeStream stage is only supported on replica sets, full error: {'ok': 0.0, 'errmsg': 'The $changeStream stage is only supported on replica sets', 'code': 40573, 'codeName': 'Location40573'}

我认为已配置副本集，但问题依旧，相关配置如下：

Dockerfile配置 #

FROM mongo:5.0
RUN mkdir /keys
COPY src/setup/replica.key /keys/replica.key
RUN chown 999:999 /keys/replica.key
RUN chmod 400 /keys/replica.key

Docker Compose中MongoDB配置段 #

mongo:
    build:
      args:
        REGISTRY_PATH: ${REGISTRY_PATH}
        IMAGE_TAG: ${IMAGE_TAG:-latest}
      context: .
      dockerfile: build/mongo/Dockerfile
    image: ${REGISTRY_PATH}mongo:${IMAGE_TAG:-latest}
    environment:
      MONGO_INITDB_DATABASE: <database>
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: <password>
      MONGO_USERNAME: <user>
      MONGO_PASSWORD: <password>
      MONGO_HOSTNAME: mongo
      BRANCH_NAME: ${BRANCH_NAME:-dev}
    command: "--auth --oplogSize 32 --quiet --replSet -nameReplicaSet --keyFile /keys/replica.key --logpath /dev/stdout"
    ports:
      - 27017:27017
    volumes:
      - ${MINIKUBE_REPO_PATH}/src/setup/replica.key:/keys/replica.key:ro
      - mongodb:/data/db
      - ${MINIKUBE_REPO_PATH}/src/setup/mongo-initdb.d:/docker-entrypoint-initdb.d/

1. 副本集启动参数格式错误 #

你的command中--replSet参数写法错误：--replSet -nameReplicaSet里的-nameReplicaSet是无效格式，正确应该是--replSet nameReplicaSet（去掉副本集名称前的短横线）。修正后的command如下：

command: "--auth --oplogSize 32 --quiet --replSet nameReplicaSet --keyFile /keys/replica.key --logpath /dev/stdout"

2. 副本集未完成初始化 #

即使启动参数正确，单节点副本集也需要初始化才能生效，有两种方式：

• 手动初始化：进入容器执行命令

  docker exec -it <你的Mongo容器名> mongosh -u admin -p <root密码>
  rs.initiate()
  

• 自动初始化：在/docker-entrypoint-initdb.d/目录下添加.js脚本（比如01-init-replica.js），内容如下：

  rs.initiate({
    _id: "nameReplicaSet",
    members: [{ _id: 0, host: "mongo:27017" }]
  })
  

  MongoDB容器启动时会自动执行该目录下的脚本，完成副本集初始化。

3. 应用连接需指定副本集名称 #

应用连接MongoDB时，连接字符串必须明确指定副本集名称，示例：

# pymongo连接示例
from pymongo import MongoClient
client = MongoClient("mongodb://admin:<密码>@mongo:27017/?replicaSet=nameReplicaSet")

# motor连接示例
import motor.motor_asyncio
client = motor.motor_asyncio.AsyncIOMotorClient("mongodb://admin:<密码>@mongo:27017/?replicaSet=nameReplicaSet")

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