Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/state-ownership-and-concurrency/case/case-grpc-client-f01.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 grpc-client-f01 rotate 가 비교 후 교체가 아니라 덮어쓰기다 state-ownership-and-concurrency clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 case:grpc-client-f01 2026-09-01
key file
grpc-client-f01 ../../../final/evidence/rendered/grpc-client-f01.svg
key file
grpc-client-f01-diagram ../../../final/assets/diagrams/grpc-client-f01.svg
../../../final/evidence/raw/grpc-client-f01.txt
원본 분석 절은 final/document.md#a20-grpc-client#L120 이다.
grpc-client P2

rotate 가 비교 후 교체가 아니라 덮어쓰기다

install 은 정확하다. rotate 는 그렇지 않다.

문제

install 은 정확하다.

rotate 는 그렇지 않다.

결론

두 회전이 동시에 들어오면 둘 다 같은 previous 를 읽고, 둘 다 대체본을 만들고, 나중 set 이 앞의 대체본을 덮는다.

덮인 대체본은 어디에도 등록되지 않는다 — draining 목록에 들어가는 것은 previous 뿐이다.

그러므로 그 세대는 배수도 회수도 되지 않고, 그 위에서 시작된 호출은 아무도 세지 않는다.

클래스가 이 문제를 인지하고 있다는 증거가 같은 파일에 있다 — install 의 비교 후 교체와 AtomicReference 선택이다.

회전 쪽만 그 규율에서 벗어나 있다.

수정은 holder.compareAndSet(previous, replacement) 로 바꾸고 실패 시 다시 읽어 판정하거나 던지는 것이다.

검증 환경

OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : install 과 rotate 두 경로의 읽기·쓰기 원자성 대조 소스 수정 : x

재현 조건

원문은 final/document.md#a20-grpc-client#L120 에 있다.

본문

install 은 정확하다. rotate 는 그렇지 않다.

경합이 끼는 자리

:::evidence key="grpc-client-f01-diagram" alt="동시 회전 둘이 같은 previous 읽기와 나중 set 이 덮음을 지나 덮인 세대 미등록으로 이어진다" caption="경합이 끼는 자리" zoom="false" :::

두 회전이 동시에 들어오면 둘 다 같은 previous 를 읽고, 둘 다 대체본을 만들고, 나중 set 이 앞의 대체본을 덮는다.

install 과 rotate 의 차이

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

덮인 대체본은 어디에도 등록되지 않는다

draining 목록에 들어가는 것은 previous 뿐이다. 그러므로 그 세대는 배수도 회수도 되지 않고, 그 위에서 시작된 호출은 아무도 세지 않는다.

클래스가 이 문제를 인지한다는 증거

같은 파일의 install 이 비교 후 교체를 쓰고 AtomicReference 를 골랐다. 회전 쪽만 그 규율에서 벗어나 있다. 수정은 holder.compareAndSet(previous, replacement) 로 바꾸고 실패 시 다시 읽어 판정하거나 던지는 것이다.

확인하지 못한 것

실제 채널을 만들어 회전시키지 않았다. ManagedChannel 을 만드는 코드가 이 리프에 없다.