Ruta de actualización de Prisma para MongoDB
Los proyectos de MongoDB son la única cohorte de Prisma sin camino hacia Prisma 7: v6 es la versión mayor terminal del ORM clásico para MongoDB, y v7 nunca incluye un conector MongoDB. La ruta sucesora es Prisma Next, donde el soporte para MongoDB está en Acceso Anticipado con disponibilidad general planeada después de Postgres. Este skill enmarca la decisión real — migrar a Prisma Next (la ruta recomendada), o permanecer en v6 donde se aplica un bloqueador duro — y detalla la mecánica de la migración.
Nunca hagas esto:
- Nunca aconsejes a un proyecto de MongoDB que "actualice a Prisma 7". El conector no existe
allí. La guía
prisma-upgrade-v7no aplica a proyectos de MongoDB. - Nunca resuelvas el problema de versión reescribiendo la aplicación en una base de datos SQL. Cambiar el motor de base de datos es una decisión aparte y mucho más grande que no te corresponde tomar implícitamente.
El panorama de versiones
| Versión | Estado de MongoDB |
|---|---|
| Prisma ORM v6 | Totalmente compatible (provider = mongodb); la última 6.x es la ruta estable actual; línea de mantenimiento |
| Prisma ORM v7 | Sin conector MongoDB — no es una opción, nunca |
| Prisma Next | Soporte para MongoDB en Acceso Anticipado, en desarrollo activo, disponibilidad general planeada después de Postgres — la ruta sucesora para proyectos MongoDB |
La decisión, de antemano
Migrar a Prisma Next es la ruta recomendada. El soporte para MongoDB en Prisma Next está en Acceso Anticipado: funcional y evolucionando rápidamente, con disponibilidad general planeada después de Postgres — y el equipo de Prisma quiere que los usuarios de MongoDB migren temprano y compartan comentarios. La mecánica de la migración se detalla en las referencias.
Permanecer en la última v6 sigue siendo una opción legítima cuando se aplica un bloqueador duro — dicho claramente: la fachada de Next Mongo todavía no envuelve transacciones (el controlador subyacente está disponible directamente; se espera que esto cambie pronto), y las versiones menores previas a 1.0 pueden traer cambios disruptivos con recetas de actualización publicadas.
Tabla de decisión
| Señal | Dirección |
|---|---|
| No aplica ninguno de los bloqueadores siguientes | Migrar a Next; ejecutar el verify-cutover-checklist y compartir comentarios con el equipo de Prisma |
| Proyecto nuevo / prototipo / herramienta interna | Migrar a Next |
El código base usa transacciones multidocumento ($transaction) — verificar con grep, no preguntar | Planificar primero equivalentes de sesión con controlador directo (ver client-api-mapping), o permanecer en v6 hasta que la envoltura de la fachada esté disponible |
| El equipo no puede absorber actualizaciones disruptivas previas a 1.0 entre versiones menores | Permanecer en v6 hasta la disponibilidad general |
| Averso al riesgo pero interesado | Ejecutar una prueba de ida y vuelta escalonada de Next en una copia (ver verify-cutover-checklist), luego migrar |
Nota: se espera que la brecha de transacciones se cierre pronto — esta sección se actualizará cuando las transacciones de fachada se fusionen en Prisma Next.
Si se permanece en v6: higiene (una permanencia deliberada, no abandono)
- Fijar los paquetes Prisma a la última línea 6.x y seguir tomando versiones de parche 6.x.
- Seguir las notas de versión de Prisma y los avisos de seguridad para la línea 6.x.
- Mantener la configuración clásica de MongoDB v6:
url = env("DATABASE_URL")en el esquema, flujo de trabajodb push, sin adaptadores de controlador SQL (verprisma-database-setuppara la forma de MongoDB v6). - Reevaluar cuando MongoDB de Prisma Next esté en disponibilidad general, o cuando los bloqueadores para probar el Acceso Anticipado se resuelvan.
Archivos de referencia
| Referencia | Qué cubre |
|---|---|
references/decision-stay-or-migrate.md | El marco completo de decisión, comprobaciones de bloqueadores y detalle de higiene de permanencia |
references/schema-contract-mapping.md | Esquema v6 (proveedor mongodb, @db.ObjectId, tipos compuestos) → conceptos de contrato de Next |
references/client-api-mapping.md | Llamadas al cliente v6 → equivalentes de Next, incluyendo escapes directos y transacciones — los nombres se corresponden, la paridad no |
references/migrations-mapping.md | Historia de solo db push en v6 → flujo de planificar/migrar/verificar/firmar de Next |
references/verify-cutover-checklist.md | Verificación sin movimiento de datos: misma base de datos, paridad de índices, prueba de ida y vuelta escalonada antes del cambio |
Verificado contra
Las afirmaciones de comportamiento sobre Prisma Next en este skill fueron verificadas contra
prisma/prisma-next en el commit
a2791c5dd59d579b4b3052942ae7f8fe5e2ee852 (pre-1.0, línea ~v0.14/0.15). Prisma Next avanza
rápidamente en Acceso Anticipado: antes de actuar sobre cualquier afirmación de Next, verifícala contra
la versión realmente instalada (revisa las versiones de @prisma-next/* del proyecto y los
skills de prisma-next instalados con él). El destino Mongo de Next requiere MongoDB 8.0+ y espera
mongodb@^7 como una dependencia par proporcionada por el usuario.
Regla de transferencia
Este skill es el puente de descubrimiento, no un reemplazo de la documentación propia de Prisma Next.
Después de que un proyecto cambie a Prisma Next, ejecuta la instalación de init/skill de Prisma Next
y sigue sus propios skills (inicio rápido, contrato, consultas, migraciones, tiempo de ejecución)
para el trabajo diario — no sigas trabajando desde los resúmenes de este skill.