fix(inbound)!: Retry-After를 레지스트리대로 붙이고 GraphQL 인자 거부를 맞춘다
문제(r8-f1 보고의 범위 밖 1·2, 소유자 답 2026-11-07 "권하는 안대로"): - 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). 그래서 DB 일시 실패 응답에 Retry-After가 없다. 대조하는 테스트가 없었다: advisor 단위 테스트는 값을 코드마다 손으로 옮겼고, enum·레지스트리 대조 테스트는 category· status·retryable만 봤다. - GraphQL @Argument 값이 파라미터 타입으로 바뀌지 않으면 Spring 인자 binder가 BindException을 던지는데, 매퍼가 모르는 타입이라 INTERNAL_ERROR로 가리고 예외째 ERROR로 남긴다. 그 메시지에 rejected value [...]가 실린다. 고친 것: - RetryAfterAdvisor 표를 Map.ofEntries로 바꾸고 7개를 채웠다(Map.of는 10쌍이 상한). OperationalErrorRegistryContractTest(document-contract)에 OperationalError마다 RetryAfterAdvisor.retryAfterSeconds와 레지스트리 값이 같은지 보는 테스트를 더했다. 버린 안: advisor가 레지스트리를 런타임에 읽는 것 — web leaf가 저장소 파일을 읽게 되고 jar에 실리지 않는다. - GraphQlWireErrorMapper가 BindException을 IllegalArgumentException과 같은 "거부된 인자"로 본다: 등록된 매핑이 없으면 BAD_PARAMETER(REQUEST), 로그는 ServerFailureLog.refused의 WARN 한 줄(타입만). web이 바뀌지 않는 경로 변수에 답하는 것과 같다. - 결정 색인 2.3절에 두 결정과 STOMP 필수 header 누락을 ERROR로 두는 기본값(이유 포함)을 적었다. 업그레이드 안내 B-47·B-48. 위험·한계: - 응답이 바뀐다: DB 일시 실패 넷에 Retry-After가 생기고, GraphQL 인자 변환 실패가 INTERNAL_ERROR → BAD_PARAMETER. - 대조 테스트는 OperationalError 코드만 본다. 다른 leaf의 코드는 RetryAfterHint로 자기 값을 말한다(대조 대상 아님). - BindException은 binder가 인자 변환을 모아 던질 때만 온다. @Valid 검증(ConstraintViolationException)은 이 leaf에 Bean Validation이 없어 다루지 않았다. 검증(desktop, flock /tmp/claude-gates/heavy.lock, 로그 ~/r8-f1-logs/round2/): - RED(5f6a86d7+ 테스트만): 11건 실패. advisor 7개 코드 empty, 레지스트리 대조 1건, GraphQL 3건(INTERNAL_ERROR, ERROR "graphql failure masked" + BindException "rejected value [alice@example.com]"). round2/red.log - 이 트리(ca44d3fc): :ci :verifyDependencyLocks --warning-mode=fail rc=0 (web test 341, graphql test 404, app-bootstrap test 225 skip 4 이전부터, architectureTest, verifyGraphQlApiSurface 포함) - :sample-portfolio:check :sample-portfolio:qualityCheck rc=0 - :verifyStrictLaneStages --dry-run 두 빌드 rc=0, -p optional-platforms ci rc=0 - web·graphql systemTest, :conditionalTransportQualification rc=0 - :app-bootstrap:documentContractTest rc=0(67) - web·graphql·app-bootstrap testQualityCheck rc=0 - scripts/verify-compose-profile-contracts.sh rc=0, scripts/check-work-docs.py rc=0 BREAKING CHANGE: DB_UNAVAILABLE(5초)·DB_SERIALIZATION_FAILURE(1초)· DB_DEADLOCK(1초)·DB_IDLE_IN_TX_TIMEOUT(2초) 응답에 Retry-After가 붙고, GraphQL @Argument 변환 실패는 INTERNAL_ERROR 대신 BAD_PARAMETER로 답한다. 업그레이드 안내 B-47·B-48. Refs: docs/work/reference/decisions.md 2.3절, docs/upgrade/2026-11-maturity-review.md B-47, B-48
This commit is contained in:
+48
@@ -2,9 +2,11 @@ package dev.caskeleton.bootstrap.contract;
|
||||
|
||||
import static org.assertj.core.api.Assertions.assertThat;
|
||||
|
||||
import dev.caskeleton.adapter.inbound.web.observability.RetryAfterAdvisor;
|
||||
import dev.caskeleton.bootstrap.contract.support.RepositoryContractResources;
|
||||
import dev.caskeleton.shared.error.Category;
|
||||
import dev.caskeleton.shared.error.ClientErrorMessages;
|
||||
import dev.caskeleton.shared.error.OperationalError;
|
||||
import java.io.IOException;
|
||||
import java.io.UncheckedIOException;
|
||||
import java.nio.file.Files;
|
||||
@@ -12,7 +14,9 @@ import java.nio.file.Path;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.OptionalInt;
|
||||
import java.util.Set;
|
||||
import java.util.TreeMap;
|
||||
import java.util.TreeSet;
|
||||
import java.util.regex.Matcher;
|
||||
import java.util.regex.Pattern;
|
||||
@@ -117,6 +121,50 @@ class OperationalErrorRegistryContractTest {
|
||||
.isEmpty();
|
||||
}
|
||||
|
||||
/**
|
||||
* {@code RetryAfterAdvisor} is the one place the web adapter turns a code into a {@code
|
||||
* Retry-After} header, and its table copies the registry's {@code retry_after_seconds} column.
|
||||
* The enum-registry comparison above covers category, status and retryability only, and the
|
||||
* advisor's unit tests copy values code by code, so seven registered delays were missing from the
|
||||
* table and nothing failed (review 2026-11-07). This compares every code: a registered delay is
|
||||
* the header, and no registered delay is no header.
|
||||
*/
|
||||
@Test
|
||||
void everyRegisteredRetryAfterIsTheHeaderTheWebAdapterSends() {
|
||||
// given
|
||||
Map<String, Map<?, ?>> rows = registryRowsByCode();
|
||||
Map<String, String> registered = new TreeMap<>();
|
||||
Map<String, String> advised = new TreeMap<>();
|
||||
|
||||
// when
|
||||
for (OperationalError code : OperationalError.values()) {
|
||||
Object seconds = rows.getOrDefault(code.code(), Map.of()).get("retry_after_seconds");
|
||||
registered.put(code.code(), seconds == null ? "none" : String.valueOf(seconds));
|
||||
OptionalInt header = RetryAfterAdvisor.retryAfterSeconds(code);
|
||||
advised.put(code.code(), header.isPresent() ? String.valueOf(header.getAsInt()) : "none");
|
||||
}
|
||||
|
||||
// then
|
||||
assertThat(advised).isNotEmpty().isEqualTo(registered);
|
||||
}
|
||||
|
||||
/** Every registry row with a code, from every section, by its code. */
|
||||
@SuppressWarnings("unchecked")
|
||||
private static Map<String, Map<?, ?>> registryRowsByCode() {
|
||||
Object loaded = new Yaml(new SafeConstructor(new LoaderOptions())).load(read(REGISTRY));
|
||||
Map<String, Map<?, ?>> rows = new LinkedHashMap<>();
|
||||
for (Object section : ((Map<String, Object>) loaded).values()) {
|
||||
if (section instanceof List<?> entries) {
|
||||
for (Object entry : entries) {
|
||||
if (entry instanceof Map<?, ?> row && row.get("code") instanceof String code) {
|
||||
rows.put(code, row);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return rows;
|
||||
}
|
||||
|
||||
@SuppressWarnings("unchecked")
|
||||
private static List<Map<String, Object>> registryRows() {
|
||||
Object loaded = new Yaml(new SafeConstructor(new LoaderOptions())).load(read(REGISTRY));
|
||||
|
||||
Reference in New Issue
Block a user