Docker部署MongoDB搭配Prisma出现SCRAM认证失败如何解决

这个报错和Prisma本身逻辑无关，是MongoDB端的身份校验未通过，按以下步骤排查即可：

• 第一步先排除Prisma配置干扰，直接验证连接串有效性
  在终端执行命令绕过Prisma直连Mongo：

  mongosh "mongodb://auction-user:password@localhost:27017/auction-db?authSource=admin"
  

  如果这一步就返回认证失败，说明问题完全出在Mongo端的用户配置，直接进容器排查即可。
• 第二步进入运行中的Mongo容器检查用户配置
  执行命令进入容器内的mongosh交互环境：

  docker exec -it auction-mongodb mongosh
  

  切换到连接串里authSource参数指定的admin库：

  use admin
  

  查询当前库下所有已创建的用户：

  db.getUsers()
  

  • 如果返回结果里没有auction-user账号，直接在当前admin库下执行创建用户的命令，密码、库权限和配置保持一致：

    db.createUser({
      user: "auction-user",
      pwd: "password",
      roles: [
        { role: "readWrite", db: "auction-db" },
        { role: "dbAdmin", db: "auction-db" }
      ]
    })
    

  • 如果已经存在auction-user账号，先确认账号密码和.env文件里填写的完全一致，再确认该账号拥有auction-db库的对应读写、管理权限。
• 常见踩坑点排查
  • 如果是用docker-compose启动Mongo，且通过挂载/docker-entrypoint-initdb.d目录下的脚本初始化用户，注意Mongo仅在数据卷为空、第一次启动容器时执行初始化脚本，之前启动过的旧容器、旧数据卷不会重复跑初始化逻辑，需要删除对应数据卷后重启容器才会生效。
  • 如果创建用户时选择的所属库不是admin，要同步修改连接串里authSource参数的值为实际创建用户的库名，否则Mongo会去错误的库下校验用户身份，必然返回认证失败。
  • 当前schema.prisma里写的previewFeatures = ["mongodb"]是旧版本Prisma的预览特性配置，目前正式版已经原生支持MongoDB，这个配置可以直接删除，不会影响认证逻辑但会触发版本警告。

账号配置修正完成后退出mongosh，重新执行npx prisma migrate reset即可正常连通。

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