Prisma 实战指南：像搭积木一样设计古诗词数据库

在传统后端开发中，与数据库打交道往往意味着要编写大量晦涩的 SQL 语句。而 Prisma 就像一位精通多国语言的"翻译官"，它通过 ORM（对象关系映射）技术，将数据库的表映射为代码中的类，将行映射为实例。你不再需要手写 INSERT 或 SELECT，只需像操作普通对象一样 create 或 findMany，Prisma 就会在幕后为你翻译成精准的 SQL。

接下来，我们就结合一个"古诗词社区"的实际项目，从零开始体验 Prisma 的魅力。

一、环境搭建与初始化

首先，我们需要为项目安装 Prisma 的核心依赖。建议锁定版本以避免兼容性问题：
pnpm i prisma@6.19.2
pnpm i @prisma/client@6.19.2

依赖安装完毕后，执行 npx prisma init。这条命令会为你生成两个关键文件：.env（存放环境变量）和 prisma/schema.prisma（数据库设计蓝图）。

打开 .env，填入你的 PostgreSQL 连接字符串，例如：
DATABASE_URL="postgresql://postgres:369369@localhost:5432/xue?schema=public"

二、Schema 设计：绘制数据库蓝图

schema.prisma 是整个 ORM 的灵魂。在这个文件中，我们通过 model 来定义数据表。让我们结合古诗词项目的实际设计，看看几个核心模型是如何构建的：

1. 基础配置与用户模型

文件头部定义了生成器和数据源，告诉 Prisma 我们要生成 JS 客户端并连接 PostgreSQL。

kotlin 复制代码

generator client {
  provider = "prisma-client-js"
}
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}
model User {
  id        Int      @id @default(autoincrement())
  name      String   @unique @db.VarChar(255)
  password  String   @db.VarChar(255)
  // 使用 @map 将驼峰字段映射为数据库的下划线命名
  createdAt DateTime? @default(now()) @map("created_at") @db.Timestamptz(6)
  updatedAt DateTime? @default(now()) @map("updated_at") @db.Timestamptz(6)
  // 一对多关系：一个用户可以有多篇文章、评论、点赞等
  posts     Post[]
  comments  Comment[]
  likes     UserLikePost[] 
  files     File[]
  avatars   Avatar[]
  @@map("user") // 将表名映射为单数 user
}

2. 核心业务与级联策略

在 Post（诗词文章）模型中，我们看到了外键关联与删除策略的精妙配合：

kotlin 复制代码

model Post {
  id       Int     @id @default(autoincrement())
  title    String  @db.VarChar(255)
  content  String? @db.Text
  userId   Int?             
  // 关联 User，并设置 onDelete: SetNull
  // 意为：如果作者被删除，文章保留但作者ID置空
  user     User?   @relation(fields: [userId], references: [id], onDelete: SetNull) 
  comments Comment[]
  tags     PostTag[]
  @@index([userId]) // 为外键添加索引，提升查询效率
  @@map("posts")
}

3. 复杂关联：自关联与复合主键

古诗词社区少不了评论互动与标签分类，这里用到了两个高级技巧：

自关联（评论回复） ：在 Comment 模型中，通过 parentId 和 @relation("CommmentToComment") 实现了评论的层级回复（父评论与子评论）。
复合主键（多对多中间表） ：PostTag（文章标签）和 UserLikePost（用户点赞）作为中间表，使用 @@id([postId, tagId]) 定义了复合主键。这确保了"一篇文章不能被重复打同一个标签"以及"一个用户不能重复点赞同一篇文章"的业务逻辑。

三、迁移与可视化：让设计落地

设计好 Schema 后，我们需要将其同步到真实的数据库中。

数据迁移 ：执行 npx prisma migrate dev --name init_user。Prisma 会自动对比当前数据库结构，生成 SQL 迁移文件并执行，同时在数据库中记录版本日志。这不仅方便团队协作，也方便后续的版本回滚。
可视化操作 ：执行 npx prisma studio。这会打开一个精美的图形化界面，你可以在浏览器中直观地查看 User、Post 等表的数据，甚至手动添加测试数据（Seeds），完全告别黑乎乎的命令行。

四、代码操作：告别 SQL

当一切准备就绪，你就可以在代码中通过 Prisma Client 优雅地操作数据了。例如，查询李白发布的所有诗词：

php 复制代码

const libaiPosts = await prisma.post.findMany({
  where: { user: { name: 'libai' } },
  include: { tags: true } // 顺带查出文章标签
});

从安装配置到模型设计，再到最终的代码调用，Prisma 用类型安全和高度抽象的 API，将开发者从繁琐的 SQL 中彻底解放了出来。