Prisma Studio启动报错求助：Segmentation fault (core dumped)

每次执行npx prisma studio时，命令行提示Prisma Studio已启动在http://localhost:5555，但随即抛出Segmentation fault (core dumped)错误。重新安装或更新Prisma后首次运行可正常启动，但关闭项目后再次执行该命令，错误会重复出现。

错误日志 #

❯ npx prisma studio
Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Prisma Studio is up on http://localhost:5555
Segmentation fault (core dumped)

Prisma版本信息 #

❯ npx prisma version
Environment variables loaded from .env
prisma                  : 5.3.0
@prisma/client          : 5.3.0
Current platform        : debian-openssl-1.1.x
Query Engine (Node-API) : libquery-engine e90b936d84779543cbe0e494bc8b9d7337fad8e4 (at node_modules/.pnpm/@prisma+engines@5.3.0/node_modules/@prisma/engines/libquery_engine-debian-openssl-1.1.x.so.node)
Schema Engine           : schema-engine-cli e90b936d84779543cbe0e494bc8b9d7337fad8e4 (at node_modules/.pnpm/@prisma+engines@5.3.0/node_modules/@prisma/engines/schema-engine-debian-openssl-1.1.x)
Schema Wasm             : @prisma/prisma-schema-wasm 5.3.0-36.e90b936d84779543cbe0e494bc8b9d7337fad8e4
Default Engines Hash    : e90b936d84779543cbe0e494bc8b9d7337fad8e4
Studio                  : 0.494.0

系统配置 #

• 操作系统：Zorin OS Core 16.3
• 内存：8GB DDR3

可行解决方案 #

1. 清理Prisma引擎缓存 #

段错误常与缓存的引擎文件损坏有关，执行以下命令清理本地引擎缓存：

rm -rf ~/.cache/prisma

之后重新运行npx prisma studio，检查是否仍报错。

2. 强制重新生成Prisma客户端与引擎 #

执行完整的Prisma初始化流程，确保所有依赖文件完整：

npx prisma generate --force
npx prisma migrate dev # 若使用数据库迁移，需确保数据库连接正常

完成后再次启动Studio。

3. 切换Prisma版本 #

当前使用的5.3.0版本可能存在平台兼容性问题，尝试降级到稳定版本（如5.2.0）或升级到最新版本：

# 降级到5.2.0
npm install prisma@5.2.0 @prisma/client@5.2.0
# 或升级到最新版本
npm install prisma@latest @prisma/client@latest

安装完成后运行npx prisma studio测试。

4. 检查系统依赖库 #

Zorin OS 16.3基于Ubuntu 20.04，确保系统依赖的OpenSSL库版本与Prisma引擎兼容。执行以下命令更新系统依赖：

sudo apt update && sudo apt install libssl1.1

若系统已安装更高版本的OpenSSL，可尝试创建软链接适配Prisma的debian-openssl-1.1.x平台要求。

5. 使用Prisma Studio的远程模式 #

若本地引擎始终报错，可尝试通过Prisma Cloud启动远程Studio：

npx prisma studio --remote

此方式会使用云端引擎，绕过本地环境的兼容性问题。

内容的提问来源于stack exchange，提问作者Dipto Roy