ReactJS プロジェクトの Vercel デプロイメントでの Prisma エラー 500 の解決

安定したデータベース接続のための Vercel での Prisma 展開の最適化

エラー処理とモジュール性の向上に Prisma を使用したバックエンド スクリプト

import { db } from "@/lib/db";
import { Prisma } from "@prisma/client";
import { NextResponse } from "next/server";
export async function POST(req: Request) {
    try {
        const { email } = await req.json();
        const contact = await db.contact.create({
            data: { email }
        });
        return NextResponse.json(contact);
    } catch (error) {
        if (error instanceof Prisma.PrismaClientKnownRequestError) {
            console.log("[CONTACT]", "Email already exists");
            return NextResponse.json({ message: "Email already exists" }, { status: 520 });
        } else {
            console.log("[CONTACT]", error);
            return NextResponse.json({ message: "Server error" }, { status: 500 });
        }
    }
}

Prisma によるバックエンド構成と最適化されたデータベース接続管理

運用環境を意識した設定を使用したデータベース接続スクリプト

import { PrismaClient } from "@prisma/client";
declare global {
    var prisma: PrismaClient | undefined;
};
export const db = globalThis.prisma || new PrismaClient();
if (process.env.NODE_ENV !== "production") globalThis.prisma = db;

Prisma での CockroachDB のスキーマ設定

CockroachDB 統合用の Prisma スキーマ ファイル

generator client {
    provider = "prisma-client-js"
}
datasource db {
    provider      = "cockroachdb"
    url           = env("DATABASE_URL")
    relationMode  = "prisma"
}
model Contact {
    email         String  @id @unique
    creation      DateTime @default(now())
}

データベース接続と API ルートの単体テストの追加

データベース関数と API ルートの Jest 単体テストの例

import { db } from "@/lib/db";
import { POST } from "@/pages/api/contact";
import { NextResponse } from "next/server";
describe("POST /api/contact", () => {
    it("should create a new contact and return the data", async () => {
        const request = new Request("http://localhost/api/contact", {
            method: "POST",
            body: JSON.stringify({ email: "test@example.com" }),
        });
        const response = await POST(request);
        const data = await response.json();
        expect(data.email).toBe("test@example.com");
    });
    it("should handle known Prisma errors (e.g., duplicate email)", async () => {
        const request = new Request("http://localhost/api/contact", {
            method: "POST",
            body: JSON.stringify({ email: "duplicate@example.com" }),
        });
        const response = await POST(request);
        expect(response.status).toBe(520);
    });
});

Vercel を使用した Prisma の導入に関するよくある質問

1. 複数の Prisma クライアントの初期化を回避するにはどうすればよいですか?
2. 複数の初期化を防ぐには、次を使用します。 globalThis 非実稼働環境で単一の Prisma インスタンスを設定します。これにより、開発時のメモリ リークが軽減されます。
3. Prisma が Vercel では失敗するのに、ローカルでは機能するのはなぜですか?
4. これは、次の場合によく発生します。 DATABASE_URL Vercel の環境変数が欠落しているか、正しく設定されていません。 Vercel 環境がローカル設定と一致するように構成されていることを確認してください。
5. プリズマの目的は何ですか @id 属性？
6. の @id Prisma スキーマの属性は、一意の主キーを定義します。これは、連絡先リスト内のユーザーの電子メールなど、一意のレコードを識別するために不可欠です。
7. 重複などの特定の Prisma エラーを捕捉するにはどうすればよいですか?
8. 使用する PrismaClientKnownRequestError catch ブロック内で使用すると、一意制約違反などの既知のエラーを処理し、わかりやすいエラー メッセージを表示できます。
9. どのようにして next/server 応答処理を改善しますか?
10. 使用する NextResponse.json() から next/server は、カスタム HTTP ステータスを含む、Next.js API ルートで JSON データを返す簡単な方法を提供します。
11. どういうことですか await req.json() APIルートで行うのか？
12. このコマンドは、受信リクエストの JSON 本文を解析し、ルート ハンドラー内のユーザー入力などのデータに簡単にアクセスできるようにします。
13. どのようにして globalThis.prisma メモリの問題に役立ちますか？
14. 初期化することで globalThis.prisma 開発では、複数の Prisma クライアントを避ける必要があります。これにより、メモリ使用率が高くなり、Vercel でクラッシュが発生する可能性があります。
15. 役割は何ですか @default(now()) プリズマモデルでは？
16. の @default(now()) 属性は、フィールドのデフォルトのタイムスタンプを設定します。これは、ログやユーザー アクティビティなどのレコードの作成時間を追跡するのに役立ちます。
17. Prisma で CockroachDB を使用する理由は何ですか?
18. CockroachDB は Prisma と互換性があり、強力な一貫性とスケーラビリティを提供し、Vercel の実稼働環境に最適です。
19. 導入前に Prisma API をテストするにはどうすればよいですか?
20. Jest などのツールは、開発中の Prisma 関数を検証し、API が期待どおりに動作し、エラーを効果的に処理することを保証します。

Prisma と Vercel をスムーズに統合するための主要な手順

Prisma を Vercel に導入すると隠れた問題が明らかになる可能性がありますが、これらは適切な構成で克服できます。環境のセットアップとクライアントのインスタンス化のベスト プラクティスに従うと、展開がより安定し、ユーザーのアクションに応答できるようになります。

API ルートに構造化されたエラー処理を実装し、環境固有のテストを実行することで、信頼性がさらに向上します。これらの戦略を使用すると、予期しないエラーが発生することが少なくなり、アプリケーションは開発環境と運用環境の両方でスムーズに実行されます。 🚀