다중 모듈 Maven 프로젝트를 위한 인터랙티브 라이브러리 버전 조화 기법

초록

본 논문은 Maven 기반 다중 모듈 Java 프로젝트에서 발생하는 라이브러리 버전 불일치를 자동으로 탐지하고, API 사용량을 기반으로 최소 조정 비용을 제시하는 인터랙티브 도구 LibHarmo를 설계·평가한다.

상세 분석

LibHarmo는 세 단계로 구성된다. 첫 번째 단계에서는 프로젝트의 POM 파일을 파싱해 상속 그래프를 구축하고, 각 모듈이 직접 선언한 의존성과 dependencyManagement에 의해 관리되는 의존성을 모두 해석한다. 이를 통해 동일 라이브러리의 서로 다른 버전이 선언된 “버전 불일치”와, 동일 버전이지만 서로 다른 속성으로 선언된 “거짓 일관성”을 식별한다. 두 번째 단계에서는 식별된 불일치마다 라이브러리 API 사용 분석을 수행한다. 구체적으로, 각 모듈이 호출하는 메서드·클래스 집합을 추출하고, 후보 버전들 사이의 API 삭제·변경 수를 비교한다. 가장 적은 API 삭제·변경을 초래하는 버전을 ‘조화된 버전’으로 제안함으로써 개발자가 감당해야 할 코드 수정 비용을 최소화한다. 이 과정은 개발자와의 인터랙션을 통해 조화 대상 모듈을 선택하고, 최종 버전을 확정하도록 설계되었다. 마지막 단계에서는 선택된 버전에 맞춰 POM 파일을 자동 리팩터링하고, 삭제된 API에 대한 대체 호출을 문서 기반으로 제시한다.

논문은 131명의 Java 개발자를 대상으로 설문조사를 진행해, 90 % 이상이 버전 불일치를 경험했으며, 주요 원인으로는 다른 모듈에 동일 라이브러리가 존재함을 인지하지 못함과 버전 간 후향 호환성 문제를 꼽았다. 또한, 대부분이 수동으로 POM을 검토하거나 Maven Enforcer 플러그인을 이용해 불일치를 발견하지만, 실제 조정 작업은 API 호환성 검토와 코드 수정 때문에 높은 비용이 든다는 점을 확인했다. 이러한 실무적 고충을 반영해 LibHarmo는 ‘노력 인식(effort‑aware)’이라는 핵심 설계 목표를 두었다.

실험에서는 GitHub에서 스타 수가 200 이상인 443개의 인기 Maven 프로젝트를 대상으로 도구를 적용했다. 결과적으로 621개의 버전 불일치를 발견했으며, 이는 전체 프로젝트의 34 %에 해당한다. 평균적으로 조화된 버전으로 전환할 때 삭제된 API는 1개, 변경된 API는 2개였으며, 이는 전체 호출 중 각각 1 %와 12 %에 해당한다. 실제 현업 개발자 5명에게 확인을 요청한 결과, 1건이 이미 조화되었고, 나머지는 도구가 제시한 조화 방안을 검토 중인 상태였다.

이 연구는 기존 Maven Enforcer 플러그인이 제공하는 ‘전이적 의존성 수렴’ 검사만으로는 모듈 간 직접 선언된 버전 불일치를 포착하지 못한다는 한계를 보완한다. 또한, 자동화된 버전 선택과 API 수준의 수정 비용 추정이라는 두 축을 결합함으로써, 개발자가 조화 작업을 언제, 어디서, 어떻게 수행할지에 대한 의사결정을 지원한다. 향후 작업으로는 빌드 파이프라인에 도구를 통합해 지속적인 모니터링을 제공하고, 보다 정교한 API 호환성 분석(예: 시그니처 변형, 동작 차이)과 자동 코드 변환 기능을 확대할 필요가 있다.