Files
messaging-library/messaging/messaging-spring-boot-starter
DongHyeonka a32b67a2ce fix!: 재리뷰가 찾은 결함과 색인에서 빠졌던 발견 5건을 고친다
문제: 성숙도 리뷰 수정을 다시 읽은 재리뷰(Critical 0, 회귀 0)가
Important 27건·Minor 41건을 찾았다. 수정이 새로 만든 결함이 많았다.
@SystemInvoked가 권한 규칙의 탈출구가 됐고, 데모 계정 거부가 정확히
prod일 때만 걸렸고, outbox 순서 번호가 업그레이드 때 뒤로 갔고,
GraphQL union 아래 복잡도가 0이었고, 서블릿 오류 응답이 success:true로
나갔고, 호출자 deadline이 breaker를 열었다. 원래 리뷰 색인이 06 영역
발견 5건(06-10~14)을 빠뜨려 그동안 처리되지 않았다.

방법: 영역별 7묶음이 test-driven-development 절차로 실패 테스트를
먼저 쓰고 고쳤다. 결정은 재리뷰 README 4절에 적었다: 순서 번호는 V21이
기록한 전역 floor부터, 데모 계정은 local·test·demo 허용 목록,
@SystemInvoked bean은 기동 실패, complete 단계 실패는
IDEMPOTENCY_COMPLETION_UNKNOWN(결과 불명), 캐시 조건부 쓰기는 별도
SCRIPT lane, strict lane 정책은 build cache 입력, 끝나지 않는 재시도
행은 원인 코드·지표·PARKED 절차. 레지스트리가 선언만 하고 아무 코드도
내보내지 않던 redis.capability.* 지표 6개는 빼고 runbook을 실제
지표(redis.lane.*) 기준으로 고쳤다.

위험·한계: V21을 V22 없이 직접 고쳤다(어느 배포에도 아직 없음). 이
브랜치의 V21을 적용한 개발 DB는 다시 만들어야 한다. 서블릿 오류
디스패치를 보안 체인이 허용한다. 발행·저장소 포트 시그니처가 바뀌어
파생 서비스 코드가 깨진다. prod에서 fixture-로 시작하는 설정값은
기동을 막는다. httpclient failure-injection lane의 main 단계 중복
실행은 이전 결정대로 남겼다. 실제 CI runner 실행은 확인하지 못했다.

검증: ci, mainCheck, :integrationCheck, -p optional-platforms ci
integrationCheck performanceCheck, :performanceCheck, :releaseCheck
(-PgitRevision), verify-compose-profile-contracts(18 lane) 통과.
첫 실행의 실패 2건(FindSecBugs 1, sample 동시 생성 테스트의 v4 event
id)은 고친 뒤 ci·integrationCheck·mainCheck를 다시 돌려 통과했다.

Refs: docs/reviews/2026-11-03-rereview/README.md 3·4·6·7절
BREAKING CHANGE: outbox 발행 포트와 저장소 포트 시그니처, 순서 번호
첫 값(V21 floor 다음), 샘플 데모 계정 프로필 허용 목록, 새 오류 코드
IDEMPOTENCY_COMPLETION_UNKNOWN, prod의 fixture- 값 거부, 기동 rule은
static·의존 없음이어야 한다.
2026-11-03 23:29:35 +09:00
..

messaging-spring-boot-starter

아티팩트 분리

기본 messaging-spring-boot-starter는 이제 broker-neutral core다. Kafka client를 production runtime에 직접 넣지 않으며, 브로커 채택은 capability artifact를 composition에 추가하는 build-time 결정이다.

messaging-spring-boot-starter
└─ messaging-spring-boot-starter-kafka   # Kafka client/transport capability
  • 기본 app-bootstrap은 messaging을 싣지 않는다. 서비스는 runtimeOnly project(':adapter:outbound:messaging-kafka') 한 줄로 Kafka capability를 고르고, 그 모듈이 :messaging:messaging-spring-boot-starter-kafka(와 이 core starter)를 runtime으로 끌어온다.
  • starter는 있으면 켜진다(app.messaging.enabled 기본 on). app.messaging.enabled=false로만 끈다.
  • 등록된 broker 계열은 Kafka 하나다. RabbitMQ 설정 키(type: rabbitmq, addresses, prefetch 등)는 transport 없이 바인딩만 되던 키라 삭제했고, 지금은 키 이름을 담아 기동이 거부된다.
  • reliability/admin의 추가 artifact 분리는 별도 구조 개선 여지로 남지만, broker SDK 동시 탑재 문제와 transport 선택 문제는 core/broker capability 분리로 해소했다.
  • legacy R0 outbound bridge도 같은 원칙을 따른다. broker-neutral :adapter:outbound:messaging과 Kafka 전용 :adapter:outbound:messaging-kafka가 분리돼 있다.

현재 broker/runtime 지원 범위

Kafka

Kafka publish runtime은 Kafka capability artifact를 추가한 composition에서만 조립된다. KafkaMessagingTransport는 publish runtime으로 설치되지만, KafkaConsumerRegistrar는 capability starter나 app-bootstrap에서 자동 생성하지 않는다. 따라서 현재 자동조립된 transport에 consume registration을 요청하면 KAFKA_CONSUMER_NOT_CONFIGURED로 실패한다.

consume을 채택하려면 애플리케이션 composition이 별도로 KafkaConsumerRegistrar와 handler sink를 조립해야 한다. leaf 안의 consumer/rebalance/settlement 테스트가 초록이라는 사실은 capability starter가 consumer runtime까지 자동 제공한다는 뜻이 아니다.

RabbitMQ (삭제됨)

production transport가 없어 선택할 수 없던 messaging-rabbit·messaging-spring-boot-starter-rabbit는 2026-09-25에 삭제했다(docs/capability-status.md 제거 표). 현재 등록된 broker는 Kafka 하나다. app.messaging.brokers.<name>.type: rabbitmq 설정 family는 아직 바인딩·검증되지만 소비하는 transport가 없다.