跳转到主要内容

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

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

在开发中使用 Prisma 客户端的最佳实践​

避免多个 Prisma 客户端实例​

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

发生这种情况的原因​

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

为了避免这种情况，请通过使用全局变量创建一个 Prisma 客户端实例

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

const globalForPrisma = global as unknown as { prisma: PrismaClient };

export const prisma =
  globalForPrisma.prisma || new PrismaClient();

if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = prisma;

使用这种方法可以确保即使在开发过程中进行热重载，也只有一个 Prisma 客户端实例存在。

在单体仓库中设置 Prisma ORM​

在单体仓库中使用 Prisma ORM 的挑战​

单体仓库允许多个项目共享代码和依赖项，使其成为现代开发的流行选择。但是，在单体仓库中使用 Prisma ORM 可能会带来与依赖项解析和模式管理相关的挑战。

主要问题​

  1. 依赖项解析：如果单体仓库中的多个包使用不同版本的 Prisma ORM，可能会导致冲突。
  2. 模式集中化：跨多个项目管理单个 Prisma 模式可能很复杂。

单体仓库集成的最佳实践​

  • 集中 Prisma 模式：将 schema.prisma 文件放置在共享包中，例如 @myorg/db，以确保一致性。
  • 在根目录中安装依赖项：通过在单体仓库的根目录中安装 Prisma ORM 作为依赖项来避免版本冲突。
  • 使用 NPM 脚本进行生成:
{
  "scripts": {
    "prisma:generate": "prisma generate --schema=./packages/db/schema.prisma"
  }
}

这种方法可以使您的 Prisma 模式和生成的客户端在单体仓库的所有项目中保持同步。

在 Next.js 中动态使用 Prisma 客户端​

处理动态场景​

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

问题​

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

解决方案​

使用工厂函数基于特定于租户的配置动态创建 Prisma 客户端

// 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 客户端的生命周期，以避免资源耗尽。