运行Payload CMS连接MongoDB时出现认证错误：command aggregate requires authentication

错误原因 #

MongoServerError: command aggregate requires authentication 表明你的MongoDB实例已启用认证机制，但Payload CMS的数据库连接配置未提供有效的认证凭证，或者MongoDB容器未创建对应的授权用户。

解决方案 #

1. 重新配置带认证的MongoDB容器 #

默认情况下，mongo镜像启动时若未设置环境变量，不会启用认证，但如果之前的容器数据卷保留了认证配置，会导致后续启动的实例强制要求认证。按以下步骤重新配置：

• 停止并删除现有容器：

  docker stop backup-database-1 && docker rm backup-database-1
  

• 启动带根用户认证的容器（替换your-strong-password为实际密码）：

  docker run -d \
    --name backup-database-1 \
    -p 27017:27017 \
    -e MONGO_INITDB_ROOT_USERNAME=admin \
    -e MONGO_INITDB_ROOT_PASSWORD=your-strong-password \
    -v mongo-data:/data/db \
    mongo:6.0.6-jammy
  

• （可选，更安全）创建Payload专用数据库用户：
  进入MongoDB容器的Shell：

  docker exec -it backup-database-1 mongosh -u admin -p your-strong-password
  

  在Shell中执行以下命令创建用户（替换数据库名、用户名和密码为你的实际信息）：

  use payload_db;
  db.createUser({
    user: "payload_user",
    pwd: "payload-secure-password",
    roles: ["readWrite", "dbAdmin"]
  });
  

2. 更新Payload CMS的数据库连接配置 #

修改Payload的连接配置，添加认证信息：

• 如果使用.env文件：

  DATABASE_URI=mongodb://payload_user:payload-secure-password@localhost:27017/payload_db?authSource=payload_db
  

• 如果直接在payload.config.ts中配置：

  import { buildConfig } from 'payload/config';
  
  export default buildConfig({
    db: {
      uri: "mongodb://payload_user:payload-secure-password@localhost:27017/payload_db?authSource=payload_db",
    },
    // 其他配置项...
  });
  

3. 验证与重启 #

• 重启Payload CMS应用，访问http://localhost:3000/admin测试连接。
• 若仍有问题，查看MongoDB容器日志排查：

  docker logs backup-database-1
  

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