🍃 NestJS + MongoDB 완전 정복 – Mongoose 연동 가이드

🍃 NestJS + MongoDB 완전 정복 – Mongoose 연동 가이드

---

NestJS는 MongoDB를 위한 공식 모듈로 **@nestjs/mongoose**를 제공합니다.
이를 통해 **Mongoose ODM(Object Data Modeling)**을 Nest의 DI(의존성 주입) 아키텍처에 자연스럽게 통합할 수 있습니다.
이번 글은 NestJS 공식 문서 MongoDB를 바탕으로,
실무에서 MongoDB를 NestJS로 효율적으로 연동하는 방법을 정리합니다.

💡 NestJS + Mongoose 조합은 MongoDB를 사용하는 프로젝트에 매우 적합하며,
복잡한 Schema 설계와 유연한 쿼리 구성이 가능합니다.

---

✅ 1. 설치

npm install @nestjs/mongoose mongoose

---

✅ 2. MongoDB 연결 설정

// app.module.ts
import { Module } from '@nestjs/common';
import { MongooseModule } from '@nestjs/mongoose';

@Module({
  imports: [
    MongooseModule.forRoot('mongodb://localhost/nestdb'), // URI는 환경변수로 관리 권장
  ],
})
export class AppModule {}

☑️ .env 파일로부터 MONGODB_URI 값을 받아 사용하는 방식도 추천합니다.

---

✅ 3. 스키마 정의

NestJS는 Mongoose의 Schema 클래스를 @Schema() 데코레이터로 감쌉니다.

// user.schema.ts
import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
import { Document } from 'mongoose';

export type UserDocument = User & Document;

@Schema()
export class User {
  @Prop({ required: true })
  name: string;

  @Prop()
  email: string;
}

export const UserSchema = SchemaFactory.createForClass(User);

반응형

---

 

이 지점은 스키마 정의와 실제 Nest 서비스에 통합되는 예제가 나오는 핵심 파트입니다.
애드센스 광고 삽입에 최적입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXX"
     data-ad-slot="YYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

✅ 4. 스키마 모듈에 등록

// user.module.ts
import { MongooseModule } from '@nestjs/mongoose';
import { Module } from '@nestjs/common';
import { User, UserSchema } from './user.schema';
import { UserService } from './user.service';

@Module({
  imports: [
    MongooseModule.forFeature([{ name: User.name, schema: UserSchema }]),
  ],
  providers: [UserService],
})
export class UserModule {}

---

✅ 5. 서비스에서 Mongoose 모델 주입

// user.service.ts
import { Injectable } from '@nestjs/common';
import { InjectModel } from '@nestjs/mongoose';
import { Model } from 'mongoose';
import { User, UserDocument } from './user.schema';

@Injectable()
export class UserService {
  constructor(@InjectModel(User.name) private userModel: Model<UserDocument>) {}

  async findAll(): Promise<User[]> {
    return this.userModel.find().exec();
  }

  async create(data: Partial<User>): Promise<User> {
    return new this.userModel(data).save();
  }
}

---

✅ 6. Controller에서 사용

// user.controller.ts
@Controller('users')
export class UserController {
  constructor(private readonly userService: UserService) {}

  @Get()
  async getAllUsers() {
    return this.userService.findAll();
  }

  @Post()
  async createUser(@Body() body: { name: string; email: string }) {
    return this.userService.create(body);
  }
}

---

💡 실무 팁 – 복잡한 관계 설계

• MongoDB는 참조형 관계(Population) 또는 내장형(Embedded) 설계를 지원합니다.
• NestJS + Mongoose에서도 아래와 같은 방식으로 참조 설정 가능:

@Prop({ type: mongoose.Schema.Types.ObjectId, ref: 'User' })
author: User;

this.postModel.find().populate('author').exec();

---

🧠 NestJS + MongoDB 실전 전략

기능 NestJS 구성 요소

Mongo 연결	MongooseModule.forRoot()
스키마 정의	@Schema(), @Prop()
DB 작업 수행	@InjectModel()으로 주입받은 Model<T> 사용
문서 관리 (Document)	T & Document 타입으로 타입 안정성 확보
관계 설정 (Population)	ref: '모델명' 으로 관계 설정 + populate() 사용

---

✅ 장점 요약

• ✅ Nest의 DI와 Mongoose 모델을 자연스럽게 통합
• ✅ 빠르고 유연한 NoSQL 설계 가능
• ✅ Schema, Document, Model을 명확히 분리
• ✅ populate, Index 등 Mongoose의 모든 기능 지원

---

 

NestJS MongoDB,NestJS Mongoose,NestJS NoSQL 연동,NestJS Mongo 스키마,NestJS MongooseModel 사용법,NestJS DB 연동 가이드,NestJS Mongo 실무,NestJS ODM,NestJS populate 관계 설정,NestJS Document 모델

---