fix(persistence)!: 넘겨받은 claim만 쓰게 하고 트랜잭션 시한과 정리를 닫는다 #33

Closed
donghyeon.kang wants to merge 0 commits from claude/r9-b-claim-tx into main
Owner

무엇을, 왜

2026-11-12 전체 리뷰의 B8(claim·fence)과 B9(트랜잭션 시한·정리) 발견 15건과, 그룹 C에서 넘어온 DurableOperationStoreContractTest 정리를 고친다.

  • 넘겨받은 lease의 앞 실행이 쓴다. durable operation은 owner만 보고 써서, 같은 worker id가 다시 claim하면 앞 실행의 heartbeat·결과가 새 실행을 덮는다. 알림 lease 회복은 상태를 다시 읽고 조건 없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep과 전체 읽음은 기다린 행을 다시 보지 않아 READ COMMITTED 재평가를 놓친다.
  • 정리가 끝나지 않거나 한꺼번에 돈다. 멱등성 reaper는 앱 시계로 비교하고 한 문장으로 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. live_event_log는 지우는 곳이 없다. fileserver recovery enqueue는 동시 삽입에서 25P02로 실패한다.
  • 시간 상한이 없거나 거짓이다. cleanup은 claim lease가 끝난 뒤에도 항목을 시작한다. 알림 provider timeout이 lease보다 길어도 기동한다. stateless runner 트랜잭션은 끝이 없다. app.lock.wait-time은 읽는 곳이 없다. tenant pool 예산은 새 pool의 크기를 모른 채 열어 합계가 상한을 넘는다.
  • 알림 scheduler는 poll마다 상태 쿼리 넷을 돌리고, projection 지연은 닫힌 event까지 읽는다. runbook SQL 설명은 lane 넷 중 셋만 말한다.

고른 방법과 버린 대안

  • 모든 lease 쓰기를 조건 한 문장으로. owner·fence(·상태·만료)를 WHERE에 둔 UPDATE/DELETE 하나다. durable operation은 V23 lease_fence와 DurableOperationClaim을 쓴다. 알림 회복은 requeueAbandoned(lease, …) 한 문장이다. 버린 대안: 읽고 비교한 뒤 쓰기(경합이 그대로 남는다), 앱 쪽 락(인스턴스 사이에서 효과가 없다).
  • READ COMMITTED 재평가. subquery는 FOR UPDATE SKIP LOCKED, 바깥 문장은 같은 조건을 다시 본다. 멱등성 reaper도 같다. 그래서 reap이 기다리는 동안 다시 claim된 기록은 살아남는다(PostgreSQL 경합 시험).
  • 정리는 1000행씩, DB 시계로. 공용 BatchedDeletes가 outbox·멱등성·live event reaper를 같은 방식으로 돌린다. LiveEventReaper를 새로 둔다. reaper 셋의 트랜잭션은 SpringTransaction.DEFAULT_TIMEOUT_SECONDS 하나로 묶는다(stateless runner는 패키지 경계 때문에 값을 다시 적고, 시험이 둘을 같게 지킨다).
  • replay 설정은 엄격하게 묶는다. LiveEventReplaySettings가 app.realtime.replay.*를 바인딩하고, 조립 설정이 SchedulingConfigurer로 reap()을 그 값의 간격마다 등록한다. 버린 대안: @Scheduled placeholder(기본값이 두 곳이고 0을 막는 곳이 없다), @Scheduled에서 SpEL로 settings bean을 이름으로 읽기(문자열 bean 조회는 검사가 못 본다).
  • cleanup은 lease 마지막 2분에 시작하지 않는다. 시작하지 못한 항목과 바이트 예산이 바닥나 돌려준 항목은 시도를 세지 않는 release로 돌려준다. 버린 대안: markFailed로 돌려주기(lease가 짧으면 시도 8번 만에 버려진다).
  • recovery enqueue는 INSERT … ON CONFLICT. 버린 대안: 25P02를 잡아 다시 시도(트랜잭션 전체가 이미 abort된다).
  • V14 부분 인덱스는 lock_timeout을 걸고 트랜잭션 안에서 만든다. V21 선례와 같다. 버린 대안: CONCURRENTLY(Flyway 트랜잭션 안에서 못 돈다). 큰 DB는 안내 4행대로 미리 만든다.
  • tenant 예산은 계획된 pool 크기로 열기 전에 본다. runner 기본 30초는 SpringTransaction 쓰기 시한과 같고, 시험이 그것을 본다.
  • 저장소가 행에서 만드는 record 일곱(DurableOperationClaim·OperationLease·RecipientLease·OutboxLease·ClaimedOutboxEvent·ReconciliationJob·AdminOperationClaim)과 runner는 값을 거절할 때 IllegalStateException이다(manual 06: 요청이 아닌 서버 결함).
  • scheduler backlog는 claim과 같은 SQL 조각이다. RecipientClaimSql.CLAIMABLE_AT_NOW(기한, 상태, 만료 안 됨, lease 없음이나 끝남)를 claim과 backlog 쿼리가 같이 쓴다. 그래서 창이 닫힌 delivery는 backlog에서 빠진다. 버린 대안: backlog 쪽에 조건을 다시 적기(이미 lease_until <=로 갈라져 있었다).
  • lease가 짧을 때의 결과를 바로 적는다. claim은 DISPATCHING인 delivery를 가져가지 않는다. 호출이 lease를 넘기면 멈춘 lease로 보이고, lease만큼 더 지나도 끝나지 않았으면 lease 복구가 그 delivery를 맞추기로 넘긴다(기본 제공 SES·SMTP는 결과 조회가 없어 운영자 확인). 그 뒤에 끝난 호출도 결과를 기록한다. 옛 문서의 「두 번째 worker가 다시 보낸다」는 틀린 설명이라 고쳤다(설정 Javadoc·기동 메시지·configuration reference·안내 5·6행·poll 간격 검사 주석). 검사(timeout < lease)는 그대로 필요하다.
  • 알림 projection 지연 쿼리의 WHERE와 V14 부분 인덱스 조건은 상수 하나이고, 시험이 migration 파일과 대조한다.

