🔍 NestJS ModuleRef – 동적 모듈 인스턴스 주입 완전 가이드

🔍 NestJS ModuleRef – 동적 모듈 인스턴스 주입 완전 가이드

---

NestJS에서 ModuleRef는 동적으로 모듈 인스턴스를 주입할 수 있도록 도와주는 도구입니다.
이번 글은 NestJS 공식 문서 ModuleRef를 기반으로,
실무에서 ModuleRef를 활용하여 동적 주입 문제를 해결하는 방법을 설명합니다.

💡 "특정 상황에서만 필요한 서비스를 동적으로 주입하여, 메모리와 성능 문제를 해결할 수 있습니다."

---

✅ ModuleRef란?

• NestJS의 모듈 인스턴스를 동적으로 가져오기 위해 사용하는 클래스입니다.
• 순환 의존성 문제를 해결하거나, 런타임에 특정 서비스를 주입할 때 사용합니다.

---

📦 설치

ModuleRef는 NestJS의 기본 모듈로 포함되어 있어 별도의 설치가 필요하지 않습니다.

---

1️⃣ 기본 사용법 – get() 메서드

import { Injectable, ModuleRef } from '@nestjs/core';

@Injectable()
export class DynamicService {
  constructor(private moduleRef: ModuleRef) {}

  getService(serviceName: string) {
    return this.moduleRef.get(serviceName, { strict: false });
  }
}

사용 예시

const catsService = this.getService(CatsService);
catsService.getCats();

• 동적으로 서비스 인스턴스를 가져옴
• strict: false 옵션을 통해 모듈 경로가 명시적이지 않아도 주입 가능

---

반응형

ModuleRef를 사용하여 동적 주입 문제를 해결하는 이 지점은
블로그 독자들이 주목하는 핵심 구간입니다.
애드센스 광고를 삽입하면 CTR이 높게 나오는 구간입니다.

<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>

---

2️⃣ 순환 의존성 문제 해결

✅ Circular Dependency 해결 코드

@Injectable()
export class CatsService {
  private dogsService: DogsService;

  constructor(private moduleRef: ModuleRef) {}

  onModuleInit() {
    this.dogsService = this.moduleRef.get(DogsService, { strict: false });
  }

  getRelatedDogs() {
    return this.dogsService.getDogs();
  }
}

• onModuleInit() 후에 모듈 인스턴스를 가져와야 순환 의존성 문제를 방지할 수 있습니다.

---

3️⃣ Transient Scope에서 사용

• Transient Scope에서는 DI가 올바르게 주입되지 않는 경우가 많습니다.
• 이럴 때 ModuleRef를 사용하면 동적으로 인스턴스를 생성할 수 있습니다.

✅ Transient Service 생성

@Injectable({ scope: Scope.TRANSIENT })
export class TransientService {
  sayHello() {
    return 'Hello from Transient Service!';
  }
}

✅ 동적 호출

@Injectable()
export class MainService {
  constructor(private moduleRef: ModuleRef) {}

  async handle() {
    const transientService = await this.moduleRef.resolve(TransientService);
    console.log(transientService.sayHello());
  }
}

**moduleRef.resolve()**는 매번 새로운 인스턴스를 반환하여 Transient Scope 문제를 해결합니다.

---

4️⃣ Lazy Loading을 통한 메모리 최적화

• 특정 서비스가 항상 사용되지 않는다면 초기화하지 않고, 필요할 때 로드하는 것이 유리합니다.

✅ Lazy Loading 코드

@Injectable()
export class LazyService {
  constructor(private moduleRef: ModuleRef) {}

  private async getDynamicService(): Promise<DynamicService> {
    return this.moduleRef.resolve(DynamicService);
  }

  async executeTask() {
    const service = await this.getDynamicService();
    return service.runTask();
  }
}

---

🧠 실무 활용 전략

상황 해결 방법

순환 의존성 발생	ModuleRef로 동적 주입
Transient Scope 문제	moduleRef.resolve()로 새로운 인스턴스 사용
런타임에 서비스 선택 필요	moduleRef.get()로 조건부 인스턴스 주입
메모리 사용 최적화	Lazy Loading 기법 적용

---

🚧 주의사항

• Singleton 모듈에서 Transient 모듈 주입 시 매번 동일 인스턴스를 반환합니다.
  → 이 경우 moduleRef.resolve()를 사용하여 항상 새로운 인스턴스를 받아야 합니다.
• strict: false 사용 시, 잘못된 모듈을 가져올 위험이 있습니다.
  → 구조를 명확히 하고 사용하는 것이 바람직합니다.

---

🔚 마무리 요약

기능 설명

get()	모듈 인스턴스를 가져옴 (기본적으로 Singleton)
resolve()	항상 새로운 인스턴스를 가져옴 (Transient 지원)
Circular Dependency 해결	onModuleInit() 후에 모듈 인스턴스 할당
Lazy Loading	필요한 시점에 모듈을 가져와 메모리 최적화

---

 

NestJS ModuleRef,NestJS Circular Dependency,NestJS Transient Scope 해결,NestJS 동적 주입,NestJS Lazy Loading,NestJS Module 인스턴스,NestJS DI 최적화,NestJS resolve 사용법,NestJS 모듈 관리,NestJS 실무 패턴

---