Migrer vers Prisma 7 : tout ce qui change (et casse)

Pourquoi Prisma 7 casse tout

Prisma 7 est la plus grosse mise à jour depuis la v1. Le changement principal : les driver adapters deviennent obligatoires. Fini le new PrismaClient() tout nu, il faut maintenant passer explicitement un adapter de connexion.

Les 3 changements critiques

1. Driver adapters obligatoires

// ❌ Avant (Prisma 6)
const prisma = new PrismaClient()

// ✅ Après (Prisma 7)
import { PrismaPg } from "@prisma/adapter-pg"
const adapter = new PrismaPg({ connectionString: process.env.DATABASE_URL })
const prisma = new PrismaClient({ adapter })

2. Plus de URL dans schema.prisma

La propriété url disparaît du datasource. La connexion se configure dans un nouveau fichier prisma.config.ts :

// prisma.config.ts
import { defineConfig } from "prisma/config"
export default defineConfig({
  schema: "prisma/schema.prisma",
  datasource: { url: process.env.DATABASE_URL },
})

3. Nouveaux packages nécessaires

pnpm add @prisma/adapter-pg pg
pnpm add -D @types/pg

Migration pas à pas

1. Installer les packages adapter
2. Créer prisma.config.ts
3. Supprimer url du schema.prisma
4. Mettre à jour le singleton PrismaClient dans src/lib/db.ts
5. Mettre à jour le seed script
6. Tester : npx prisma db push puis pnpm build

Piège courant avec Next.js

Le pattern singleton change aussi. L'adapter doit être créé à l'intérieur de la factory function pour éviter les problèmes de hot reload en dev :

const createPrismaClient = () => {
  const adapter = new PrismaPg({ connectionString })
  return new PrismaClient({ adapter })
}
const globalForPrisma = globalThis as unknown as {
  prisma: ReturnType<typeof createPrismaClient> | undefined
}
export const prisma = globalForPrisma.prisma ?? createPrismaClient()
if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma

Verdict

La migration prend 15-30 minutes. Le plus dur n'est pas le code, c'est de comprendre pourquoi ça casse. Les driver adapters permettent un meilleur contrôle de la connexion, notamment pour les edge runtimes et les serverless platforms comme Neon ou PlanetScale.