---
kind: CASE
slug: messaging-spring-boot-starter-f04
title: 설정 경로의 재시도가 예외 분류를 표현할 수 없다
topic: declaration-and-document-drift
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: case:messaging-spring-boot-starter-f04
evidenceCapturedOn: 2026-09-01
assets:
  - key: messaging-spring-boot-starter-f04
    file: ../../../final/evidence/rendered/messaging-spring-boot-starter-f04.svg
evidence:
  - ../../../final/evidence/raw/messaging-spring-boot-starter-f04.txt
source:
  - 원본 분석 절은 analysis/messaging/messaging-spring-boot-starter.md#L342 이다.
module: messaging-spring-boot-starter
priority: P3
---

# 설정 경로의 재시도가 예외 분류를 표현할 수 없다

RetryPolicy 는 성분 열이고 그중 둘이 분류 집합이다. DestinationSettings.Retry 에는 이 둘에 대응하는 키가 없고, 컴파일러가 상수로 채운다.

## 관계

- **검증기는 발행이 아니라 주입이 강제다**
  같은 분석 리프에서 끌어낸 규칙이다.

## 문제

RetryPolicy 는 성분 열이고 그중 둘이 분류 집합이다.

DestinationSettings.Retry 에는 이 둘에 대응하는 키가 없고, 컴파일러가 상수로 채운다.

## 결론

빈 집합은 "기본 분류 그대로" 라는 중립값이므로 오동작은 아니다.

문제는 비대칭이다.

DestinationProfile 을 자바로 선언한 배포는 두 집합을 조정할 수 있고, 문서대로 YAML 로 설정한 배포는 할 수 없다.

이 리프가 반복해서 근거로 든 규칙이 정확히 그 비대칭을 금지한다.

수정은 Retry 에 두 키를 더하는 것이다.

FailureCategory 는 열거이므로 relaxed binding 이 그대로 처리한다.

## 검증 환경

OpenJDK : 21.0.12   java -version 으로 확인
Gradle : 9.0.0      src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인
확인 방식 : RetryPolicy 참조 36건 검색과 설정 record 의 키 목록 대조
소스 수정 : x

## 재현 조건

원문은 analysis/messaging/messaging-spring-boot-starter.md#L342 에 있다.

## 본문

<!-- body:start -->

`RetryPolicy` 는 성분 열이고 그중 둘이 분류 집합이다. `DestinationSettings.Retry` 에는 이 둘에 대응하는 키가 없고, 컴파일러가 상수로 채운다.

## RetryPolicy 참조 위치

:::evidence key="messaging-spring-boot-starter-f04" alt="코드베이스에서 RetryPolicy 를 검색한 출력 36줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="RetryPolicy 코드베이스 검색 — 36줄 · exit 0" zoom="true"
:::

## 오동작은 아니다

빈 집합은 "기본 분류 그대로" 라는 중립값이다.

## 문제는 비대칭이다

`DestinationProfile` 을 자바로 선언한 배포는 두 집합을 조정할 수 있고, 문서대로 YAML 로 설정한 배포는 할 수 없다. 이 리프가 반복해서 근거로 든 규칙이 정확히 그 비대칭을 금지한다. 수정은 `Retry` 에 두 키를 더하는 것이다 — `FailureCategory` 는 열거이므로 relaxed binding 이 그대로 처리한다.

## 확인하지 못한 것

설정으로 분류를 지정해 무시되는 것을 실행으로 확인하지 않았다. 대응 키가 없어 컴파일러가 상수로 채운다는 것으로 판정했다.

<!-- body:end -->