---
kind: CONCEPT
slug: messaging-reliability-api-c05
title: 실패를 예외가 아니라 상태와 반환값으로 표현한다
topic: state-machines-and-ownership
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:messaging-reliability-api-c05
evidenceCapturedOn: 2026-09-01
assets:
  - key: messaging-reliability-api-c05
    file: ../../../final/evidence/rendered/messaging-reliability-api-c05.svg
evidence:
  - ../../../final/evidence/raw/messaging-reliability-api-c05.txt
source:
  - 원본 분석 절은 final/document.md#a19-messaging-reliability-api#L348 이다.
module: messaging-reliability-api
---

# 실패를 예외가 아니라 상태와 반환값으로 표현한다

이 leaf는 `MessagingException`을 하나도 던지지 않는다. `IllegalArgumentException`을 던지는 곳은 record 생성자 여섯뿐이다.

## 관계

- **계약만 담는 leaf도 계약의 거절 조건은 자기 레인에서 검증한다**
  같은 분석 리프에서 끌어낸 규칙이다.
- **record의 `equals`를 좁히면 이유를 적는다**
  같은 분석 리프에서 끌어낸 규칙이다.
- **호출 컨텍스트가 계약이면 그 컨텍스트를 검증할 수단을 함께 정한다**
  같은 분석 리프에서 끌어낸 규칙이다.

## 본문

<!-- body:start -->

**이 leaf는 `MessagingException`을 하나도 던지지 않는다.** 실패를 상태와 반환값으로 표현한다. `IllegalArgumentException`을 던지는 곳은 record 생성자 여섯이다 — 전부 호출자의 프로그래밍 오류다.

## MessagingException 참조 위치

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

## 예외가 롤백 신호인 자리

`TransactionalMessageAction.apply`가 `throws Exception`이다 — javadoc: "rolling back both it and the inbox reservation". 즉 예외가 롤백 신호이고, 그 처리는 구현 leaf가 소유한다.

<!-- body:end -->