🔄 NestJS Dynamic Modules – 유연한 모듈 설정의 끝판왕

🔄 NestJS Dynamic Modules – 유연한 모듈 설정의 끝판왕

---

NestJS에서 **Dynamic Module(동적 모듈)**은 런타임에 모듈을 유연하게 구성할 수 있는 강력한 기능입니다.
이번 글은 NestJS 공식 문서 Dynamic Modules를 기반으로
한글 번역 + 실무 중심의 해설을 제공합니다.

다양한 설정 값, 외부 API 키, 커스텀 기능을 모듈로 재사용하려면 Dynamic Module을 제대로 이해해야 합니다.

---

✅ Dynamic Module이란?

정적인 모듈은 @Module({ ... }) 안에 고정된 Provider와 Controller를 가집니다.
Dynamic Module은 런타임에 옵션을 받아 모듈 내부 구성(Provider, Import 등)을 유연하게 정의할 수 있습니다.

---

1️⃣ 기본 구조 예제

@Module({})
export class ConfigModule {
  static register(options: ConfigModuleOptions): DynamicModule {
    return {
      module: ConfigModule,
      providers: [
        {
          provide: 'CONFIG_OPTIONS',
          useValue: options,
        },
        ConfigService,
      ],
      exports: [ConfigService],
    };
  }
}

• register()는 외부에서 호출 가능한 정적 메서드(static)
• 반환 타입은 DynamicModule
• 외부에서 넘긴 options를 내부 Provider로 주입 가능

---

2️⃣ 사용하는 쪽에서 register() 호출

@Module({
  imports: [
    ConfigModule.register({
      envFilePath: '.env.dev',
    }),
  ],
})
export class AppModule {}

• 외부에서 전달된 값은 내부에서 Provider로 주입되어 사용 가능

---

✅ 주입 예시

@Injectable()
export class ConfigService {
  constructor(@Inject('CONFIG_OPTIONS') private options: ConfigModuleOptions) {}

  get(key: string) {
    return process.env[key] ?? this.options.default[key];
  }
}

반응형

---

 

동적 모듈을 활용하는 이 시점은 대규모 서비스 설계에서 중요한 요소입니다.
애드센스 광고 삽입 위치로 최적입니다.

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

---

3️⃣ Dynamic Module 구조 해부

export interface DynamicModule {
  module: Type<any>;
  providers?: Provider[];
  imports?: any[];
  exports?: Provider[];
  global?: boolean;
}

• module: 반드시 포함해야 하는 현재 모듈 클래스
• providers: 설정에 따라 결정되는 Provider 배열
• imports, exports: 다른 모듈 연결
• global: 전역으로 사용할지 여부

---

4️⃣ registerAsync() 방식 – 비동기 구성

외부 API나 설정 파일을 비동기적으로 로드해야 할 경우 사용

@Module({})
export class ConfigModule {
  static registerAsync(): DynamicModule {
    return {
      module: ConfigModule,
      imports: [ExternalApiModule],
      providers: [
        {
          provide: 'CONFIG_OPTIONS',
          useFactory: async (apiService: ApiService) => {
            const config = await apiService.loadConfig();
            return config;
          },
          inject: [ApiService],
        },
      ],
      exports: ['CONFIG_OPTIONS'],
    };
  }
}

---

5️⃣ 실무에서 자주 쓰는 Dynamic Module

모듈 설명

ConfigModule	환경변수/설정 값 주입
DatabaseModule	연결 문자열에 따라 DB 설정
MailModule	SMTP 인증 정보 등
CacheModule	Redis 옵션, TTL 설정 등
LoggerModule	로깅 옵션 커스터마이징

---

🧠 실무 팁 요약

• register()를 통해 옵션 기반 모듈 구성 가능
• registerAsync()는 비동기 초기화용
• 설정을 useValue, useFactory 형태로 Provider에 주입
• 재사용 가능한 유틸성 모듈(예: 로그, API, 캐시)은 반드시 Dynamic Module로 제작

---

🔚 마무리 요약

개념 설명

DynamicModule	런타임에 구성되는 모듈
register()	설정 값 기반 정적 구성
registerAsync()	비동기 초기화용
useFactory	설정값 동적 주입
실전 적용	Config, DB, Cache, Mail, Logger 등 필수

---

 

NestJS Dynamic Module,NestJS register,NestJS registerAsync,NestJS useFactory 모듈,NestJS 설정 모듈,NestJS 비동기 모듈,NestJS 재사용 모듈,NestJS 고급 DI,NestJS 실무 설계,NestJS 커스터마이징 모듈

---