Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/runtime-contract-correctness/case/case-messaging-spring-boot-starter-f03.md
T
DongHyeonkaandClaude Fable 5.1 b25357c48a docs(clean-architecture-backend-template): fold analysis into final and re-select one topic
- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다
- 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5
  (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를
  techviz 로 만들었다
- 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs
  돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다.
  Concept 이 인용한 코드가 SSOT 에 없어 뺐다
- candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00

3.5 KiB

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

본문

호출처가 셋이고 전부 () -> 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 를 재현하지 않았다. 호출처 셋이 전부 같은 값을 넘긴다는 것과 본문의 널 취급으로 판정했다.