fix(inbound): 인자 변환 실패는 원인의 carrier와 상관없이 거부로 본다
문제(round8 리뷰 01 「Declined to judge」, 리뷰 README 19.4절 ④): - 결정 「감싼 carrier를 전송이 읽는 법」이 인자 변환 단계까지 덮는지 정해지지 않았다. STOMP advice는 @DestinationVariable·@Header의 ConversionFailedException과 받은 메시지가 실린 MessageConversionException의 원인에 carrier가 있으면 거부 WARN 한 줄 대신 그 carrier의 줄(5xx면 ERROR와 예외)을 남긴다. web은 같은 실패에 원인을 보지 않고 BAD_PARAMETER·VALIDATION_FAILED로 답한다. 고른 방법(소유자 결정 2026-11-07, ④ (a)): - 인자 변환 단계는 carrier를 보지 않는다. StompHandlerFailureLog가 거부 판정(clientRefusalOf)을 원인 사슬의 carrier 검색보다 먼저 한다. 응답 프레임은 그대로다(handler 경로는 프레임을 보내지 않는다). - web은 지금 동작이 결정과 같아 코드를 바꾸지 않았다. 경로 변수 변환기와 Jackson creator가 carrier를 던지는 지킴 테스트 둘을 더하고, handleTypeMismatch·handleHttpMessageNotReadable Javadoc에 이유를 적었다. - GraphQL @Argument binder는 변환기가 던진 실패를 binding result에 담고 BindException의 원인으로 싣지 않아, carrier를 던져도 BAD_PARAMETER다. 실제 binder 경로 지킴 테스트 하나와 매퍼 Javadoc·README 한 줄. - 버린 안: (b) 세 전송의 변환 단계가 원인의 carrier를 먼저 본다 — 요청 형식 오류의 코드가 변환기 구현에 따라 바뀐다. 위험·한계: - 바뀌는 것은 STOMP 로그 줄뿐이다. 템플릿에는 carrier를 던지는 변환기가 없다. 안내 B-46에 적었다. - GraphQL 지킴 테스트는 Spring for GraphQL 2.0.5 binder의 동작에 기댄다. binder가 원인을 싣게 바뀌면 그 테스트가 실패한다. 검증(desktop, flock, --no-build-cache, 로그 ~/r9-g1-inbound-logs/): - RED(기준3eb3b067+ 테스트만, 트리 4feb83c6): :adapter:inbound:websocket:test --tests StompHandlerFailureLogTest rc=1, 13건 중 2건 실패. 두 경우 모두 기대 WARN "request refused as VALIDATION_FAILED|BAD_PARAMETER by <변환 예외>", 실제 ERROR "persistence failure classified as DB_UNAVAILABLE ...". red/R2c-websocket.log - 지킴(RED 없음 — 지금 동작이 결정과 같다): web TransportErrorHandlingTest 12건(red/R3c-web-guard.log)과 GraphQlArgumentBindingFailureTest (트리 7c45e303, red/R1b-graphql.log)가 기준 커밋에서 통과. 변이: handleTypeMismatch가 원인의 carrier를 먼저 보게 바꾸면 12건 중 1건 (경로 변수) 실패, 400 대신 503. red/R7c-web-guard-mutant.log - GREEN(이 커밋 트리1a5b4a8f): :adapter:inbound:websocket:check :adapter:inbound:web:check :adapter:inbound:graphql:check :shared-contract:check rc=0, websocket 107·web 343·graphql 408· shared-contract 269건 실패 0·skip 0, FROM-CACHE 0. green2/B1-check.log - testQualityCheck 첫 실행(green/D16)에서 이 커밋의 테스트 record 둘 (Signup, `if (email != null)`)이 SpotBugs NP_LOAD_OF_KNOWN_NULL_VALUE로 걸려 `!email.isEmpty()`로 고쳤다. 고친 테스트로 RED·지킴·변이를 다시 돌렸고(위 R2c·R3c·R7c), 마지막 트리에서 web·websocket spotbugsTest가 실행되어 통과했다(green2/D16). Refs: docs/reviews/2026-11-03-rereview/README.md 19.4절 ④, round8/01-transport-errors.md 「Declined to judge」
This commit is contained in:
@@ -91,8 +91,9 @@
|
||||
| Draft-12 offset 불일치 | problem 문서는 프로토콜 예외로 유지 | 소유자 | 결정 12 |
|
||||
| 알림 category 생략 | 거부(400), 판정은 유스케이스 | 소유자 | 결정 13 |
|
||||
| 오류 코드 로그 레벨 | `error-codes.yaml`에 `log_level` 칸을 두지 않는다. 레벨은 실패 종류·경로가 정한다(`ServerFailureLog`, 보안 필터 `AuthErrorResponseWriter`). 칸이 다시 생기면 `OperationalErrorRegistryContractTest`가 실패한다. 보안 필터는 5xx(`AUTH_JWKS_UNAVAILABLE`·`INTERNAL_AUTH_MISCONFIGURATION`)를 ERROR, 4xx를 WARN으로 남긴다. 401 서명·issuer·audience 불일치는 WARN | 소유자 | 2026-11-06, `docs/superpowers/specs/2026-11-06-error-code-log-level-design.md` 10절 |
|
||||
| 감싼 carrier를 전송이 읽는 법 | web·GraphQL·STOMP·gRPC 네 전송 모두 원인 사슬의 첫 carrier를 본다. 감싼 carrier의 응답이 500 `INTERNAL_ERROR` 대신 그 carrier의 코드가 된다. 그보다 먼저 답하는 것은 아래 「GraphQL 판정 순서」 행(등록 매핑)이다 | 소유자 | `1103` 18.4절(RR7-01-05), 2026-11-06 |
|
||||
| 감싼 carrier를 전송이 읽는 법 | web·GraphQL·STOMP·gRPC 네 전송 모두 원인 사슬의 첫 carrier를 본다. 감싼 carrier의 응답이 500 `INTERNAL_ERROR` 대신 그 carrier의 코드가 된다. 그보다 먼저 답하는 것은 아래 「GraphQL 판정 순서」(등록 매핑)와 「인자 변환 단계의 감싼 carrier」 두 행이다 | 소유자 | `1103` 18.4절(RR7-01-05), 2026-11-06 |
|
||||
| GraphQL 판정 순서 | 플랫폼 거부 → 실패 자신이 carrier → 등록된 application 매핑 → 원인 사슬의 첫 carrier → 거부된 인자(`IllegalArgumentException`, 인자 binder의 `BindException`) → 가림(`INTERNAL_ERROR`). 앱이 등록한 실패는 carrier를 원인으로 들어도 등록한 코드로 답한다(web에서 앱의 도메인 advice가 먼저 받는 것과 같다). 실패 자신이 carrier인 타입(예: `LockAcquisitionTimeoutException`)을 등록한 매핑은 쓰이지 않는다. 로그 줄은 어느 단계가 답하든 원인 사슬의 첫 carrier로 정한다 — 등록 매핑이 답해도 그 안의 서버 쪽 carrier 줄은 남는다 | 소유자(2026-11-07). 로그 줄은 기본값(2026-11-07) | `1103` 19.4절 ①(RR8-01-01), 2026-11-07 총괄 세션 전달 |
|
||||
| 인자 변환 단계의 감싼 carrier | 「감싼 carrier를 전송이 읽는 법」은 인자 변환 단계를 덮지 않는다. web `MethodArgumentTypeMismatchException`·`HttpMessageNotReadableException`과 GraphQL `@Argument` binder 실패는 원인에 carrier가 있어도 `BAD_PARAMETER`·`VALIDATION_FAILED`다. STOMP는 `@DestinationVariable`·`@Header`의 `ConversionFailedException`과 받은 메시지가 실린 `MessageConversionException`을 원인 사슬의 carrier보다 먼저 거부로 보고 WARN 한 줄(타입만)을 남긴다. 요청 형식 오류의 코드는 전송이 정한다 | 소유자(2026-11-07) | `1103` 19.4절 ④(round8/01 「Declined to judge」), 2026-11-07 총괄 세션 전달 |
|
||||
| `Retry-After` 값 | web `RetryAfterAdvisor` 표는 레지스트리 `retry_after_seconds` 칸과 코드마다 같다. 빠져 있던 7개(`DB_UNAVAILABLE` 5, `DB_SERIALIZATION_FAILURE` 1, `DB_DEADLOCK` 1, `DB_IDLE_IN_TX_TIMEOUT` 2, `OUTBOX_PUBLISH_FAILED` 30, `JOB_EXECUTOR_REJECTED` 5, `JOB_TIMEOUT` 10)를 채웠고, `OperationalErrorRegistryContractTest`가 둘을 대조한다 | 소유자 | 2026-11-07 총괄 세션 전달(소유자 원문 "권하는 안대로"), r8-f1 보고 「범위 밖」 1 |
|
||||
| GraphQL 인자 변환 실패 | Spring GraphQL 인자 binder의 `BindException`(`@Argument` 값이 파라미터 타입으로 바뀌지 않음)은 `BAD_PARAMETER`(`REQUEST`)로 답하고, WARN 한 줄(예외 타입만, 입력값 없음)을 남긴다. web이 바뀌지 않는 경로 변수에 답하는 것과 같다 | 소유자 | 2026-11-07 같은 전달, r8-f1 보고 「범위 밖」 2 |
|
||||
| 약속한 응답으로 맞추기 | 레지스트리·`docs/web/http-contract.md`·Javadoc이 이미 약속한 응답으로 코드를 맞추는 것은 결함 수정이다. 고치기 전에 묻지 않고, 응답이 바뀌니 업그레이드 안내 행은 적는다. 약속한 곳끼리 다르면 묻는다 | 기본값(2026-11-07) | `docs/work/improve.md` 7절, `docs/work/evidence.md` 11절 |
|
||||
|
||||
Reference in New Issue
Block a user