---
kind: CASE
slug: messaging-spring-boot-starter-f03
title: 죽은 매개변수 하나가 유일한 비기본값에서 NPE 를 낳는다
topic: runtime-contract-correctness
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: case:messaging-spring-boot-starter-f03
evidenceCapturedOn: 2026-09-01
assets:
  - key: messaging-spring-boot-starter-f03
    file: ../../../final/evidence/rendered/messaging-spring-boot-starter-f03.svg
evidence:
  - ../../../final/evidence/raw/messaging-spring-boot-starter-f03.txt
source:
  - 원본 분석 절은 final/document.md#a19-messaging-spring-boot-starter#L319 이다.
module: messaging-spring-boot-starter
priority: P3
---

# 죽은 매개변수 하나가 유일한 비기본값에서 NPE 를 낳는다

호출처가 셋이고 전부 () -> true 다. 그래서 이 매개변수는 값을 하나만 갖는다.

## 관계

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

## 문제

호출처가 셋이고 전부 () -> true 다.

그래서 이 매개변수는 값을 하나만 갖는다.

## 결론

그리고 그것이 죽어 있다는 것보다 나쁜 성질이 있다 — 이 매개변수가 존재하는 이유("이 역할은 선택적이다")대로 () -> false 를 넘기면 credential == null 인 경로가 가드를 지나 다음 줄의 credential.type() 에서 NPE 로 죽는다.

즉 이 매개변수의 유일한 비기본값이 의도한 동작이 아니라 널 역참조다.

수정은 매개변수를 지우고 널 검사를 무조건으로 만드는 것이다.

선택적 역할이 필요해지는 날에는 Optional 을 돌려주는 별도 메서드가 그 자리다 — admin 이 이미 호출처에서 그렇게 다뤄진다.

## 검증 환경

OpenJDK : 21.0.12   java -version 으로 확인
Gradle : 9.0.0      src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인
확인 방식 : 이 매개변수의 호출처 셋을 전수 확인해 넘어오는 값의 종류 집계
소스 수정 : x

## 재현 조건

원문은 final/document.md#a19-messaging-spring-boot-starter#L319 에 있다.

## 본문

<!-- body:start -->

호출처가 셋이고 전부 `() -> true` 다. 그래서 이 매개변수는 값을 하나만 갖는다.

## 매개변수가 갖는 값의 개수

:::evidence key="messaging-spring-boot-starter-f03" alt="분석 문서 final/document.md#a19-messaging-spring-boot-starter 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a19-messaging-spring-boot-starter 발췌 — 15줄" zoom="true"
:::

## 죽어 있다는 것보다 나쁜 성질

이 매개변수가 존재하는 이유("이 역할은 선택적이다")대로 `() -> false` 를 넘기면 `credential == null` 인 경로가 가드를 지나 다음 줄의 `credential.type()` 에서 NPE 로 죽는다. 즉 이 매개변수의 유일한 비기본값이 의도한 동작이 아니라 널 역참조다.

## 수정

매개변수를 지우고 널 검사를 무조건으로 만든다. 선택적 역할이 필요해지는 날에는 `Optional` 을 돌려주는 별도 메서드가 그 자리다 — `admin` 이 이미 호출처에서 그렇게 다뤄진다.

## 확인하지 못한 것

기본값이 아닌 값을 넘겨 NPE 를 재현하지 않았다. 호출처 셋이 전부 같은 값을 넘긴다는 것과 본문의 널 취급으로 판정했다.

<!-- body:end -->