fix(persistence)!: 넘겨받은 claim만 쓰게 하고 트랜잭션 시한과 정리를 닫는다 #33
Closed
donghyeon.kang
wants to merge 0 commits from
claude/r9-b-claim-tx into main
pull from: claude/r9-b-claim-tx
merge into: :main
:main
:claude/r9-review-record-2
:docs/improve-review-budget
:claude/r9-objstore-exceptions
:claude/w2-be-flaky-ledger
:claude/r9-a-follow-ups
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#33
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
2026-11-12 전체 리뷰의 B8(claim·fence)과 B9(트랜잭션 시한·정리) 발견 15건과, 그룹 C에서 넘어온
DurableOperationStoreContractTest정리를 고친다.live_event_log는 지우는 곳이 없다. fileserver recovery enqueue는 동시 삽입에서 25P02로 실패한다.app.lock.wait-time은 읽는 곳이 없다. tenant pool 예산은 새 pool의 크기를 모른 채 열어 합계가 상한을 넘는다.고른 방법과 버린 대안
lease_fence와DurableOperationClaim을 쓴다. 알림 회복은requeueAbandoned(lease, …)한 문장이다. 버린 대안: 읽고 비교한 뒤 쓰기(경합이 그대로 남는다), 앱 쪽 락(인스턴스 사이에서 효과가 없다).FOR UPDATE SKIP LOCKED, 바깥 문장은 같은 조건을 다시 본다. 멱등성 reaper도 같다. 그래서 reap이 기다리는 동안 다시 claim된 기록은 살아남는다(PostgreSQL 경합 시험).BatchedDeletes가 outbox·멱등성·live event reaper를 같은 방식으로 돌린다.LiveEventReaper를 새로 둔다. reaper 셋의 트랜잭션은SpringTransaction.DEFAULT_TIMEOUT_SECONDS하나로 묶는다(stateless runner는 패키지 경계 때문에 값을 다시 적고, 시험이 둘을 같게 지킨다).LiveEventReplaySettings가app.realtime.replay.*를 바인딩하고, 조립 설정이SchedulingConfigurer로reap()을 그 값의 간격마다 등록한다. 버린 대안:@Scheduledplaceholder(기본값이 두 곳이고 0을 막는 곳이 없다),@Scheduled에서 SpEL로 settings bean을 이름으로 읽기(문자열 bean 조회는 검사가 못 본다).release로 돌려준다. 버린 대안:markFailed로 돌려주기(lease가 짧으면 시도 8번 만에 버려진다).INSERT … ON CONFLICT. 버린 대안: 25P02를 잡아 다시 시도(트랜잭션 전체가 이미 abort된다).CONCURRENTLY(Flyway 트랜잭션 안에서 못 돈다). 큰 DB는 안내 4행대로 미리 만든다.SpringTransaction쓰기 시한과 같고, 시험이 그것을 본다.DurableOperationClaim·OperationLease·RecipientLease·OutboxLease·ClaimedOutboxEvent·ReconciliationJob·AdminOperationClaim)과 runner는 값을 거절할 때IllegalStateException이다(manual 06: 요청이 아닌 서버 결함).RecipientClaimSql.CLAIMABLE_AT_NOW(기한, 상태, 만료 안 됨, lease 없음이나 끝남)를 claim과 backlog 쿼리가 같이 쓴다. 그래서 창이 닫힌 delivery는 backlog에서 빠진다. 버린 대안: backlog 쪽에 조건을 다시 적기(이미lease_until <=로 갈라져 있었다).DISPATCHING인 delivery를 가져가지 않는다. 호출이 lease를 넘기면 멈춘 lease로 보이고, lease만큼 더 지나도 끝나지 않았으면 lease 복구가 그 delivery를 맞추기로 넘긴다(기본 제공 SES·SMTP는 결과 조회가 없어 운영자 확인). 그 뒤에 끝난 호출도 결과를 기록한다. 옛 문서의 「두 번째 worker가 다시 보낸다」는 틀린 설명이라 고쳤다(설정 Javadoc·기동 메시지·configuration reference·안내 5·6행·poll 간격 검사 주석). 검사(timeout < lease)는 그대로 필요하다.WHERE와 V14 부분 인덱스 조건은 상수 하나이고, 시험이 migration 파일과 대조한다.정한 기본값
BatchedDeletes.BATCH_SIZE, outbox와 같다).app.realtime.replay.reaper-intervalPT10M(LiveEventReplaySettings와 모듈 기본값이 같은 값).HibernateStatelessSessionRunner.DEFAULT_TIMEOUT30초.SpringTransaction.DEFAULT_TIMEOUT_SECONDS).위험과 영향
포트 시그니처, 기동 조건, 마이그레이션이 바뀐다. 파생 서비스가 할 일은
docs/upgrade/2026-11-round9-claim-fence.md의 2절 열두 줄이다. 요약:DurableOperationStorePort의 claim 인자,RecipientLeaseStorePort.expiredDispatching·RecipientDeliveryStorePort.requeueAbandoned·CleanupQueuePort.release,IdempotencyReaper·LockSettings·TenantPoolBudget·TenantDataSourceRegistry생성자,JpaLiveEventReplay.sweepExpired삭제.app.lock.wait-time설정,app.realtime.replay.*아래 모르는 키나 0 이하의 retention·reaper-interval.durable_operation에 열 하나, lock_timeout 5초), 알림 V14 부분 인덱스(큰 DB는 미리 만든다).DISPATCHING행은 회복이 고르지 않는다. 안내 5행에 찾는 SQL과, owner·fence만 채워 복구 패스에 넘기는 SQL이 있다(손으로 다시 보낼 차례로 바꾸면 발송 중 멈춘 행이 두 번 나간다).검증
~/r9-group-b-logs/pr1-red3.log).scripts/verify.sh pr --on here --no-cacherc=0. 트리3625e5e7(maine6c3b159위), 시험 6855건(실패 0, skip 35), FROM-CACHE 0. 로그~/r9-group-b-logs/pr1-verify-r9.log.15fd5257만으로 바뀐 모듈check(application-core·notification·fileserver, adapter notification·persistence-fileserver·persistence-notification·persistence-jpa, PG 시험 컴파일) rc=0, 시험 2239건(실패 0, skip 20).jpaPlatformContractTest·jpaPlatformMigrationTest·postgresqlMigrationIntegrationTest·postgresqlMigrationLockWaitIntegrationTest·postgresqlNotificationSchemaActivationIntegrationTestrc=0, 시험 555건(실패 0). 이 PR이 건드린 outbox·분산 락·멱등성·fileserver 정리·트랜잭션 lane 14개는 desktop에서 따로 돌리는 중이고, 결과는 이 PR 댓글로 붙인다.python3 scripts/check-docs.py,python3 scripts/check-work-docs.py통과.리뷰어가 볼 곳
JpaDurableOperationStore,RecipientDeliveryJpaRepository(requeueAbandoned·selectExpiredDispatching·만료 sweep),IdempotencyRecordJpaRepository.deleteExpiredBatch,FileserverCleanupRepository.releaseClaim.IdempotencyReaperIntegrationTest.aRecordReclaimedWhileTheReapRunsSurvivesIt.LiveEventReplaySettings,JpaAdapterBeansConfig.LiveEventReplay(reaper 일정SchedulingConfigurer).RecipientClaimSql.CLAIMABLE_AT_NOW,JdbcNotificationServingState.BACKLOG,ServingStateContractTest의 lease 경계 사례.DurableOperationStoreContract,RecipientDeliveryStoreContract,CleanupQueueContract. fake와 adapter가 같은 사례를 통과한다.관련
docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.mddocs/upgrade/2026-11-round9-claim-fence.md발견 표
afdedabfafdedabfafdedabfafdedabfafdedabfafdedabfafdedabfafdedabfDurableOperationStoreContractTestafdedabf4da514394da514394da514394da514394da514394da514394da51439RR9-01-22(soft TTL)는 리뷰 색인대로 B2 몫이라 이 PR에 없다. 기존 코드에서 찾았지만 범위 밖이라 넘긴 것은 공유 노트
r9-be/group-B.md에 있다(parkForOperator가 fence를 올리지 않음,Dispatch.defaults()lease 30초와 모듈 기본값 2분,*Settingsrecord의 IAE,RecipientLeaseStorePort.renew호출자 없음).추가 PostgreSQL lane 결과(desktop, 트리
3625e5e7= 이 PR head, maine6c3b159위).postgresqlLifecycle·Transaction·DistributedLock·Idempotency·Outbox*6개·Fileserver*3개IntegrationTest,jpaPlatformFailureTest): 시험 138건, 실패 1건.PostgreSqlLifecycleIntegrationTest.poolCapacityExhaustionAndShutdownAreBoundedAndObservable. 컨테이너가 시험의 10초 시한(@Timeout(10)) 안에 뜨지 못했다(당시 desktop load 25~40). 이 PR은 이 시험과PostgreSqlReadinessSupport를 건드리지 않았다.~/r9-group-b-logs/pr1-lanes2-r9.log,pr1-lifecycle-r9.log,main-lifecycle.log.#37로 병합됨. 이 PR의 변경은 #37에 모두 들어갔다.
Pull request closed