prisma-mongodb-upgrade

原文：🇺🇸 英文

已翻译

针对无法升级到v7的Prisma ORM MongoDB v6项目的决策与迁移指南。适用于MongoDB项目询问Prisma升级事宜、使用provider = "mongodb"的项目中提及"升级到Prisma 7"，或是评估迁移至Prisma Next的场景。触发关键词包括"upgrade prisma mongodb"、"prisma 7 mongodb"、"mongodb prisma migration"、"prisma next mongodb"。

328.4k次下载

来源prisma/skills

添加于2026-07-11

NPX安装

npx skill4agent add prisma/skills prisma-mongodb-upgrade

SKILL.md 内容（中文）

查看翻译对照 →

Prisma MongoDB 升级路径

MongoDB项目是唯一无法升级到Prisma 7的Prisma用户群体：v6是面向MongoDB的经典ORM最终大版本，v7从未推出MongoDB连接器。后续路径是Prisma Next，其中MongoDB支持处于Early Access（早期访问）阶段，计划在Postgres之后正式发布（GA）。本指南明确了核心决策——迁移至Prisma Next（推荐路径），或是在存在硬性阻碍时停留在v6，并介绍了迁移机制。

绝对不要做以下两件事：

切勿建议MongoDB项目“升级到Prisma 7”。该版本中不存在MongoDB连接器，
```
prisma-upgrade-v7
```
指南不适用于MongoDB项目。
切勿通过将应用重写为SQL数据库来解决版本问题。更换数据库引擎是一个独立且规模大得多的决策，不应由你擅自决定。

版本现状

版本	MongoDB状态
Prisma ORM v6	完全支持（ `mongodb` provider）；最新6.x版本为当前稳定路径；处于维护阶段
Prisma ORM v7	无MongoDB连接器——永远不可选
Prisma Next	MongoDB支持处于Early Access阶段，正在积极开发中，计划在Postgres之后正式发布（GA）——是MongoDB项目的后续路径

核心决策前置说明

迁移至Prisma Next是推荐路径。Prisma Next中的MongoDB支持处于Early Access阶段：功能可用且迭代迅速，计划在Postgres之后正式发布（GA）——Prisma团队希望MongoDB用户尽早迁移并反馈意见。迁移机制详情见参考文件。

在存在硬性阻碍时，停留在最新v6版本仍是合理选择——明确来说：Next的Mongo封装目前尚不支持事务（底层驱动可直接使用；预计此情况很快会改变），且1.0之前的小版本可能包含破坏性变更，并会发布对应的升级方案。

决策表

信号	方向
不存在以下阻碍	迁移至Next；执行 `verify-cutover-checklist` 并向Prisma团队反馈意见
新项目/原型/内部工具	迁移至Next
代码库使用多文档事务（ `$transaction` ）——需通过grep检查，不要询问	先规划原生驱动会话的替代方案（见 `client-api-mapping` ），或停留在v6直到封装支持事务
团队无法承受1.0之前小版本间的破坏性升级	停留在v6直到正式发布（GA）
风险厌恶但有迁移意向	在副本上执行分阶段Next往返测试（见 `verify-cutover-checklist` ），然后再迁移

注意：事务缺口预计很快会填补——当Prisma Next的封装事务合并后，本节内容将更新。

若停留在v6：维护规范（主动选择，而非忽视）

将Prisma包固定在最新6.x版本系列，并持续安装6.x补丁版本。
关注Prisma 6.x版本系列的发布说明和安全公告。
保留经典v6 MongoDB配置：schema中设置
```
url = env("DATABASE_URL")
```
，使用
```
db push
```
工作流，不使用SQL驱动适配器（v6 MongoDB配置详情见
```
prisma-database-setup
```
）。
当Prisma Next的MongoDB支持正式发布（GA），或是尝试Early Access的阻碍消除时，重新评估迁移方案。

参考文件

参考文件	涵盖内容
`references/decision-stay-or-migrate.md`	完整的决策框架、阻碍检查及停留在v6的维护细节
`references/schema-contract-mapping.md`	v6 schema（ `mongodb` provider、 `@db.ObjectId` 、复合类型）→ Next契约概念的映射
`references/client-api-mapping.md`	v6客户端调用→ Next等效方法的映射，包括原生逃逸舱和事务——名称对应，但功能一致性不对应
`references/migrations-mapping.md`	v6仅 `db push` 的流程→ Next的plan/migrate/verify/sign流程的映射
`references/verify-cutover-checklist.md`	无数据迁移验证：相同数据库、索引一致性、切换前的分阶段往返测试

验证依据

本指南中关于Prisma Next的行为声明已针对prisma/prisma-next的提交

a2791c5dd59d579b4b3052942ae7f8fe5e2ee852

（1.0之前，约v0.14/0.15版本系列）进行验证。Prisma Next在Early Access阶段迭代迅速：在依据Next相关声明采取行动前，请针对实际安装的版本进行验证（检查项目的

@prisma-next/*

版本及安装的prisma-next技能）。Next的Mongo目标要求MongoDB 8.0+，并期望用户提供

mongodb@^7

作为peer依赖。

交接规则

本指南是发现阶段的桥梁，不能替代Prisma Next自身的文档。项目切换到Prisma Next后，运行Prisma Next的

init

/技能安装，并遵循其自身的技能（快速入门、契约、查询、迁移、运行时）进行日常工作——不要继续依赖本指南的摘要内容。