Prisma ORM 与 Next.js 使用综合指南

Prisma ORM 和 Next.js 结合使用，为构建现代化的、服务器端渲染的和 API 驱动的 Web 应用程序提供了强大的组合。本指南整合了各种技巧和策略，以帮助您最大限度地发挥它们的潜力。无论您是在寻找最佳实践、Monorepo 设置指南还是动态使用策略，我们都能满足您的需求。

在开发中使用 Prisma Client 的最佳实践

避免多个 Prisma Client 实例

在开发 Next.js 应用程序时，一个常见的问题是意外地创建了多个 Prisma Client 实例。这通常是由于 Next.js 在开发中的热重载功能造成的。

为什么会发生这种情况

Next.js 的热重载功能频繁地重新加载模块，以立即反映代码更改。然而，这可能导致创建多个 Prisma Client 实例，从而消耗资源并可能导致意外行为。

在 Monorepo 中设置 Prisma ORM

在 Monorepo 中使用 Prisma ORM 的挑战

Monorepo 允许多个项目共享代码和依赖项，使其成为现代开发的热门选择。然而，在 Monorepo 中使用 Prisma ORM 可能会带来与依赖项解析和 Schema 管理相关的挑战。

主要问题

依赖项解析：如果 Monorepo 中的多个包使用不同版本的 Prisma ORM，则可能导致冲突。
Schema 中心化：跨多个项目管理单个 Prisma Schema 可能会很复杂。

Monorepo 集成的最佳实践

中心化 Prisma Schema：将 schema.prisma 文件放在一个共享包中，例如 @myorg/db，以确保一致性。
为生成的客户端使用自定义输出目录：为生成的 Prisma Client 定义一个自定义输出目录，以保持跨包的一致性。
在根目录安装依赖项：为了防止版本冲突，请在 Monorepo 的根目录安装 Prisma ORM。如果各个包需要直接访问 Prisma（例如，用于本地客户端生成），也在这些包中安装它。您可以使用像 Turborepo 这样的 Monorepo 工具，遵循其最佳实践，或者采用类似的策略来保持应用程序中依赖项的同步。

使用 NPM 脚本进行生成:

  {
    "scripts": {
      "prisma:generate": "prisma generate --schema=./packages/db/schema.prisma"
    }
  }

这种方法可以使您的 Prisma Schema 和生成的客户端在 Monorepo 中的所有项目中保持同步。

在 Next.js 中动态使用 Prisma Client

处理动态场景

动态用例，例如使用租户特定的数据库，在使用 Prisma ORM 和 Next.js 时需要额外考虑。

问题

每个租户可能都有自己的数据库，因此需要在运行时创建单独的 Prisma Client。由于 Next.js 的混合渲染模型，这在 Next.js 中可能很复杂。

解决方案

使用工厂函数根据租户特定的配置动态创建 Prisma Client

// lib/prismaDynamic.ts
import { PrismaClient } from "@prisma/client";

type TenantConfig = {
  databaseUrl: string;
};

export function createPrismaClient(config: TenantConfig): PrismaClient {
  return new PrismaClient({
    datasources: {
      db: {
        url: config.databaseUrl,
      },
    },
  });
}

确保您管理动态创建的 Prisma Client 的生命周期，以避免资源耗尽。

在开发中使用 Prisma Client 的最佳实践​

避免多个 Prisma Client 实例​

为什么会发生这种情况​

推荐的解决方案​

在 Monorepo 中设置 Prisma ORM​

在 Monorepo 中使用 Prisma ORM 的挑战​

主要问题​

Monorepo 集成的最佳实践​

在 Next.js 中动态使用 Prisma Client​

处理动态场景​

问题​

解决方案​