系统要求
此页面提供了 Prisma ORM 系统要求的概述。
系统要求
本节列出了 Prisma ORM 所需的软件和支持的操作系统,以及特定操作系统的运行时依赖项要求。
软件要求
最新版本的 Prisma ORM 需要以下软件
工具 | 最低要求版本 |
---|---|
Node.js | 18.8 / 20.9 / 22.11 |
TypeScript(可选) | 5.1.X |
Yarn(可选) | 1.19.2 |
- Prisma ORM 支持并测试所有活跃 LTS 和维护 LTS Node.js 版本。不在这些状态下的版本(如当前版本,以及奇数版本) 也可能有效,但不建议用于生产环境。
- TypeScript 仅适用于 TypeScript 用户。
- 使用Yarn 1时,
1.19.2
是与 Prisma Client 兼容的最低版本。
另请参阅:支持的数据库版本
展开以查看早期版本
操作系统
Prisma ORM 在 macOS、Windows 和大多数 Linux 发行版上受支持。
Linux 运行时依赖项
Prisma ORM 需要安装以下系统库才能工作
- OpenSSL 1.0.x、1.1.x 或 3.x
- zlib(
libz.so.1
) - libgcc(
libgcc_s.so.1
) - C 标准库(大多数 Linux 发行版上的 glibc 或 Alpine Linux 上的 musl libc)
以下两个表格显示了每个 CPU 架构的支持的 Linux 发行版系列、OpenSSL 版本和 C 标准库。
在AMD64
(x86_64
)架构上
发行版系列 | OpenSSL 版本 | libc 版本 |
---|---|---|
Alpine | 1.1.x、3.x | musl 1.2.x |
RHEL | 1.0.x、1.1.x、3.x | glibc 2.17+ |
Debian 或其他 | 1.0.x | glibc 2.19+ |
Debian 或其他 | 1.1.x、3.x | glibc 2.24+ |
在ARM64
(aarch64
)架构上
发行版系列 | OpenSSL 版本 | libc 版本 |
---|---|---|
Alpine | 1.1.x、3.x | musl 1.2.x |
RHEL | 1.0.x、1.1.x、3.x | glibc 2.24+ |
Debian 或其他 | 1.0.x、1.1.x、3.x | glibc 2.24+ |
当 Prisma ORM 无法解析系统上的 OpenSSL 版本(例如,因为它未安装)时,它将默认为 OpenSSL 1.1.x。
可以运行支持的 Node.js 版本的系统很可能已安装 zlib 和 libgcc。一个值得注意的例外是 Google 的 Distroless 镜像,其中需要从兼容的 Debian 系统复制libz.so.1
。
Windows 运行时依赖项
在 Windows 上,必须安装Microsoft Visual C++ Redistributable 2015 或更高版本(在大多数现代安装中默认情况下就是这样)。
macOS 运行时依赖项
Prisma ORM 支持 macOS 10.15 或更高版本。除了软件要求部分中列出的所有平台外,macOS 上没有其他特定于平台的要求。
故障排除
使用过时的系统要求版本会导致一些常见问题
无法使用@prisma/client
构建 TypeScript 项目
问题
在运行prisma generate
后尝试对项目进行类型检查时,您会看到以下错误。
./node_modules/.prisma/client/index.d.ts:10:33
Type error: Type expected.
8 | export type PrismaPromise<A> = Promise<A> & {[prisma]: true}
9 | type UnwrapTuple<Tuple extends readonly unknown[]> = {
> 10 | [K in keyof Tuple]: K extends `${number}` ? Tuple[K] extends PrismaPromise<infer X> ? X : never : never
| ^
11 | };
12 |
13 |
解决方案
将项目中的 TypeScript 依赖项升级到Prisma ORM 支持的版本。npm install -D typescript
。
无法使用groupBy
预览功能
问题
当您尝试运行使用groupBy
预览功能的应用程序时,您会看到以下控制台错误
server.ts:6:25 - error TS2615: Type of property 'OR' circularly references itself in mapped type '{ [K in keyof { AND?: Enumerable<ProductScalarWhereWithAggregatesInput>; OR?: Enumerable<ProductScalarWhereWithAggregatesInput>; ... 4 more ...; category?: string | StringWithAggregatesFilter; }]: Or<...> extends 1 ? { ...; }[K] extends infer TK ? GetHavingFields<...> : never : {} extends FieldPaths<...> ? never : K...'.
6 const grouped = await prisma.product.groupBy({
~~~~~~~~~~~~~~~~~~~~~~~~
7 by: ['category']
~~~~~~~~~~~~~~~~~~~~
8 });
~~~~
server.ts:6:48 - error TS2554: Expected 0 arguments, but got 1.
6 const grouped = await prisma.product.groupBy({
~
7 by: ['category']
~~~~~~~~~~~~~~~~~~~~
8 });
~~~
解决方案
将项目中的 TypeScript 依赖项升级到Prisma ORM 支持的版本。npm install -D typescript
。