스프링 부트에서 JSON 다형성을 활용한 확장 가능한 알림 시스템 설계하기 - 피노바라

(dev.to)

Dev.to OpenSource2026년 4월 16일개발자 도구

스프링 부트에서 JSON 다형성을 활용한 확장 가능한 알림 시스템 설계하기 - 피노바라

이 기사는 스프링 부트와 Jackson의 JSON 다형성(Polymorphism)을 활용하여, 데이터베이스 스키마 변경 없이도 새로운 알림 타입을 손쉽게 추가할 수 있는 확장 가능한 알림 시스템 설계 방법을 다룹니다. 제네릭 엔진과 중복 방지 키(deduplicationKey)를 통해 복잡한 로직을 단순화하고 시스템의 유연성을 극대화하는 전략을 제시합니다.

이 글의 핵심 포인트

1Jackson의 JSON 다형성을 사용하여 단일 테이블 내에서 다양한 알림 페이로드를 처리
2새로운 알림 타입 추가 시 데이터베이스 스키마 변경(Migration)이 필요 없는 구조 설계
3제네릭 추상 클래스를 활용하여 알림 생성 로직의 재사용성 및 확장성 확보
4deduplicationKey를 도입하여 배치 처리 및 이전 실행 간 중복 알림 발생 방지
5도메인 엔티티, 계산 로직, 알림 생성을 분리하여 관심사의 분리(Separation of Concerns) 실현

이 글에 대한 공공지능 분석

왜 중요한가

비즈니스가 성장함에 따라 새로운 사용자 이벤트와 알림 유형은 끊임없이 늘어납니다. 이때마다 데이터베이스 스키마를 변경하고 테이블을 추가하는 방식은 운영 리스크를 높이고 개발 속도를 저해하는데, 이 설계는 이를 근본적으로 해결할 수 있는 구조를 보여줍니다.

배경과 맥락

현대적인 애플리케이션 개발에서는 기능의 빠른 출시(Time-to-Market)가 핵심입니다. 특히 핀테크와 같이 다양한 금융 이벤트(목표 달성, 한도 초과 등)가 발생하는 도메인에서는 각 이벤트마다 서로 다른 데이터 구조(Payload)를 처리해야 하는 기술적 과제가 존재합니다.

업계 영향

이러한 '스키마리스(Schemaless)' 접근 방식은 마이크로서비스 아키텍처(MSA) 환경에서 서비스 간 결합도를 낮추고, 새로운 기능을 배포할 때 기존 시스템에 미치는 영향을 최소화합니다. 이는 소프트웨어의 유지보수 비용을 낮추고 시스템의 생존력을 높이는 데 기여합니다.

한국 시장 시사점

빠른 피드백과 기능 업데이트가 생명인 한국의 IT 스타트업들에게, 기술 부채를 최소화하면서도 비즈니스 요구사항에 즉각 대응할 수 있는 '확장 가능한 아키텍처' 설계 역량은 매우 중요한 경쟁 우위 요소가 될 것입니다.

이 글에 대한 큐레이터 의견

스타트업 창업자와 CTO 관점에서 이 설계는 '비용 효율적인 확장성'의 정석을 보여줍니다. 많은 초기 스타트업이 기능 구현에 급급해 경직된 데이터 구조를 설계했다가, 나중에 서비스가 커졌을 때 대규모 마이그레이션이라는 거대한 기술 부채를 마주하곤 합니다. 이 기사에서 제시된 JSON 다형성 활용은 개발 초기 단계에서 약간의 설계 비용을 투자해 미래의 운영 비용을 획기적으로 줄이는 영리한 전략입니다.

특히 주목할 점은 단순한 데이터 저장 방식을 넘어 '제네릭 엔진(Generic Engine)'을 통해 비즈니스 로직의 중복을 제거했다는 점입니다. 이는 개발자가 새로운 알림 타입을 추가할 때 '어떻게 저장할 것인가'가 아니라 '어떤 로직을 실행할 것인가'에만 집중하게 만듭니다. 이는 팀의 생산성을 높이고, 인적 오류를 줄이며, 결과적으로 제품의 품질을 안정적으로 유지할 수 있는 강력한 기반이 됩니다. 따라서 개발팀은 단순 기능 구현을 넘어, 변화에 유연하게 대응할 수 있는 '플러그형(Pluggable) 구조'를 고민해야 합니다.

원문 보기 →