문제(round8 확인 리뷰 RR8-01-01, 회귀):
- GraphQL 매퍼가 원인 사슬의 첫 carrier를 앱이 등록한 매핑보다 먼저
본다. 앱이 GraphQlExceptionResolver에 등록한 실패가 하위 실패(예:
PersistenceFailureException)를 원인으로 들면 등록한 코드 대신 carrier
코드로 답한다(ORDER_UNAVAILABLE 대신 DB_UNAVAILABLE). r8-f1 전에는
등록한 코드였다. 소유자 결정 「감싼 carrier를 전송이 읽는 법」은
"바뀌는 응답은 500 INTERNAL_ERROR이던 경우뿐"을 전제로 했다.
고른 방법(소유자 결정 2026-11-07, 리뷰 README 19.4절 ① (a)):
- 판정 순서를 플랫폼 거부 → 실패 자신이 carrier → 등록된 application
매핑 → 원인 사슬의 첫 carrier → 거부된 인자 → 가림으로 바꾼다.
sharedCodeOf는 실패 자신이 carrier가 아니고 등록 매핑이 있으면 원인
사슬을 보지 않는다. web에서 앱의 도메인 advice가 먼저 받는 것과 같다.
- 로그 줄은 어느 단계가 답하든 원인 사슬의 첫 carrier로 정한다(기본값).
등록 매핑이 답해도 그 안의 서버 쪽 carrier는 그 줄(persistence는 분류
한 줄)을 남긴다. 버린 안: 등록 매핑이 답하면 아무 줄도 남기지 않기
(r8-f1 전 동작) — DB 장애의 흔적이 사라진다.
- 버린 안: (b) 지금 순서를 두고 문서에 적기 — 앱에 원인 버리기를
강요하고 web과 계속 다르다. (c) 등록 매핑을 실패 자신이 carrier인
경우보다도 먼저 — r8-f1 전에도 없던 변화라 범위가 넓다.
- 같은 내용을 GraphQL README·CLAUDE.md, GraphQlExceptionResolver·
ApiErrorCarrier.firstIn Javadoc, shared-contract README, 결정 색인,
업그레이드 안내 B-45·B-46에 적었다.
위험·한계:
- 실패 자신이 carrier인 타입(예: LockAcquisitionTimeoutException)을
등록한 GraphQL 매핑은 계속 쓰이지 않는다. B-45와 resolver Javadoc에
적었다.
- main 대비 GraphQL 응답은 바뀌지 않는다(r8-f1이 아직 main에 없다).
합치지 않은 안내 행 B-45·B-46만 최종 동작으로 고쳤다.
검증(desktop, flock /tmp/claude-gates/heavy.lock, --no-build-cache,
로그 ~/r9-g1-inbound-logs/):
- RED(기준 3eb3b067 + 테스트만, 트리 7c45e303): :adapter:inbound:graphql:test
--tests GraphQlWireErrorMapperTest --tests GraphQlArgumentBindingFailureTest
rc=1, 22건 중 1건 실패
aRegisteredFailureThatKeepsACarrierAsItsCauseIsAnsweredWithItsRegisteredCode
(기대 [ORDER_UNAVAILABLE, BUSINESS], 실제 [DB_UNAVAILABLE, DEPENDENCY]).
지킴 테스트 둘(실패 자신이 carrier인 등록 타입, 등록 매핑이 답해도 남는
carrier 줄)은 기준에서도 통과. red/R1b-graphql.log
- GREEN(이 커밋 트리 d00d1f4d): :adapter:inbound:graphql:check
:shared-contract:check rc=0, graphql 407·shared-contract 269건
실패 0·skip 0, FROM-CACHE 0. green/A1-check.log
- python3 scripts/check-work-docs.py rc=0(이 커밋 트리, 이력 ID 0).
Refs: docs/reviews/2026-11-03-rereview/README.md 19절 RR8-01-01, 19.4절 ①