정한 기본값

  • 정리 묶음 1000행(BatchedDeletes.BATCH_SIZE, outbox와 같다).
  • app.realtime.replay.reaper-interval PT10M(LiveEventReplaySettings와 모듈 기본값이 같은 값).
  • HibernateStatelessSessionRunner.DEFAULT_TIMEOUT 30초.
  • cleanup은 claim lease(10분)의 마지막 2분에 새 항목을 시작하지 않는다.
  • reaper 트랜잭션 시한 30초(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 삭제.
  • 기동이 실패하는 곳: provider timeout ≥ lease, app.lock.wait-time 설정, app.realtime.replay.* 아래 모르는 키나 0 이하의 retention·reaper-interval.
  • 마이그레이션: persistence-jpa V23(durable_operation에 열 하나, lock_timeout 5초), 알림 V14 부분 인덱스(큰 DB는 미리 만든다).
  • 옛 행: owner가 없거나 fence가 0인 V4 이전 DISPATCHING 행은 회복이 고르지 않는다. 안내 5행에 찾는 SQL과, owner·fence만 채워 복구 패스에 넘기는 SQL이 있다(손으로 다시 보낼 차례로 바꾸면 발송 중 멈춘 행이 두 번 나간다).
  • SMTP: 이 PR만으로는 SMTP 발송 전체가 lease 안에 끝난다고 말하지 못한다(안내 6행). 이 PR 위에 쌓은 outbound PR이 profile timeout으로 발송 전체를 묶는다.
  • 지표: 알림 backlog 수치가 배포 직후 내려갈 수 있다. 창이 닫혀 보낼 수 없는 delivery를 빼고 세기 때문이다(안내 3절).
  • 병합 순서: outbound PR과 application PR이 이 PR 위에 쌓여 있다. 이 PR을 먼저 병합한다.
  • 두지 않은 것: fence가 0인 옛 행을 세는 지표. 그런 행은 V4 이전 데이터뿐이라 안내 5행의 SQL로 한 번 찾는다.

검증

  • RED: 고치기 전 트리에 새 시험만 얹어 desktop에서 돌렸다. 새 시험 13건 실패(~/r9-group-b-logs/pr1-red3.log).
  • GREEN: desktop scripts/verify.sh pr --on here --no-cache rc=0. 트리 3625e5e7(main e6c3b159 위), 시험 6855건(실패 0, skip 35), FROM-CACHE 0. 로그 ~/r9-group-b-logs/pr1-verify-r9.log.
  • 중간 커밋: B8 커밋 트리 15fd5257만으로 바뀐 모듈 check(application-core·notification·fileserver, adapter notification·persistence-fileserver·persistence-notification·persistence-jpa, PG 시험 컴파일) rc=0, 시험 2239건(실패 0, skip 20).
  • PostgreSQL lane: jpaPlatformContractTest·jpaPlatformMigrationTest·postgresqlMigrationIntegrationTest·postgresqlMigrationLockWaitIntegrationTest·postgresqlNotificationSchemaActivationIntegrationTest rc=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).
  • backlog: RecipientClaimSql.CLAIMABLE_AT_NOW, JdbcNotificationServingState.BACKLOG, ServingStateContractTest의 lease 경계 사례.
  • 공유 계약: DurableOperationStoreContract, RecipientDeliveryStoreContract, CleanupQueueContract. fake와 adapter가 같은 사례를 통과한다.

