GM 오락실
work · 커머스 플랫폼

MSA 서비스 · 알림 · 이벤트 API

Spring Boot MSA 서비스 정리와, 레거시와 맞물린 알림 메시지 · 이벤트 API 작업.

2026.08 – 2026.09백엔드
MSA 서비스 작업
MSA 서비스 작업
JWT
인증 전환
다중
DataSource (JPA)
1,400B
알림 분할 발송 기준
Feign
레거시 이벤트 API 연결

01개요

모놀리스에서 Spring Boot MSA로 옮겨 가는 중인 서비스들의 인증 · 설정 · 배포 문제를 정리했습니다.

알림 메시지와 프로모션 이벤트처럼 레거시 기능과 새 서비스가 같이 걸리는 작업에서는, 어디까지를 한 트랜잭션으로 묶을지를 먼저 정했습니다.

02기술 스택

백엔드
Spring Boot · JPASpring Cloud OpenFeign@ConfigurationPropertiesKubernetes

03만든 것들

한 일
  • JWT 기반 인증 전환과 게이트웨이 목(mock) 구성
  • 상품 서비스 다중 데이터소스 JPA 설정, 알림 서비스의 모듈 간 의존성 제거
  • @ConfigurationProperties 기반 설정 정리, 쿠버네티스 뒤에서 만든 URL 문제 해결
  • 선물 알림 메시지에 상품이 여러 개면 내부 구분자가 그대로 보이던 문제 — 받는 사람별로 상품 묶음을 나눠 보내는 분할 발송
  • 댓글 등록과 포인트 지급을 연동한 프로모션 API, 레거시 이벤트 API는 Feign 클라이언트로

04문제와 해결

다중 DataSource 에서 빈 이름 충돌

문제
데이터소스를 하나 더 붙이자 애플리케이션이 뜨지 않았다.
원인
두 설정 클래스의 @Bean 메서드 이름(곧 빈 이름)이 같았고, 빈 덮어쓰기는 기본으로 막혀 있다.
해결
데이터소스마다 DataSource · EntityManagerFactory · TransactionManager 를 접두사 붙은 이름으로 만들고 리포지토리 패키지를 나눴다. 주 DB 쪽에만 @Primary, 보조 DB 트랜잭션은 이름을 명시한다.

http://내부주소 로 나오던 링크

문제
서버에서 만든 절대 URL이 사용자에게 내부 주소 · http로 나갔다.
원인
쿠버네티스 인그레스 뒤에서 요청 원래의 호스트 · 프로토콜(전달 헤더)을 쓰지 않았다.
해결
전달 헤더를 반영하도록 설정해 바깥 주소 기준으로 URL을 만들게 했다.

알림 길이 제한

문제
상품이 많은 선물 알림이 길이 제한에 걸리거나 구분자가 노출됐다.
원인
분할 발송 로직이 없었다.
해결
다른 템플릿의 표시 방식(분할 발송 / 「외 N개」 축약)을 비교한 뒤 분할 발송으로 정하고, 고정 문구가 가장 긴 템플릿 기준으로 1,400바이트 임계값을 잡았다.

댓글은 항상, 포인트는 처음만

문제
포인트 지급이 실패하면 댓글까지 사라지거나, 같은 사람이 포인트를 여러 번 받을 수 있었다.
원인
댓글 저장과 포인트 지급이 한 트랜잭션으로 묶여 있었다.
해결
댓글은 항상 저장하고, 포인트는 첫 참여가 성공했을 때만 지급되도록 처리 순서와 트랜잭션 경계를 나눴다.

05관련 회고

  • Spring Boot 다중 DataSource 설정에서 빈 이름이 충돌할 때
  • 쿠버네티스 뒤에서 만든 URL이 http://내부주소로 나올 때
  • 알림 메시지 길이 제한: 상품 목록을 바이트 단위로 나눠 보내기
  • 댓글은 항상 저장, 포인트는 첫 참여만: 트랜잭션 경계 나누기
프로젝트 회고 보기 →
Gunmo Lee
since 2021.07