MSA 환경에서 Enum 관리 전략

이 게시물은 토스뱅크에서 MSA 아키텍처 환경에서 Enum 사용 시 발생하는 Deserialize 오류 문제를 해결한 사례를 소개합니다.

Enum 문제의 본질

• MSA 환경에서 서버 간 Enum 정의 버전 차이로 인한 Deserialize 에러 발생
• Enum 값이 미정의 시 발생하는 치명적 오류

해결책

• EnumString 라이브러리 도입으로 선택적 역직렬화와 유연한 오류 처리 구현
• ArchUnit을 활용해 제공자-소비자 간 EnumString 사용 강제 및 빌드 시점 검증
• Meta-Expose 시스템으로 Enum 버전 동기화 상태 감시 및 실시간 모니터링 체계 구축

성과

• Enum deserialize 오류를 사전에 차단하고 안정적인 서비스 운영 달성
• 자동화된 감시와 검증으로 신규 구성원의 실수 방지 및 운영 리스크 감소