런타임 버그 3건을 컴파일 타임에 잡아낸 DataWeave 2.5 Generics 도입기

Context

12개 Mule 앱에서 공유하는 유틸리티 라이브러리의 Any 타입 남용. 타입 체크 부재로 인한 잘못된 출력값 발생. 런타임 단계에서만 발견되는 데이터 정렬 및 형태 불일치 문제.

Technical Solution

• DataWeave 2.5 Call-site Generics 도입을 통한 타입 파라미터 <T> 정의
• topN 함수에 Array<T>와 Comparable 제약 조건을 추가하여 컴파일 시점의 타입 검증 체계 구축
• pipe 함수에 제네릭 타입을 적용하여 체인 내 모든 변환 함수의 입력·출력 타입 일치 강제
• 잘못된 데이터 타입 전달 시 런타임 오류 대신 컴파일 에러를 발생시키는 정적 타입 검사 방식 채택
• Mule 4.5 미만 버전과의 호환성 해결을 위해 제네릭 적용 버전(utils-v25.dwl)과 하위 호환 버전(utils.dwl)으로 모듈 분리 운영

Impact

• 4개월 동안 잠복해 있던 프로덕션 버그 3건을 첫 컴파일 단계에서 즉시 발견

Key Takeaway

유틸리티 라이브러리처럼 다수의 서비스가 공유하는 공통 로직일수록 정적 타입 시스템을 활용한 계약 기반 설계가 시스템 안정성에 결정적인 영향을 미침.