ツール
Prisma
Node.js / TypeScript 向けの ORM。schema.prisma の定義から型安全な Prisma Client を生成し、マイグレーションで DB スキーマを管理する。generate 漏れ・接続文字列・マイグレーション drift で詰まりやすい。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
Prisma 6 → 7・変更点 9 つ
Prisma ORM を 6 から 7 に上げると動かなくなること
問題一覧(5)
Prisma「Can't reach database server」の原因と直し方
P1001 Can't reach database server は、Prisma がデータベースに接続できないときに出る。DB の起動状態と接続 URL のホスト・ポートを確認すれば解消する。認証情報の誤りは P1001 ではなく P1000 になる。
更新: 2026-09-30、タグ: connection、p1001
Prisma「@prisma/client did not initialize yet」の原因と直し方
Prisma Client がまだ生成されていないと @prisma/client did not initialize yet が出る。スキーマ変更後やデプロイ時の依存インストール後に prisma generate を実行し、生成物を最新化すれば解消する。
更新: 2026-11-12、タグ: generate、client
Prisma「Environment variable not found: DATABASE_URL」の原因と直し方
Prisma が .env の DATABASE_URL を読み込めないと、Environment variable not found: DATABASE_URL で停止する。.env をプロジェクト直下に置き、datasource の url を env() で参照すれば解消する。
更新: 2026-09-30、タグ: env、database-url
Next.js の開発時に Prisma が「too many connections」で接続できない
too many connections は、PrismaClient を globalThis にキャッシュして使い回せば直る。Next.js の Fast Refresh で再評価のたびに new PrismaClient() が走り、接続が増え続けるのが原因である。
更新: 2026-11-04、タグ: connection、nextjs、hot-reload
Prisma「datasource property url is no longer supported」の原因と直し方
datasource property url is no longer supported は、url を設定ファイルへ移せば直る。Prisma 7 から、接続先は schema.prisma ではなく prisma.config.ts に書く。
更新: 2026-11-16、タグ: prisma7、datasource、prisma-config