使用Prisma ORM连接多个数据库的最佳实践

1512 字

8 分钟

使用Prisma ORM连接多个数据库的最佳实践

2025-08-25

代码人生

技术

/

前端

/

后端

一、起因#

最近在一个Next.js + tRPC + Prisma ORM + MySQL的技术栈项目中，我遇到了需要同时连接两个不同MySQL数据库进行数据读写的需求。然而，Prisma ORM默认只支持单数据库连接，官方文档对多数据库场景的解决方案并不详细。经过深入研究和实践，我总结出了一套适用于此类需求的最佳实践方案。

二、我实现的Prisma多数据库连接的原理#

2.1 单数据库的局限性#

Prisma ORM的标准配置是面向单数据库设计的：

1
datasource db {
2
  provider = "mysql"
3
  url      = env("DATABASE_URL")
4
}

这种配置无法直接扩展到多数据库场景。

2.2 多数据库的解决思路#

Prisma虽然不支持在单个schema.prisma文件中定义多个datasource块来连接多个数据库，但我们可以通过以下方式实现：

创建多个独立的Schema文件： 每个数据库对应一个schema文件
生成独立的客户端： 为每个数据库生成专用的Prisma Client
统一管理连接实例： 在应用层统一管理多个数据库连接

三、完整实现方案#

3.1 项目结构：#

首先，我们需要合理规划项目结构，将多个配置文件有序组织：

1
project-root
2
 ├── next.config.js
3
 ├── package.json
4
 ├── /prisma                   // Prisma ORM配置目录
5
 │   ├── /prisma-client        // 自定义的Prisma客户端代码目录
6
 │   │   ├── /db1Client        // 数据库1的客户端
7
 │   │   └── /db2Client        // 数据库2的客户端
8
 │   ├── schema1.prisma        // 第一个数据库的Schema文件
9
 │   └── schema2.prisma        // 第二个数据库的Schema文件
10
 ├── /public
11
 │   ├── assets
12
 │   └── favicon.ico
13
 ├── /src
14
 │   ├── /app
15
 │   ├── /server               // 服务端代码目录
16
 │   │   ├── /api
17
 │   │   └── db.ts             // Prisma ORM数据库连接配置文件
18
 │   ├── /trpc
19
 │   └── env.js
20
 └── tsconfig.json

3.2 配置多个Schema文件和生成客户端#

我们在/prisma目录下创建两个schema.prisma文件，分别命名为schema.prisma和schema2.prisma，分别配置不同的数据库连接。同时在/prisma/prisma-client目录下创建了两个子目录db1Client和db2Client，用于存放生成的Prisma客户端代码。

配置不同的数据库连接： 在schema1.prisma中配置第一个数据库连接：

1
datasource db1 {
2
  provider = "mysql"
3
  url      = env("DATABASE_URL_1")
4
}
5

6
generator client {
7
  provider = "prisma-client-js"
8
  // 自定义客户端代码输出目录
9
  output   = "./prisma-client/db1Client"
10
}
11

12
// 在此处定义第一个数据库的模型...

在schema2.prisma中配置第二个数据库连接：

1
datasource db2 {
2
  provider = "mysql"
3
  url      = env("DATABASE_URL_2")
4
}
5

6
generator client {
7
  provider = "prisma-client-js"
8
  // 自定义客户端代码输出目录
9
  output   = "./prisma-client/db2Client"
10
}
11

12
// 在此处定义第二个数据库的模型...

注意：我们在每个schema.prisma文件中都自定义了一个Prisma客户端代码输出目录为 /prisma/prisma-client/，以便我们再后续修改Prisma数据库连接配置文件时使用。

关键配置说明：

每个schema使用不同的数据源名称（db1、db2）
通过output字段将客户端代码生成到不同目录（默认情况下Prisma会将操作数据库的客户端代码生成在/node_modules文件夹下的模块自有目录内并在后续的配置文件中将客户端代码隐式引用，因此我们需要自定义output字段）
使用不同的环境变量来配置数据库连接字符串

3.3 创建统一的数据库连接管理器#

修改Prisma ORM的数据库连接配置文件：

在/src/server/db.ts中创建和管理多个数据库连接：

1
// 导入上一步中自定义目录中生成的Prisma客户端
2
import { PrismaClient as DB1Client } from "../../prisma/prisma-client/db1Client";
3
import { PrismaClient as DB2Client } from "../../prisma/prisma-client/db2Client";
4

5
import { env } from "~/env";
6

7
// 第一个数据库的客户端工厂函数
8
const createPrismaClient = () => {
9
  return new DB1Client({
10
    log: env.NODE_ENV === "development" ? ["query", "error", "warn"] : ["error"],
11
  });
12
};
13

14
// 第二个数据库的客户端工厂函数
15
const createPrismaClient2 = () => {
16
  return new DB2Client({
17
    log: env.NODE_ENV === "development" ? ["query", "error", "warn"] : ["error"],
18
  });
19
};
20

21
// 开发环境下的全局实例管理，避免热重载时重复创建连接
22
const globalForPrisma = globalThis as unknown as {
23
  prisma: ReturnType<typeof createPrismaClient> | undefined;
24
};
25

26
const globalForPrisma2 = globalThis as unknown as {
27
  prisma2: ReturnType<typeof createPrismaClient2> | undefined;
28
};
29

30
// 导出数据库连接实例
31
export const db = globalForPrisma.prisma ?? createPrismaClient();
32
export const db2 = globalForPrisma2.prisma2 ?? createPrismaClient2();
33

34
// 在非生产环境下缓存实例
35
if (env.NODE_ENV !== "production") {
36
  globalForPrisma.prisma = db;
37
  globalForPrisma2.prisma2 = db2;
38
}

3.4 更新NPM Scripts#

修改package.json中的Prisma相关命令，添加对多数据库的支持：：

我们需要修改原来对prisma迁移的命令，在原有执行 prisma migrate dev 命令之后加入参数--schema=./prisma/schema2.prisma来显式声明这是对db2数据库的操作

1
{
2
  "scripts": {
3
    // 第一个数据库的操作命令
4
    "db:migrate-dev": "dotenv -e .env.development.local -- prisma migrate dev",
5
    "db:migrate": "dotenv -e .env.production.local -- prisma migrate deploy",
6
    "db:push": "prisma db push",
7
    "db:studio": "prisma studio",
8

9
    // 第二个数据库的操作命令
10
    "db2:migrate-dev": "dotenv -e .env.development.local -- prisma migrate dev --schema=./prisma/schema2.prisma",
11
    "db2:migrate": "dotenv -e .env.production.local -- prisma migrate deploy --schema=./prisma/schema2.prisma",
12
    "db2:push": "prisma db push --schema=./prisma/schema2.prisma",
13
    "db2:studio": "prisma studio --schema=./prisma/schema2.prisma"
14
  }
15
}

命令说明：

通过--schema参数指定特定的schema文件
为不同数据库的命令添加前缀区分（如db2:）
保持命令的一致性和可预测性

在执行这些命令时，确保相应的环境变量（DATABASE_URL_1和DATABASE_URL_2）已正确配置。

在分别执行完两个数据库的迁移命令后，我们就可以在/prisma/prisma-client/db1Client和/prisma/prisma-client/db2Client目录下看到生成的Prisma客户端代码。此时，我们就完成了多数据库连接的配置。

四、使用示例#

在应用代码中，我们可以通过导入db和db2来分别操作两个数据库：

1
import { db, db2 } from "~/server/db";
2

3
// 使用第一个数据库
4
const user = await db.user.findMany();
5

6
// 使用第二个数据库
7
const orders = await db2.order.findMany();