Prisma エラー: 環境変数が見つかりません: DATABASE_URL

Prisma の「環境変数が見つかりません: DATABASE_URL」エラーの解決

Prisma を使用している場合、.env ファイルで変数が明確に定義されている場合でも、「環境変数が見つかりません: DATABASE_URL」というイライラするエラーが発生することがあります。このエラーは通常、schema.prisma ファイルと環境変数の間の切断を示し、Prisma がデータベース接続の詳細にアクセスできなくなります。

---

ステップ 1: .env ファイルを確認する

最初のステップは、DATABASE_URL 変数が正しく定義されていることを確認することです。ルート ディレクトリで .env ファイルを開き、次のことを確認します。

1. 存在: DATABASE_URL 変数が存在することを確認します。
2. 正しい値: 接続文字列が正しく、次の形式であることを確認します。

   DATABASE_URL="mydatabaseurlstring"

---

エラーを理解する

DATABASE_URL が正しく定義されているにもかかわらずエラーが続く場合、Prisma はそれにアクセスできない可能性があります。 Prisma Client は、設定のために schema.prisma ファイルに依存します。このファイルは、env() 関数を使用して環境変数を通じて接続 URL を取得します。 Prisma がクライアント生成プロセス中に DATABASE_URL を見つけることができない場合、「環境変数が見つかりません」エラーがトリガーされます。

---

解決策: npx prisma 生成

プロジェクトのルート ディレクトリで次のコマンドを実行します:

npx prisma generate

このコマンドは Prisma クライアントを再生成し、Prisma が .env ファイル内の環境変数を再読み取り、生成されたクライアント コードにそれらを組み込むことができるようにします。

これが機能する理由

このコマンドは、Prisma クライアントを再生成することで、Prisma がスキーマを最新の状態にし、DATABASE_URL などの環境変数にアクセスできるようにします。

---

追加のケース シナリオ

1. Next.js

で Prisma Studio を実行する

環境変数が .env.local に保存されている Next.js を使用したプロジェクトでは、Prisma コマンドを実行する前に環境変数を明示的にロードします。

   npm install -g dotenv-cli
   dotenv -e .env.local -- npx prisma studio

---

2. Next.js の .env と .env.local

Next.js では、.env.local の名前を .env に変更すると、Prisma アクセスの問題が解決される場合があります。 Prisma は多くの場合、デフォルトで .env から変数を読み取るため、このファイルに標準化することで互換性の問題を防ぐことができます。

3. Vercel と Vercel Postgres の使用

Vercel を使用していて、vercel pull で環境変数を .env.development.local にプルした場合は、Prisma が主にこのファイルから読み取るように、環境変数を .env にコピーします。

   cp .env.development.local .env

次に、次のような Prisma コマンドを実行してみます。

   npx prisma db pull
   npx prisma generate
   npx prisma migrate

4. PrismaClient インポート構文

次のようなインポートで @prisma/client/edge を使用している場合:

   DATABASE_URL="mydatabaseurlstring"

次のように切り替えます:

npx prisma generate

エッジ バージョンではなく @prisma/client を使用すると、Prisma の環境変数処理の不一致を解決できます。

---

今後の問題の防止

1. サーバーを再起動します: .env の変更後にサーバーを再起動すると、新しい変数が確実に読み込まれます。
2. dotenv を使用して変数をロードする: dotenv をインストールして、環境変数を効果的に管理します。

   npm install -g dotenv-cli
   dotenv -e .env.local -- npx prisma studio

アプリのエントリ ポイント (例: src/hooks.server.js) にロードします:

   cp .env.development.local .env

1. パスとスペルを再確認します: .env ファイルが正しい場所にあり、変数名のスペルが一貫していることを確認してください。

---

ハッピーハッキング

追記: .env ファイルの管理の詳細については、Prisma の公式ドキュメントへのリンクを参照してください。

以上がPrisma エラー: 環境変数が見つかりません: DATABASE_URLの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。