관련

  • 리뷰: docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md
  • 안내: docs/upgrade/2026-11-round9-claim-fence.md

발견 표

ID 판정 커밋
RR9-01-02 고침 afdedabf
RR9-01-04 고침 afdedabf
RR9-01-06 고침 afdedabf
RR9-01-12 고침 afdedabf
RR9-01-13 고침 afdedabf
RR9-01-23 고침 afdedabf
RR9-01-24 고침 afdedabf
RR9-01-29 고침 afdedabf
B16 넘김 DurableOperationStoreContractTest 고침(같은 파일이라 여기서) afdedabf
RR9-01-03 고침 4da51439
RR9-01-07 고침 4da51439
RR9-01-09 고침 4da51439
RR9-01-10 고침 4da51439
RR9-01-14 고침 4da51439
RR9-01-25 고침 4da51439
RR9-01-26 고침 4da51439

RR9-01-22(soft TTL)는 리뷰 색인대로 B2 몫이라 이 PR에 없다. 기존 코드에서 찾았지만 범위 밖이라 넘긴 것은 공유 노트 r9-be/group-B.md에 있다(parkForOperator가 fence를 올리지 않음, Dispatch.defaults() lease 30초와 모듈 기본값 2분, *Settings record의 IAE, RecipientLeaseStorePort.renew 호출자 없음).

