您如何在 NestJS 中集成数据库（TypeORM/Prisma）？

Question

Accepted Answer

NestJS 通过 ORM 可以干净地集成数据库——最常见的是 **TypeORM**（官方 `@nestjs/typeorm` 集成）和 **Prisma**（一个现代的、类型安全的 ORM，通过自定义服务使用）。两者都能很好地适配 NestJS 的 module/provider/DI 结构。 ## TypeORM 集成 ```ts // 1. configure the connection in a module @Module({ imports: [ TypeOrmModule.forRoot({ type: "postgres", url: process.env.DATABASE_URL, entities: [User], synchronize: false, // ⚠️ NEVER true in production (use migrations) }), TypeOrmModule.forFeature([User]), // register entities for this feature module ], }) export class UsersModule {} ``` ```ts // 2. define an entity (maps to a table) @Entity() export class User { @PrimaryGeneratedColumn() id: number; @Column() name: string; @Column({ unique: true }) email: string; } ``` ```ts // 3. inject the repository into a service @Injectable() export class UsersService { constructor( @InjectRepository(User) private usersRepo: Repository, ) {} findAll() { return this.usersRepo.find(); } findOne(id: number) { return this.usersRepo.findOneBy({ id }); } create(data: Partial) { return this.usersRepo.save(data); } } ``` TypeORM 使用 `@Entity` 类（映射到表）和可注入的 `Repository` 来执行查询——通过 `@InjectRepository` 自然地适配 NestJS 的 DI 模型。 ## Prisma 集成 ```ts // 1. a PrismaService wraps the Prisma client (and manages connection lifecycle) @Injectable() export class PrismaService extends PrismaClient implements OnModuleInit { async onModuleInit() { await this.$connect(); } // connect on startup } ``` ```ts // 2. inject it and use the type-safe client @Injectable() export class UsersService { constructor(private prisma: PrismaService) {} findAll() { return this.prisma.user.findMany(); } findOne(id: number) { return this.prisma.user.findUnique({ where: { id } }); } create(data) { return this.prisma.user.create({ data }); } } ``` Prisma 从 schema 文件生成完全类型安全的客户端；您将其包装在可注入的 `PrismaService` 中，并在您的 services 中使用它。 ## 迁移而非同步 ```text ⚠️ NEVER use `synchronize: true` (TypeORM) in production — it auto-alters your schema and can DROP data. Use MIGRATIONS (version-controlled schema changes) instead. Prisma: prisma migrate dev/deploy manages schema changes via migration files. ``` ## TypeORM vs Prisma ```text TypeORM → repository/active-record patterns, decorators, mature, official Nest integration Prisma → schema-first, excellent type safety, great DX, growing popularity ``` ## 为什么这很重要数据库集成是必不可少的——几乎每个后端都需要持久化数据，理解如何以惯用方式将数据库连接到 NestJS 是核心实践知识。两个主流 ORM 都能很好地适配 NestJS 的架构：TypeORM 通过官方 `@nestjs/typeorm` 模块（配置连接、定义 `@Entity` 类、通过 DI 注入 `Repository`）和 Prisma 通过包装的可注入 `PrismaService`（提供卓越的类型安全性）。了解如何设置连接、定义模型以及将数据访问层注入到 services 中——将数据库逻辑保留在 services 中，与 controllers 分离——是构建真实 NestJS 应用的基础。至关重要的是，理解**迁移而非同步**原则（永远不要在生产环境中自动同步 schema，因为这可能会破坏数据，而是使用版本控制的迁移）是一项重要的生产安全实践。这是日常必知的内容，因为数据持久化是后端开发的核心，ORM 集成是 NestJS 应用实际存储和检索数据的方式。