NestJS v10 업데이트의 여정

모두싸인 백엔드 팀은 NestJS v6에서 v10으로의 업데이트를 진행하며 여러 어려움에 직면했습니다. 기술 부채 해소와 최신 라이브러리 호환을 위해 업데이트를 결정하고, 엔지니어링 컬쳐 길드를 통해 동료들과 함께 진행했습니다.

• 주요 변경 사항 및 해결 방법

  • createParamDecorator 파라미터 변경: ExecutionContext로 변경되어 요청 컨텍스트를 처리하도록 수정했습니다.
  • Terminus 모듈 변경: Health check API를 Controller로 구현하고, 관련 라이브러리를 변경했습니다.
  • HttpException.message 타입 변경: string 타입으로 변경되어 메시지 파싱 로직을 간소화했습니다.
  • 생성자 토큰과 문자열 토큰 분리: providerMapper 함수를 정의하여 기존 토큰을 호환하도록 했습니다.

• 하위 호환성 유지 전략

  • 공통 라이브러리의 호환성을 위해 createParamDecorator와 HttpException.message를 버전별로 분기 처리했습니다.
  • useExisting을 활용하여 문자열 토큰과 생성자 토큰이 동일한 인스턴스를 참조하도록 했습니다.
  • jest의 moduleNameMapper를 사용하여 v6과 v10 환경에서 테스트를 진행, 하위 호환성을 검증했습니다.

업데이트 과정에서 기존 개발 경험을 최대한 유지하며 안정적인 버전 업데이트를 위해 노력했으며, 변경 사항에 대한 가이드 문서를 작성하여 사내 엔지니어들의 빠른 적응을 도왔습니다.