NestJS 순환 모듈 의존성: 정상·경계·실패 조건 확인하기

판정할 동작

순환 모듈 의존성에서 유지해야 할 동작과 바뀌어야 할 결과를 나눠 적습니다. 두 Nest module이 서로 import하면 초기화와 provider resolution이 꼬일 수 있어 공통 책임을 분리하고 forwardRef는 제한적으로 사용해야 합니다.

작은 테스트 표

두 module·package가 서로 import하는지, runtime 초기화 순서가 필요한지, 단순 type 의존인지 나눠 dependency graph에서 cycle을 확인합니다.

조건	확인할 내용
대표 사례	자주 쓰는 조건에서 기대 결과가 나오는가
경계	값이나 동작이 바뀌는 지점이 안전한가
실패	오류가 정해진 방식으로 드러나고 중간 상태가 남지 않는가
반복	다시 실행해도 결과가 예측 가능한가

결과를 읽고 남길 것

수정 전 실패 사례는 사라지고 기존 정상 사례는 유지돼야 합니다. e2e 테스트와 부하 테스트에서 provider 수명, DB pool, event loop delay와 오류 계약을 검증한다. 깨끗한 환경에서 build·test를 실행하고 두 module을 서로 다른 순서로 불러도 초기화 값과 dependency resolution이 같게 유지되는지 확인합니다. 한 번의 가장 좋은 결과나 화면 한 장으로 완료를 선언하지 않습니다. 실패 입력과 기대 결과를 자동 test나 실행 가능한 점검으로 남깁니다.

공식 문서와 적용 범위

• NestJS Documentation (새 창에서 열림)

문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.