## 무엇을, 왜 2026-11-12 전체 리뷰의 B8(claim·fence)과 B9(트랜잭션 시한·정리) 발견 15건과, 그룹 C에서 넘어온 `DurableOperationStoreContractTest` 정리를 고친다. - **넘겨받은 lease의 앞 실행이 쓴다.** durable operation은 owner만 보고 써서, 같은 worker id가 다시 claim하면 앞 실행의 heartbeat·결과가 새 실행을 덮는다. 알림 lease 회복은 상태를 다시 읽고 조건 없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep과 전체 읽음은 기다린 행을 다시 보지 않아 READ COMMITTED 재평가를 놓친다. - **정리가 끝나지 않거나 한꺼번에 돈다.** 멱등성 reaper는 앱 시계로 비교하고 한 문장으로 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. `live_event_log`는 지우는 곳이 없다. fileserver recovery enqueue는 동시 삽입에서 25P02로 실패한다. - **시간 상한이 없거나 거짓이다.** cleanup은 claim lease가 끝난 뒤에도 항목을 시작한다. 알림 provider timeout이 lease보다 길어도 기동한다. stateless runner 트랜잭션은 끝이 없다. `app.lock.wait-time`은 읽는 곳이 없다. tenant pool 예산은 새 pool의 크기를 모른 채 열어 합계가 상한을 넘는다. - 알림 scheduler는 poll마다 상태 쿼리 넷을 돌리고, projection 지연은 닫힌 event까지 읽는다. runbook SQL 설명은 lane 넷 중 셋만 말한다. ## 고른 방법과 버린 대안 - **모든 lease 쓰기를 조건 한 문장으로.** owner·fence(·상태·만료)를 WHERE에 둔 UPDATE/DELETE 하나다. durable operation은 V23 `lease_fence`와 `DurableOperationClaim`을 쓴다. 알림 회복은 `requeueAbandoned(lease, …)` 한 문장이다. 버린 대안: 읽고 비교한 뒤 쓰기(경합이 그대로 남는다), 앱 쪽 락(인스턴스 사이에서 효과가 없다). - **READ COMMITTED 재평가.** subquery는 `FOR UPDATE SKIP LOCKED`, 바깥 문장은 같은 조건을 다시 본다. 멱등성 reaper도 같다. 그래서 reap이 기다리는 동안 다시 claim된 기록은 살아남는다(PostgreSQL 경합 시험). - **정리는 1000행씩, DB 시계로.** 공용 `BatchedDeletes`가 outbox·멱등성·live event reaper를 같은 방식으로 돌린다. `LiveEventReaper`를 새로 둔다. reaper 셋의 트랜잭션은 `SpringTransaction.DEFAULT_TIMEOUT_SECONDS` 하나로 묶는다(stateless runner는 패키지 경계 때문에 값을 다시 적고, 시험이 둘을 같게 지킨다). - **replay 설정은 엄격하게 묶는다.** `LiveEventReplaySettings`가 `app.realtime.replay.*`를 바인딩하고, 조립 설정이 `SchedulingConfigurer`로 `reap()`을 그 값의 간격마다 등록한다. 버린 대안: `@Scheduled` placeholder(기본값이 두 곳이고 0을 막는 곳이 없다), `@Scheduled`에서 SpEL로 settings bean을 이름으로 읽기(문자열 bean 조회는 검사가 못 본다). - **cleanup은 lease 마지막 2분에 시작하지 않는다.** 시작하지 못한 항목과 바이트 예산이 바닥나 돌려준 항목은 시도를 세지 않는 `release`로 돌려준다. 버린 대안: `markFailed`로 돌려주기(lease가 짧으면 시도 8번 만에 버려진다). - **recovery enqueue는 `INSERT … ON CONFLICT`.** 버린 대안: 25P02를 잡아 다시 시도(트랜잭션 전체가 이미 abort된다). - **V14 부분 인덱스는 lock_timeout을 걸고 트랜잭션 안에서 만든다.** V21 선례와 같다. 버린 대안: `CONCURRENTLY`(Flyway 트랜잭션 안에서 못 돈다). 큰 DB는 안내 4행대로 미리 만든다. - tenant 예산은 계획된 pool 크기로 열기 전에 본다. runner 기본 30초는 `SpringTransaction` 쓰기 시한과 같고, 시험이 그것을 본다. - 저장소가 행에서 만드는 record 일곱(`DurableOperationClaim`·`OperationLease`·`RecipientLease`·`OutboxLease`·`ClaimedOutboxEvent`·`ReconciliationJob`·`AdminOperationClaim`)과 runner는 값을 거절할 때 `IllegalStateException`이다(manual 06: 요청이 아닌 서버 결함). - **scheduler backlog는 claim과 같은 SQL 조각이다.** `RecipientClaimSql.CLAIMABLE_AT_NOW`(기한, 상태, 만료 안 됨, lease 없음이나 끝남)를 claim과 backlog 쿼리가 같이 쓴다. 그래서 창이 닫힌 delivery는 backlog에서 빠진다. 버린 대안: backlog 쪽에 조건을 다시 적기(이미 `lease_until <=`로 갈라져 있었다). - **lease가 짧을 때의 결과를 바로 적는다.** claim은 `DISPATCHING`인 delivery를 가져가지 않는다. 호출이 lease를 넘기면 멈춘 lease로 보이고, lease만큼 더 지나도 끝나지 않았으면 lease 복구가 그 delivery를 맞추기로 넘긴다(기본 제공 SES·SMTP는 결과 조회가 없어 운영자 확인). 그 뒤에 끝난 호출도 결과를 기록한다. 옛 문서의 「두 번째 worker가 다시 보낸다」는 틀린 설명이라 고쳤다(설정 Javadoc·기동 메시지·configuration reference·안내 5·6행·poll 간격 검사 주석). 검사(timeout < lease)는 그대로 필요하다. - 알림 projection 지연 쿼리의 `WHERE`와 V14 부분 인덱스 조건은 상수 하나이고, 시험이 migration 파일과 대조한다. ## 정한 기본값 - 정리 묶음 1000행(`BatchedDeletes.BATCH_SIZE`, outbox와 같다). - `app.realtime.replay.reaper-interval` `PT10M`(`LiveEventReplaySettings`와 모듈 기본값이 같은 값). - `HibernateStatelessSessionRunner.DEFAULT_TIMEOUT` 30초. - cleanup은 claim lease(10분)의 마지막 2분에 새 항목을 시작하지 않는다. - reaper 트랜잭션 시한 30초(`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` 삭제. - **기동이 실패하는 곳:** provider timeout ≥ lease, `app.lock.wait-time` 설정, `app.realtime.replay.*` 아래 모르는 키나 0 이하의 retention·reaper-interval. - **마이그레이션:** persistence-jpa V23(`durable_operation`에 열 하나, lock_timeout 5초), 알림 V14 부분 인덱스(큰 DB는 미리 만든다). - **옛 행:** owner가 없거나 fence가 0인 V4 이전 `DISPATCHING` 행은 회복이 고르지 않는다. 안내 5행에 찾는 SQL과, owner·fence만 채워 복구 패스에 넘기는 SQL이 있다(손으로 다시 보낼 차례로 바꾸면 발송 중 멈춘 행이 두 번 나간다). - **SMTP:** 이 PR만으로는 SMTP 발송 전체가 lease 안에 끝난다고 말하지 못한다(안내 6행). 이 PR 위에 쌓은 outbound PR이 profile timeout으로 발송 전체를 묶는다. - **지표:** 알림 backlog 수치가 배포 직후 내려갈 수 있다. 창이 닫혀 보낼 수 없는 delivery를 빼고 세기 때문이다(안내 3절). - **병합 순서:** outbound PR과 application PR이 이 PR 위에 쌓여 있다. 이 PR을 먼저 병합한다. - **두지 않은 것:** fence가 0인 옛 행을 세는 지표. 그런 행은 V4 이전 데이터뿐이라 안내 5행의 SQL로 한 번 찾는다. ## 검증 - RED: 고치기 전 트리에 새 시험만 얹어 desktop에서 돌렸다. 새 시험 13건 실패(`~/r9-group-b-logs/pr1-red3.log`). - GREEN: desktop `scripts/verify.sh pr --on here --no-cache` rc=0. 트리 `3625e5e7`(main `e6c3b159` 위), 시험 6855건(실패 0, skip 35), FROM-CACHE 0. 로그 `~/r9-group-b-logs/pr1-verify-r9.log`. - 중간 커밋: B8 커밋 트리 `15fd5257`만으로 바뀐 모듈 `check`(application-core·notification·fileserver, adapter notification·persistence-fileserver·persistence-notification·persistence-jpa, PG 시험 컴파일) rc=0, 시험 2239건(실패 0, skip 20). - PostgreSQL lane: `jpaPlatformContractTest`·`jpaPlatformMigrationTest`·`postgresqlMigrationIntegrationTest`·`postgresqlMigrationLockWaitIntegrationTest`·`postgresqlNotificationSchemaActivationIntegrationTest` rc=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`). - backlog: `RecipientClaimSql.CLAIMABLE_AT_NOW`, `JdbcNotificationServingState.BACKLOG`, `ServingStateContractTest`의 lease 경계 사례. - 공유 계약: `DurableOperationStoreContract`, `RecipientDeliveryStoreContract`, `CleanupQueueContract`. fake와 adapter가 같은 사례를 통과한다. ## 관련 - 리뷰: `docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md` - 안내: `docs/upgrade/2026-11-round9-claim-fence.md` ## 발견 표 | ID | 판정 | 커밋 | | --- | --- | --- | | RR9-01-02 | 고침 | afdedabf | | RR9-01-04 | 고침 | afdedabf | | RR9-01-06 | 고침 | afdedabf | | RR9-01-12 | 고침 | afdedabf | | RR9-01-13 | 고침 | afdedabf | | RR9-01-23 | 고침 | afdedabf | | RR9-01-24 | 고침 | afdedabf | | RR9-01-29 | 고침 | afdedabf | | B16 넘김 `DurableOperationStoreContractTest` | 고침(같은 파일이라 여기서) | afdedabf | | RR9-01-03 | 고침 | 4da51439 | | RR9-01-07 | 고침 | 4da51439 | | RR9-01-09 | 고침 | 4da51439 | | RR9-01-10 | 고침 | 4da51439 | | RR9-01-14 | 고침 | 4da51439 | | RR9-01-25 | 고침 | 4da51439 | | RR9-01-26 | 고침 | 4da51439 | RR9-01-22(soft TTL)는 리뷰 색인대로 B2 몫이라 이 PR에 없다. 기존 코드에서 찾았지만 범위 밖이라 넘긴 것은 공유 노트 `r9-be/group-B.md`에 있다(`parkForOperator`가 fence를 올리지 않음, `Dispatch.defaults()` lease 30초와 모듈 기본값 2분, `*Settings` record의 IAE, `RecipientLeaseStorePort.renew` 호출자 없음).
donghyeon.kang added 2 commits 2026-11-13 04:54:11 +00:00
lease를 넘겨받는 저장소 다섯 곳이 앞 실행의 쓰기를 막지 못한다.
durable operation은 owner만 보고 써서 같은 worker id가 다시 claim하면
앞 실행의 결과가 남는다. 알림 lease 회복은 상태를 다시 읽은 뒤 조건
없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep·전체 읽음은
기다린 행의 상태를 다시 보지 않는다. 멱등성 reaper는 앱 시계로 비교하고
한 번에 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. fileserver
recovery enqueue는 동시 삽입에서 25P02로 실패하고, cleanup은 claim
lease가 끝난 뒤에도 항목을 시작한다. 저장소가 행에서 만드는 claim·lease
record는 잘못된 값을 IllegalArgumentException으로 거절해 web이 400으로
바꾼다.

