古法编程

让 AI 成为你的 Prisma ORM 专家

解决数据库开发中的架构设计与性能瓶颈：通过 AI 诊断 Prisma Schema 错误、优化 N+1 查询并生成安全迁移策略，适用于各类关系型数据库项目。

为什么需要这个技能

在开发 Node.js 后端时，Prisma ORM 是流行选择，但初学者常面临关系建模复杂、迁移冲突频发及查询性能低下等问题。

当数据库驱动与 Prisma 版本不匹配或 schema 定义存在漂移时，直接报错让人难以定位。本技能让 AI 充当专家，自动分析错误堆栈，判断是 Schema 定义问题还是 SQL 逻辑错误，并提供从“最小修复”到“重构”的多级方案。

适用场景

  • 编写复杂关联模型时，不知道如何正确设置 @relation 和级联删除规则。
  • 团队多人协作时，迁移失败导致数据库状态不一致，需要解决冲突。
  • 接口响应变慢，怀疑是发生了 N+1 查询或过度获取数据，需要优化查询逻辑。
  • 在生产环境升级 Prisma 版本时，需要排查 migrate 命令的执行日志。

核心工作流

  1. 环境检测与诊断：AI 首先检查当前安装的 Prisma 版本、数据库驱动及已生成的迁移文件状态。

    npx prisma --version 2>/dev/null || echo "Prisma not installed"
grep "provider" prisma/schema.prisma 2>/dev/null | head -1

  2. 策略应用：识别具体问题类别（如架构设计、查询优化、连接管理），应用渐进式修复策略。

  3. 验证与落地：生成经过 Prisma CLI 验证的代码片段，确保在开发或生产环境均可正常运行。

数据库架构设计

常见问题与修复

  • 关系定义错误：导致运行时找不到关联数据。
  • 缺失索引：高频查询字段缺少 @@index 导致全表扫描。
  • 类型不匹配：Schema 字段类型与数据库列定义不一致。

诊断代码 

# Validate schema
npx prisma validate

# Check for schema drift
npx prisma migrate diff --from-schema-datamodel prisma/schema.prisma --to-schema-datasource prisma/schema.prisma

# Format schema
npx prisma format

优化建议

  1. 最小化：修正缺少 @relation 指令的显式关系。
  2. 进阶：为常用查询字段添加复合索引，优化字段类型。
  3. 完全重构：对架构进行规范化重组，使用 @@map 调整表命名。

最佳实践示例：

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  posts     Post[]   @relation("UserPosts")
  createdAt DateTime @default(now())
  
  @@index([email])
}

model Post {
  id       String @id @default(cuid())
  author   User   @relation("UserPosts", fields: [authorId], references: [id], onDelete: Cascade)
  authorId String
  
  @@index([authorId])
}

迁移与连接管理

迁移冲突处理

团队协作中常遇到迁移冲突或影子数据库问题。

  • 开发环境：可直接使用 prisma migrate reset 重置以快速验证。
  • 生产环境：严禁使用 migrate dev，需通过 migrate deploy 部署，若失败利用 migrate resolve 处理已应用或回滚的迁移。

连接池优化

解决 “Too many connections” 错误至关重要，特别是在无状态环境（如 Serverless）。

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

export const prisma =
  globalForPrisma.prisma ||
  new PrismaClient({
    log: process.env.NODE_ENV === 'development' ? ['query'] : [],
  });

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

// Graceful shutdown
process.on('beforeExit', async () => {
  await prisma.$disconnect();
});

下载和安装

下载 prisma-expert 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。

你可能还需要

暂无推荐