本文详解 nestjs + prisma 项目中连接 mongodb 时出现 `scram failure: authentication failed` 错误的根本原因及快速修复方法，核心是正确配置 `authsource` 参数。
在使用 Prisma 与 MongoDB 集成的 NestJS 项目中，执行 npx prisma db push 时遇到如下错误：
Error: MongoDB error SCRAM failure: Authentication failed.
该错误并非密码错误或服务未启动所致，而是 MongoDB 的认证机制要求明确指定用于验证凭据的数据库（即 authSource）。默认情况下，Prisma 会尝试在连接字符串中指定的目标数据库（如 test）内查找用户凭证；但实际中，MongoDB 用户通常是在 admin 数据库中创建并管理的——尤其当使用 mongod 默认配置或 Docker 官方镜像时。
✅ 正确做法是在 DATABASE_URL 中显式添加 authSource=admin 查询参数。修改 .env 文件中的连接字符串如下：
Word 文档生成与编辑
下载
需要创建、读取、编辑或处理 Word 文档（.docx / .dotx）时使用。触发词：'Word'、'word 文档'、'.docx'、'生成报告'、'制作合同/简历/方案/说明书'、'提取 word 内容'、'在文档里查找替换'、'给文档加页眉页脚/目录/表格'。也用于把任意内容排版成一份正式的 Word 文件。不要用它处理 PDF、Excel 或无关编程任务。中文创作场景尤其适合：小说大纲稿、投稿文档、合同、简历、工作总结。
DATABASE_URL="mongodb://user:password@localhost:27017/test?authSource=admin&authMechanism=SCRAM-SHA-1"
? 补充说明： authSource=admin：告知 MongoDB 从 admin 数据库读取用户认证信息； authMechanism=SCRAM-SHA-1：虽为 MongoDB 4.0+ 默认机制，显式声明可提升兼容性与可读性； 若你确实在 test 库中创建了用户（不推荐），则应设为 authSource=test，但生产环境强烈建议统一使用 admin 作为认证源。
? 其他注意事项：
- 确保 MongoDB 服务已启用访问控制（--auth 启动参数或 security.authorization: enabled 配置）；
- 验证用户是否已在 admin 库中正确创建（可通过 mongo shell 执行 use admin → db.createUser({...})）；
- Prisma v5.x 对 MongoDB 的支持已趋于稳定，但暂不支持 @relation 或完整事务语义，建模时请避免依赖关系型特性；
- 修改 .env 后，务必重新运行 npx prisma generate 以更新 Prisma Client。
完成配置后，再次执行：
npx prisma db push
即可成功同步 Schema —— 认证问题将彻底解决。这一配置是 Prisma + MongoDB 生产就绪的关键一步，建议纳入项目初始化检查清单。