고른 방법: 모든 쓰기를 owner·fence(·상태·만료) 조건을 단 한 문장으로
바꾼다. durable operation은 V23 lease_fence를 더하고 DurableOperationClaim
을 돌려준다. 알림 회복은 requeueAbandoned 한 문장이다. 만료 sweep은
subquery가 SKIP LOCKED로 쥔 행을 건너뛰고 바깥 UPDATE가 상태·만료를 다시
본다. 전체 읽음은 바깥 UPDATE가 상태를 다시 본다. reaper는 DB now()로
1000행씩, 트랜잭션마다 30초(SpringTransaction.DEFAULT_TIMEOUT_SECONDS)이고
바깥 DELETE에도 만료를 둔다. recovery는 INSERT … ON CONFLICT, cleanup은
lease 마지막 2분에 시작하지 않고 시도를 세지 않는 release로 돌려준다.
알림 provider timeout은 lease보다 짧아야 기동한다(호출이 lease를 넘으면
lease 복구가 아직 도는 호출을 맞추기로 넘긴다). 저장소가 만드는 record
일곱은 IllegalStateException으로 거절한다. 버린 대안: 읽고 비교한 뒤
쓰기(경합이 그대로 남음), 앱 쪽 락(인스턴스 사이에서 무의미).

위험·한계: 포트 시그니처가 바뀐다(DurableOperationStorePort,
RecipientLeaseStorePort.expiredDispatching, RecipientDeliveryStorePort
.requeueAbandoned, CleanupQueuePort.release). owner가 없거나 fence가
0인 V4 전 DISPATCHING 행은 회복이 고르지 않는다(안내 4행에 고치는 SQL).
provider timeout 검사는 필요조건일 뿐이고, 호출 전체를 묶는 것은 SES다.

