害,是不是经常听到别人说"NestJS配Prisma开发贼香"但自己上手就懵圈?别急,今天咱以老友唠嗑的方式,把Prisma在NestJS里怎么玩给整得明明白白——保证不端架子,全是干货加吐槽~

先说说为啥选这俩组合: NestJS本身就是Node.js里"架构Zui像后端"的框架, Prisma呢?则是ORM里"类型安全天花板"级别的存在——不用手写SQL还Neng自动补全,简直是懒癌患者福音!搭配起来开发效率直接拉满,你懂的~

得承认: 新手Zui怵的就是环境配置,各种依赖版本不对、命令敲错报红…但咱慢慢来,一步一步捋:

第一步: 先建个Nest项目吧

第二步: 装Prisma相关依赖——记清楚哦:

pnpm add prisma @prisma/client @prisma/adapter-mariadb dotenv  # 推荐pnpm,快还不占空间
# 或者npm/yarn也行:npm install prisma @prisma/client --save-dev

这里解释下: prisma是命令行工具, @prisma/client是核心客户端, adapter-mariadb是MySQL/MariaDB的驱动桥接

第三步: 初始化Prisma——敲这条命令:npx prisma init --datasource-provider mysql

执行完会发现项目里多了个prisma文件夹,里面有俩文件:

.env: 存数据库链接!别嫌麻烦,按格式填对:

# .env文件示例
DATABASE_URL="mysql://root:你的密码@localhost:3306/你的数据库名?sslmode=require"

schema.prisma: 这个是重点!相当于你的"数据库说明书",所有表结构dou在这里定义~

第四步: 写第一个模型——比如User表,在schema.prisma里加:

// schema.prisma
generator client {
  provider = "prisma-client-js" // 固定写法,生成TS客户端
  output   = "../src/generated/prisma" // 客户端生成位置
}
datasource db {
  provider = "mysql" // 数据源类型,支持PostgreSQL/MySQL等
  url      = env // 读取.env里的链接
}
// 定义User模型
model User {
  id    Int     @id @default) // id主键,自增
  name  String? // ?表示可选字段  
  email String  @unique // unique约束:邮箱不Neng重复 
  posts Post // 一对多关系:一个用户多篇帖子 
}
// 再整个Post模型配个关系玩 
model Post {  
  id        Int     @id @default)  
 title     String  
 content   String? @db.Text // 指定数据库类型为Text 
 published Boolean @default // 默认未发布 
 author    User    @relation // 关联User表 
 authorId Int //外键字段 
}

第五步: 生成客户端代码——敲npx prisma generate!等会儿,schema.prisma里定义的模型会自动变成TS类型,以后调用api的时候IDE会疯狂提示,爽不爽?

NestJS讲究"一切皆模块",那Prisma肯定也要封装成Service才Neng全局用~来整一个:PrismaService

// src/prisma/prisma.service.ts   
import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common';  
import { PrismaClient } from '../generated/prisma'; // 刚才generate出来的客户端路径  
@Injectable  
export class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {  
 constructor {    
   super({      
     log: , // 开启日志kanSQL语句超有用!    
   });  
 }  
 async onModuleInit {    
   await this.$connect; // Nest模块初始化时连接数据库  
 }  
 async onModuleDestroy {    
   await this.$disconnect; //模块销毁时断开连接  
 }  
}

解释下:@Injectable代表这是个可注入服务;extends PrismaClient直接继承客户端Neng力;OnModuleInit和OnModuleDestroy是Nest生命周期钩子——不用手动管连接断开,Prisma帮你搞定~

接下来要把这个服务提供给全局用!去AppModule或者专门建个PrismaModule注册它:

// src/prisma/prisma.module.ts   
import { Module } from '@nestjs/common';  
import { PrismaService } from './prisma.service';  
@Module({  
 providers: ,  
 exports: , //导出才Neng给其他模块用!  
})  
export class PrismaModule {}  
// src/app.module.ts里引入 
import { Module } from '@nestjs/common'; 
import { AppController } from './app.controller'; 
import { AppService } from './app.service'; 
import { PrismaModule } from './prismamodule'; 
@Module export class Appmodule {}

终于到好玩的部分了!搞个UserService来测试增删改查——保证一行行kan明白:

// src/user/user.service.ts  
import { Injectable } from '@nestjs/common';   
import { Prismaservice } from '../pris matiaservice' ;   
import{ CreateuserDto}from'./dto/create-user.dto' ;//后面说DTO验证  
@Injectable exportclass Userservice{ constructor{}  
// 创建用户 async create{ return this. prismaservice.user.create; }  
// 查询所有用户 async findAll{ return this. prismaservice.user.findMany; }  
// 根据id查询 async findone{ return this. prismaservice.user.findunique;}  
// geng新用户 async update{ return this. prismaservicer user.update;}  
async delete{ returnthis. prismaservice.user.delete;}

hen多人会遇到:"我数据库Yi经有数据了,Nest项目之前用别的ORM,现在想换Prismal怎么办?" ——简单!三步搞定:

第一步:Pull现有库结构到Schema :敲npx primsa db pull !它会自动把你当前库的数据表反向生成schema.pris mal文件—连外键约束dou给你弄好!

第二步::Ru果pull下来有报错?别慌!检查schema.pris mal里模型定义有没有重复或者语法错—比如字段名拼错啦,@unique漏加啦之类.

第三步::因为库Yi经存在,Prsmal migrate dev会报错,这时候要用: mkdir -p prlsmal/migrations/0_init npx primsa migrate diff --from-empty --to-schema prlsmal/schema.prlsna --script> prlsmal/migrations/0_init/migration.sql npx primsa migrate resolve --applied O_init 这样Primsa就会认为"初始迁移Yi应用",以后改表结构直接migrate dev就行啦!

1. 修改schema后没generate导致类型报错?: 害!我刚学那会改了User模型加个age字段,npm run dev直接爆红—后来才知道必须每次改schemadou敲npx primsa generate !不然客户端代码没geng新啊!