fix(idempotency)!: 적용한 핸들의 재전송을 전이 종류와 인자로 가린다
문제: 전이를 적용한 핸들이 그 전이를 다시 보낼 때 세 저장소가 서로, 그리고 포트 Javadoc과 다르게 답한다(재리뷰 round8 RR8-04-01·02, 같은 원인). - markFailed를 다른 disposition으로 다시 보내면 fake·Redis·PostgreSQL 모두 NOT_OWNER다. 기록을 남이 가져갔다는 틀린 신호이고 Javadoc은 OPERATION_CONFLICT라고 적는다. - retention만 다르면 fake·Redis는 ALREADY_MARKED_SAME_OPERATION, PostgreSQL은 fail digest에 retention이 들어 있어 OPERATION_CONFLICT다. - Redis는 start가 돌려준 핸들로 renew한 뒤 그 핸들로 start를 보내면 ALREADY_STARTED_SAME_OPERATION으로 답한다. renew도 기록을 EXECUTING· revision+1로 두어 TRANSITION이 상태와 revision만으로는 start와 구별하지 못한다. executor는 그 답에 action을 실행해 이미 도는 작업을 한 번 더 돌린다. fake·PostgreSQL은 NOT_OWNER다. 원인은 하나다. "적용한 핸들"을 revision 하나로만 가리고 전이 종류와 인자를 같이 보지 않는다. 방법: 소유자 결정(2026-11-07, 1103 README 19.4절 ② (a))대로 다른 disposition은 OPERATION_CONFLICT, 다른 retention은 "이미 처리됨"으로 맞춘다. retention은 complete의 replay TTL처럼 결과를 얼마나 보관하나일 뿐이라 비교하지 않는다. - Redis: 기록 hash에 lastKind(CLAIM·START·RENEW·COMPLETE·FAIL)를 남긴다. TRANSITION의 재전송 판정은 "rev == 핸들 rev + 1 그리고 lastKind == 이 전이"다. 그 안에서 상태가 목표면 ALREADY, 아니면(다른 disposition의 실패) OPERATION_CONFLICT. claim·takeover는 CLAIM을 써 넘겨받기 전 종류가 남지 않게 한다. 어댑터가 전이 종류를 9번째 인자로 보낸다. 명령 fake를 같이 고친다. - PostgreSQL: fail 재생 판정이 두 실패 종류(FAIL_RETRYABLE·FAIL_ABANDONED)를 모두 실패의 재생으로 읽는다. fail digest에서 retention을 뺀다. - fake: 적용한 핸들의 markFailed 재전송에 disposition이 다르면 OPERATION_CONFLICT. - 공유 계약 IdempotencyStoreContract에 케이스 셋(다른 retention, 다른 disposition과 기록 유지, renew 뒤 같은 핸들의 start)을 더했다. - PostgreSqlIdempotencyIntegrationTest의 "다른 retention은 conflict" 케이스가 옛 동작을 고정하고 있어 결정대로 "이미 처리됨, 처음 retention 유지"로 바꿨다(...IsConfirmedAndKeepsItsRetention). IdempotencyFailOutcome·IdempotencyStartOutcome·IdempotencyStorePort Javadoc, 결정 색인 2.4절(새 행과 「넘겨받기 전 핸들의 재전송」 적용 조건), application-core CLAUDE.md·README, cache-redis·persistence-jpa README, TESTING_STRATEGY, 업그레이드 안내 5절 행을 같이 고쳤다. 버린 대안: 다른 disposition을 NOT_OWNER로 두고 Javadoc만 고치기(19.4절 ② (b), 소유자가 고르지 않음, 적용한 핸들에 "넘겨받혔다"는 틀린 신호), 다른 retention도 OPERATION_CONFLICT(② (c), Redis 기록에 retention을 더하고 Lua를 바꿔야 하며 보관 기간을 인자로 본다), Redis start 분기만 "renewedFromRev가 있으면 ALREADY 아님"으로 막기(같은 상태에 머무는 전이가 늘면 다시 갈라진다). 위험·한계: 템플릿 호출자(IdempotencyExecutor)는 같은 인자로만 다시 보내고 renew를 부르지 않아 HTTP 동작은 같다. 포트를 직접 부르는 코드만 답이 바뀐다. 이 배포 전에 쓰인 Redis 기록에는 lastKind가 없어, 새 프로그램이 그 기록의 전이를 재전송으로 보지 않는다. 핸들은 프로세스 메모리에만 있고 같은 프로세스는 같은 프로그램을 돌리므로, 새 프로그램이 옛 프로그램이 적용한 전이의 핸들을 받는 경로는 템플릿에 없다고 본다(실행으로 확인하지 않음). PostgreSQL도 같은 이유로 옛 fail digest(retention 포함)와 새 digest를 같은 핸들로 비교하는 경로가 없다고 보고 digest VERSION을 올리지 않았다. 검증: desktop, 공유 잠금, --no-build-cache, 기준3eb3b067. - RED(기준 커밋 + 계약 케이스만, 로그 ~/r9-g4-red-logs/red-summary.txt): fake 62 중 1 실패(다른 disposition "expected: OPERATION_CONFLICT but was: NOT_OWNER"), Redis 명령 fake 62 중 2·실 Redis(redisContainerContractTest) 103 중 2 실패(다른 disposition, renew 뒤 start "expected: NOT_OWNER but was: ALREADY_STARTED_SAME_OPERATION"), 실 PostgreSQL 62 중 2 실패(다른 disposition, 다른 retention "expected: ALREADY_MARKED_SAME_OPERATION but was: OPERATION_CONFLICT"). - GREEN(이 커밋과 같은 트리5a74698d, 로그 ~/r9-g4-green-logs/와 pass2/, 수는 결과 XML에서 셈 test-counts.txt): 네 leaf check(application-core 426· skip 19 fake 시간 케이스, cache-redis 228, redis-runtime 65, persistence-jpa 666)와 testQualityCheck, redisContainerContractTest 103, jpaPlatformContractTest 432, fake를 쓰는 leaf(composition:idempotency 32, redis-sdk 310, web 341, sample-portfolio 339), documentContractTest 67 — 모두 rc=0, 실패 0. postgresqlIdempotencyIntegrationTest는 1차에서 위 옛 케이스 1건이 실패했고, 고친 뒤 pass2에서 persistence-jpa spotlessCheck· check·testQualityCheck와 함께 10 중 실패 0, rc=0. - scripts/check-work-docs.py rc=0, git diff --check 통과. BREAKING CHANGE: IdempotencyStorePort 구현은 적용한 핸들이 markFailed를 다른 disposition으로 다시 보내면 OPERATION_CONFLICT, retention만 다르면 ALREADY_MARKED_SAME_OPERATION으로 답해야 하고, renew를 적용한 핸들의 start를 "이미 시작됨"으로 확인하면 안 된다(NOT_OWNER). 직접 구현한 store는 IdempotencyStoreContract의 새 케이스로 확인한다.
This commit is contained in:
@@ -267,6 +267,11 @@ source set에서 태그 `jpa-contract`로 `jpaPlatformContractTest` lane이 돌
|
||||
markFailed·renew·release는 `OPERATION_CONFLICT`로 답했다 — 주인이 renew가 돌려준 핸들로 다시 renew해도
|
||||
그랬다. fake는 complete 말고는 적용한 핸들의 재전송도 `NOT_OWNER`였다. 셋 다 적용한 핸들(기록보다
|
||||
revision이 하나 낮은 핸들)에게만 확인하고 다른 핸들은 `NOT_OWNER`로 맞췄다(2026-11-06 소유자 결정).
|
||||
(5) 그 "적용한 핸들"을 Redis는 revision 하나로만 가렸다. 그래서 renew를 적용한 핸들이 start를 보내면 Redis만
|
||||
"이미 시작됨"(호출자가 작업을 다시 돌린다), fake·PostgreSQL은 `NOT_OWNER`였다. Redis 기록에 마지막 전이
|
||||
종류(`lastKind`)를 남겨 그 전이일 때만 확인한다. 적용한 핸들이 markFailed를 다른 disposition으로 다시 보내면
|
||||
셋 다 `NOT_OWNER`였고, 다른 retention이면 PostgreSQL만 `OPERATION_CONFLICT`, Redis·fake는 "이미 처리됨"이었다.
|
||||
다른 disposition은 `OPERATION_CONFLICT`, 다른 retention은 "이미 처리됨"으로 맞췄다(2026-11-07 소유자 결정).
|
||||
- `OutboxAppendContract`는 static helper 두 개였고 JPA readiness 테스트만 불렀다. 추상 계약으로 바꿔
|
||||
readiness 테스트가 상속한다(같은 두 케이스 + 트랜잭션 밖·읽기 전용·중복 eventId). 실 PostgreSQL에서
|
||||
`inRead` 안의 append가 예외 없이 사라지는 것을 찾았다(실측: 예외 없음, 행 없음) — JPA 트랜잭션
|
||||
|
||||
Reference in New Issue
Block a user