검증: desktop RED(고치기 전 트리 + 새 시험, pr1-red3) 새 시험 13건
실패. GREEN은 PR 본문의 verify.sh pr·PostgreSQL lane 결과.

Refs: RR9-01-02, RR9-01-04, RR9-01-06, RR9-01-12, RR9-01-13, RR9-01-23, RR9-01-24, RR9-01-29, R1 넘김 DurableOperationStoreContractTest
BREAKING CHANGE: DurableOperationStorePort의 heartbeat·reportProgress·succeed·fail이 DurableOperationClaim을 받고 claimNext가 그것을 돌려준다. RecipientLeaseStorePort.expiredDispatching이 List<RecipientLease>를 돌려주고 RecipientDeliveryStorePort.requeueAbandoned, CleanupQueuePort.release가 새로 생긴다. IdempotencyReaper 생성자에서 Clock이 빠진다. 알림 provider timeout이 lease 이상이면 기동이 실패한다. 저장소가 만드는 claim·lease record가 IllegalStateException을 던진다. docs/upgrade/2026-11-round9-claim-fence.md
남은 트랜잭션·정리 결함 일곱. live event log는 지우는 곳이 없어 끝없이
자란다. app.lock.wait-time은 읽는 곳이 없다. 알림 scheduler는 poll마다
상태 쿼리 넷을 돌리고, projection 지연은 닫힌 event까지 읽는다.
stateless runner 트랜잭션에 시한이 없다. tenant pool 예산은 새 pool의
크기를 모른 채 열어 연결 합계가 상한을 넘는다. runbook SQL 설명이
lane 넷 중 셋만 말한다.

