Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/schema-and-data-contracts/case/case-grpc-advanced-bootstrap-f05.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.3 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 grpc-advanced-bootstrap-f05 예외가 들고 있는 능력이 transient 라 역직렬화 뒤 사라진다 schema-and-data-contracts clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 case:grpc-advanced-bootstrap-f05 2026-09-01
key file
grpc-advanced-bootstrap-f05 ../../../final/evidence/rendered/grpc-advanced-bootstrap-f05.svg
../../../final/evidence/raw/grpc-advanced-bootstrap-f05.txt
원본 분석 절은 final/document.md#a20-grpc-advanced-bootstrap#L312 이다.
grpc-advanced-bootstrap P3

예외가 들고 있는 능력이 transient 라 역직렬화 뒤 사라진다

transient 는 보통 직렬화 가능하지 않은 필드를 담은 Serializable 클래스에 대한 정적 분석 경고를 끄려고 붙인다. 그런데 열거형은 언제나 직렬화 가능하다 — 여기서 transient 가 막을 문제가 애초에 없다.

문제

transient 는 보통 직렬화 가능하지 않은 필드를 담은 Serializable 클래스에 대한 정적 분석 경고를 끄려고 붙인다.

그런데 열거형은 언제나 직렬화 가능하다 — 여기서 transient 가 막을 문제가 애초에 없다.

결론

대가는 있다.

예외가 직렬화를 거쳐 오면 capability() 가 null 이다.

메시지 문자열은 살아남으므로 사람이 읽는 데는 지장이 없고, 그래서 눈에 띄지 않는다.

이 예외를 던지는 require 자체가 리프 밖에서 불리지 않으므로(§12.1) 오늘 도달하지 않는다.

transient 를 지우는 것이 수정 전부다.

검증 환경

OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : Serializable 참조 8건 검색과 예외 필드의 transient 선언 및 열거형 직렬화 성질 확인 소스 수정 : x

재현 조건

원문은 final/document.md#a20-grpc-advanced-bootstrap#L312 에 있다.

본문

transient 는 보통 직렬화 가능하지 않은 필드를 담은 Serializable 클래스에 대한 정적 분석 경고를 끄려고 붙인다. 그런데 열거형은 언제나 직렬화 가능하다 — 여기서 transient 가 막을 문제가 애초에 없다.

Serializable 참조 위치

:::evidence key="grpc-advanced-bootstrap-f05" alt="코드베이스에서 Serializable 를 검색한 출력 8줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="Serializable 코드베이스 검색 — 8줄 · exit 0" zoom="true" :::

대가는 있다

예외가 직렬화를 거쳐 오면 capability()null 이다. 메시지 문자열은 살아남으므로 사람이 읽는 데는 지장이 없고, 그래서 눈에 띄지 않는다. 이 예외를 던지는 require 자체가 리프 밖에서 불리지 않으므로(§12.1) 오늘 도달하지 않는다.

수정

transient 를 지우는 것이 전부다.

확인하지 못한 것

실제로 직렬화·역직렬화해 능력이 사라지는 것을 관측하지 않았다. 열거형이 언제나 직렬화 가능하다는 것과 transient 선언의 대조로 판정했다.