MSA로의 여정에서 만난 Spring Modulith 체리픽 해본 후기

문제 상황

• 레거시 모놀리스에서 MSA 전환을 고민하는 과정
• 상품 추가 시 도메인 경계와 서버 배치 기준이 불명확한 문제
• 코드·DB 접근이 얽히며 유지보수와 협업이 어려워진 상황

원인 분석

• 하나의 코드베이스에 서비스와 팀이 함께 묶인 구조
• 기능 확장으로 빌드·테스트 속도 저하와 영향 범위 확대
• 상품 단위로 완전 분리하기엔 운영·인프라 부담이 큰 현실

해결 방법

• 수신상품 전체를 하나의 모놀리스 서버 경계로 재정의
• 모듈러 모놀리스와 Spring Modulith로 논리적 모듈 분리
• Public API와 테스트 검증으로 모듈 간 참조를 강제

주의할 점

• 논리적 분리만으로는 경계가 약해질 수 있어 검증 필요
• 상품별 물리 분리는 기준과 미래 변동성을 함께 고려해야 함
• 공통 모듈과 도메인 모듈의 탐지 범위를 명확히 나눠야 함

적용해볼 점

• Gradle 멀티모듈과 Spring Modulith 조합 검토
• ADR로 아키텍처 의사결정 기록
• 추후 물리적 분리나 MSA 전환을 염두에 둔 패키지 설계