고른 방법: LiveEventReaper(1000행씩, 트랜잭션 30초)와 공용
BatchedDeletes를 더한다. app.realtime.replay.*는 LiveEventReplaySettings가
엄격하게 묶고, 조립 설정이 SchedulingConfigurer로 reaper를
reaper-interval(기본 10분)마다 등록한다. LockSettings는 lease-ttl 하나만
받는다(모르는 키로 기동 실패). scheduler는 backlogDepth() 한 문장만 읽고,
그 WHERE는 claim과 같은 SQL 조각(RecipientClaimSql.CLAIMABLE_AT_NOW)이다.
projection 지연은 V14 부분 인덱스로 읽는다(lock_timeout, V21 선례대로
CONCURRENTLY 아님). runner 기본 30초(SpringTransaction 쓰기 시한과 같음을
시험이 본다), tenant 예산은 계획된 pool 크기로 열기 전에 본다. 버린
대안: V14를 CONCURRENTLY로(Flyway 트랜잭션 안에서 못 돈다, 큰 DB는
안내대로 미리 만든다), reaper @Scheduled에 SpEL로 settings bean 이름
읽기(문자열 bean 조회는 검사가 못 본다).

위험·한계: LockSettings·TenantDataSourceRegistry·TenantPoolBudget의
공개 생성자가 바뀐다. V14는 큰 notification_provider_event에서 쓰기를
잠깐 막는다(안내 4행에 미리 만드는 법과 INVALID 인덱스 확인). backlog
수치는 창이 닫힌 delivery를 더는 세지 않는다.

검증: desktop RED(pr1-red3) 새 시험 실패 포함. GREEN은 PR 본문.

Refs: RR9-01-03, RR9-01-07, RR9-01-09, RR9-01-10, RR9-01-14, RR9-01-25, RR9-01-26
BREAKING CHANGE: JpaLiveEventReplay.sweepExpired 삭제, app.realtime.replay 아래 모르는 키와 app.lock.wait-time은 기동 실패, HibernateStatelessSessionRunner 트랜잭션 30초 상한, TenantPoolBudget·TenantDataSourceRegistry 시그니처 변경. docs/upgrade/2026-11-round9-claim-fence.md
Author
Owner

추가 PostgreSQL lane 결과(desktop, 트리 3625e5e7 = 이 PR head, main e6c3b159 위).

  • 14개 lane(postgresqlLifecycle·Transaction·DistributedLock·Idempotency·Outbox* 6개·Fileserver* 3개 IntegrationTest, jpaPlatformFailureTest): 시험 138건, 실패 1건.
  • 실패 1건은 PostgreSqlLifecycleIntegrationTest.poolCapacityExhaustionAndShutdownAreBoundedAndObservable. 컨테이너가 시험의 10초 시한(@Timeout(10)) 안에 뜨지 못했다(당시 desktop load 25~40). 이 PR은 이 시험과 PostgreSqlReadinessSupport를 건드리지 않았다.
  • 같은 lane을 다시 돌렸다. 이 PR 트리 rc=0, main 트리 rc=0. 로그 ~/r9-group-b-logs/pr1-lanes2-r9.log, pr1-lifecycle-r9.log, main-lifecycle.log.
추가 PostgreSQL lane 결과(desktop, 트리 `3625e5e7` = 이 PR head, main `e6c3b159` 위). - 14개 lane(`postgresqlLifecycle`·`Transaction`·`DistributedLock`·`Idempotency`·`Outbox*` 6개·`Fileserver*` 3개 `IntegrationTest`, `jpaPlatformFailureTest`): 시험 138건, 실패 1건. - 실패 1건은 `PostgreSqlLifecycleIntegrationTest.poolCapacityExhaustionAndShutdownAreBoundedAndObservable`. 컨테이너가 시험의 10초 시한(`@Timeout(10)`) 안에 뜨지 못했다(당시 desktop load 25~40). 이 PR은 이 시험과 `PostgreSqlReadinessSupport`를 건드리지 않았다. - 같은 lane을 다시 돌렸다. 이 PR 트리 rc=0, main 트리 rc=0. 로그 `~/r9-group-b-logs/pr1-lanes2-r9.log`, `pr1-lifecycle-r9.log`, `main-lifecycle.log`.
Author
Owner

#37로 병합됨. 이 PR의 변경은 #37에 모두 들어갔다.

#37로 병합됨. 이 PR의 변경은 #37에 모두 들어갔다.
donghyeon.kang closed this pull request 2026-11-13 18:43:51 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#33