2026-11-12 전체 리뷰의 B10a(발행·발송·캐시)와 B10b(S3·Mongo·httpclient) 발견 13건을 고친다. claim·fence PR(#33) 위에 쌓았다. 그 PR을 먼저 병합한다(SMTP lease 조건과 문서가 그 PR의 provider timeout 검사 위에 있다). #33 다음에 main(#29~#31)을 merge 커밋 하나로 받았다. 이 PR의 diff에는 #33이 병합되기 전까지 #33의 커밋이 함께 보인다. 이 PR의 커밋은 마지막 둘이다.
시간 상한이 실제 대기를 묶지 않는다. outbox 발행 대기는 publish()가 돌아온 뒤부터 잰다. 그래서 호출을 붙잡는 publisher는 longestAttempt를 넘겨도 relay를 묶고, lease가 지나 같은 event를 두 번 낸다. Redis 캐시는 command-timeout에 lane 대기 2초가 더해진다. SMTP profile timeout은 명령 하나만 묶어, 느린 relay에서 발송이 lease를 넘으면 lease 복구가 아직 도는 발송을 운영자 확인으로 넘긴다.
SMTP 발송 pool이 직렬이다. core thread 1개에 대기열 4n이라, 대기열이 찰 때까지 thread 하나로 돈다. max-concurrency가 pool이 담는 수를 넘어도 기동한다. 넘친 발송은 결과 불명으로 남아 운영자를 기다린다.
크기 상한이 없거나 잘못 센다. 캐시 값 크기 상한이 없다. MongoDB 집계는 결과를 전부 메모리에 올린 뒤 센다. HTTP 압축을 켜면 Apache가 푼 크기를 wire 계수기가 센다.
자기 쓰기를 충돌로 본다. SDK가 응답을 잃고 다시 보낸 S3 조건부 PUT의 412를 충돌로 본다.
tenant client와 migration lease. tenant client registry는 쓰는 중인 client를 닫고, 닫기 실패가 다른 tenant의 acquire를 실패시킨다. migration lease를 잃은 runner가 그 뒤에도 checkpoint를 쓴다.
SOCKS proxy와 문서. SOCKS proxy를 HTTP proxy로 붙인다. 408·429 재시도와 Redis 같은 키 재전송은 문서가 조건 없이 약속한다.
고른 방법과 버린 대안
발행 대기 마감은 publish() 전에 잡는다. 남은 시간만 기다린다. 기다리는 중의 인터럽트는 결과 불명으로 끝내고 인터럽트 표시를 남긴다. 이미 인터럽트된 relay thread와 0 이하의 longestAttempt()는 발행하지 않고 REJECTED_RETRYABLE(PUBLISH_INTERRUPTED_BEFORE_SEND·PUBLISH_BOUND_NOT_POSITIVE)로 답한다. relay는 시도로 세지 않고 backoff 뒤에 다시 본다. 버린 대안: orTimeout(stage가 끝나지 않으면 publisher 쪽 시간을 못 센다).
SMTP pool은 thread와 대기열을 고정한다.dispatch-concurrency개 thread와 그 네 배(QUEUED_SENDS_PER_THREAD) 대기열이다. SMTP profile들의 max-concurrency 합이 그보다 크면 조립이 실패한다. 한 family의 켜진 profile 전체를 보는 검사는 새 default 메서드 ProviderRuntimeAssembler.requireTogether(profiles, deliveryLease)가 하고, NotificationProviderAssembly가 SERVING일 때 family마다 한 번 부른다. 버린 대안: assembler가 assemble마다 합을 누적하기(조립 순서에 상태가 남는다). pool이 거절한 발송은 relay에 닿지 않은 것으로 기록하고 재시도한다.
SMTP 발송은 profile timeout으로 두 번 묶는다. pool에서 그 시간 안에 시작하지 못한 발송은 버리고(보내지 않음, 재시도), 시작한 뒤 그 시간을 넘긴 발송은 PROVIDER_RESPONSE_LOST(자동 재발송 없음)다. 기동 때 timeout은 connect timeout + 명령 timeout 하나보다 길어야 한다. 그래야 인사말을 주지 않는 relay가 socket timeout으로 먼저 안전한 재시도가 된다. lease는 timeout 두 배(대기 + 발송)보다 길어야 기동한다. 두 시한은 completeOnTimeout이라 pool이 발송을 받으면 대기 시한이 취소된다. 기본 timeout을 10초에서 30초로 올렸다. 버린 대안: submit부터 한 번 재기(대기열에서 기다린 발송을 결과 불명으로 닫은 뒤 permit 밖에서 실제로 보냈다), timeout 뒤 재시도(같은 메일을 두 번 보낼 수 있다).
Redis. 연산 전체를 command-timeout 하나로 묶는다(rate limit과 같은 effectWithin). 값 상한은 app.capabilities.cache.maximum-value-bytes로 설정하게 한다. 버린 대안: 상수로 두기(큰 값을 쓰는 서비스가 바꿀 길이 없다).
S3. 412에서 다시 읽어 이 호출이 쓴 record 그대로면 성공으로 본다. 버린 대안: 조건부 PUT의 SDK 재시도 끄기(응답을 잃은 첫 쓰기의 결과를 여전히 모른다).
MongoDB. 집계는 $limit(maxResults + 1)과 maxResultBytes를 집행한다. registry는 Lease를 돌려주고, 쓰는 중에는 내보내지 않는다. idle은 마지막 close부터 잰다. 시계는 생성자의 Clock 하나다(시각을 받던 acquire overload를 지웠다). 닫기 실패는 evictionCloseFailures가 센다. migration ledger는 lock 문서의 최신 fence와 새 runner의 checkpoint 둘 다로 바뀐 runner의 기록을 거절한다. 버린 대안: 집계를 RawBsonDocument로 재기(converter를 거치지 않으면 반환 타입 mapping이 갈라진다).
HTTP client.ProxyType은 HTTP만 남긴다. 버린 대안: SOCKS 지원(transport 셋 중 하나만 된다). 압축은 RestClient 기본 헤더로 보내고, ContentDecoding이 버퍼·스트리밍 본문을 모두 푼다(보내는 coding 목록도 그 클래스가 가진다). 겹친 coding과 그 밖의 coding은 HttpTargetRejectedException(응답 받음 증거)으로 거부한다. 빈 본문은 빈 본문이다. 스트리밍은 identity 본문도 decoded 한도로 센다. Jetty HTTP/3는 기동 뒤 자기 decoder를 비운다. 버린 대안: transport마다 자동으로 풀기(크기 상한을 세는 곳이 transport마다 달라진다).
문서. 408·425·429는 안전하게 멱등인 연산만 재시도한다고 고친다(코드와 같다). Redis 같은 키 재전송에는 failover 비동기 복제 손실 한계를 적는다(manual 05, http-contract).
정한 기본값
SMTP 발송 대기열 = thread 수 × 4.
SMTP profile timeout 30초(전 10초). connect 5초 + 명령 10초인 출하 socket timeout보다 길다.
send pool을 바꿔 끼운 배포: 부른 thread에서 돌리지 않는 executor여야 한다(CallerRunsPolicy·직접 실행 executor는 두 시한이 dispatch thread를 풀지 못한다). ThreadPoolExecutor가 아니면 pool 합 검사도 하지 않는다.
컴파일이 바뀌는 곳:MongoTenantClientRegistry.acquire가 Lease를 돌려주고, acquire(tenant, Instant)는 없다. 버리던 호출도 컴파일은 되지만 닫지 않으면 cap을 차지한다. migration refresh는 MongoOperationRejectedException을 던지고, ledger 생성자는 lock collection을 함께 받는다. SmtpNotificationProviderAdapter 생성자가 timeout을 받는다.
동작: profile timeout을 넘은 SMTP 발송은 결과 불명이다. 1 MiB를 넘는 캐시 값은 기록하지 않는다. 바이트 예산을 넘는 집계는 거절된다. max-wire-bytes는 압축된 크기로 센다.
알고 남긴 한계: S3에서 두 writer가 같은 버전에서 같은 record를 쓰면 둘 다 성공으로 본다(Javadoc과 안내 3절). 집계 결과는 converter로만 바뀌어 entity callback이 돌지 않는다(안내 4행). claim·fence 안내 6행이 적은 SMTP 한계는 이 PR의 SMTP 발송 상한으로 닫힌다.
그룹 B 경로 밖 한 줄:config/spotbugs/exclude.xml에 SMTP 대기 시한 메서드 하나의 DLS_DEAD_LOCAL_STORE 제외를 더했다. Error Prone이 요구하는 unused 변수와 SpotBugs가 부딪히는 곳이고, 같은 파일의 Jetty abortAtDeadline 제외와 같은 모양이다.
다른 묶음에 넘긴 것:docs/runbooks/outbox-publish-failed.md에 PUBLISH_WAIT_EXCEEDED·PUBLISH_WAIT_INTERRUPTED·PUBLISH_INTERRUPTED_BEFORE_SEND·PUBLISH_BOUND_NOT_POSITIVE 줄, Mongo evictionCloseFailures() 지표, SMTP 결과 불명 timeout을 provider health에 반영할지(runbook·지표·관측을 가진 그룹 A).
검증
RED: 고치기 전 트리에 새 시험만 얹어 desktop에서 돌렸다. 새 시험 9건 실패, cache-redis 시험은 컴파일 실패(~/r9-group-b-logs/pr2-red2.log). Mongo 셋(RR9-01-20·27·28)과 httpclient 스트리밍 풀기는 RED를 따로 돌리지 않았다.
GREEN: desktop scripts/verify.sh pr --on here --no-cache rc=0. 트리 5f4ad674(이 PR head, main 3e908c02 위), 시험 6978건(실패 0, skip 35), FROM-CACHE 0. 로그 ~/r9-group-b-logs/pr2-verify-r14.log.
전 모듈 컴파일(--continue, main·test·testFixtures·모든 시험 source set) rc=0.
처음 desktop에서 끝까지 돌렸을 때 빌드 검사에 세 가지가 걸려 고쳤다. Error Prone FutureReturnValueIgnored(SMTP 대기 시한), StringSplitter(ContentDecoding), SpotBugs USO_UNSAFE_OBJECT_SYNCHRONIZATION(MongoTenantClientRegistry가 자기 인스턴스로 잠가 밖에서 같은 monitor를 잡을 수 있었다 → 전용 lock).
## 무엇을, 왜
2026-11-12 전체 리뷰의 B10a(발행·발송·캐시)와 B10b(S3·Mongo·httpclient) 발견 13건을 고친다. claim·fence PR(#33) 위에 쌓았다. 그 PR을 먼저 병합한다(SMTP lease 조건과 문서가 그 PR의 provider timeout 검사 위에 있다). #33 다음에 main(#29~#31)을 merge 커밋 하나로 받았다. 이 PR의 diff에는 #33이 병합되기 전까지 #33의 커밋이 함께 보인다. 이 PR의 커밋은 마지막 둘이다.
- **시간 상한이 실제 대기를 묶지 않는다.** outbox 발행 대기는 `publish()`가 돌아온 뒤부터 잰다. 그래서 호출을 붙잡는 publisher는 `longestAttempt`를 넘겨도 relay를 묶고, lease가 지나 같은 event를 두 번 낸다. Redis 캐시는 `command-timeout`에 lane 대기 2초가 더해진다. SMTP profile timeout은 명령 하나만 묶어, 느린 relay에서 발송이 lease를 넘으면 lease 복구가 아직 도는 발송을 운영자 확인으로 넘긴다.
- **SMTP 발송 pool이 직렬이다.** core thread 1개에 대기열 4n이라, 대기열이 찰 때까지 thread 하나로 돈다. max-concurrency가 pool이 담는 수를 넘어도 기동한다. 넘친 발송은 결과 불명으로 남아 운영자를 기다린다.
- **크기 상한이 없거나 잘못 센다.** 캐시 값 크기 상한이 없다. MongoDB 집계는 결과를 전부 메모리에 올린 뒤 센다. HTTP 압축을 켜면 Apache가 푼 크기를 wire 계수기가 센다.
- **자기 쓰기를 충돌로 본다.** SDK가 응답을 잃고 다시 보낸 S3 조건부 PUT의 412를 충돌로 본다.
- **tenant client와 migration lease.** tenant client registry는 쓰는 중인 client를 닫고, 닫기 실패가 다른 tenant의 acquire를 실패시킨다. migration lease를 잃은 runner가 그 뒤에도 checkpoint를 쓴다.
- **SOCKS proxy와 문서.** SOCKS proxy를 HTTP proxy로 붙인다. 408·429 재시도와 Redis 같은 키 재전송은 문서가 조건 없이 약속한다.
## 고른 방법과 버린 대안
- **발행 대기 마감은 `publish()` 전에 잡는다.** 남은 시간만 기다린다. 기다리는 중의 인터럽트는 결과 불명으로 끝내고 인터럽트 표시를 남긴다. 이미 인터럽트된 relay thread와 0 이하의 `longestAttempt()`는 발행하지 않고 `REJECTED_RETRYABLE`(`PUBLISH_INTERRUPTED_BEFORE_SEND`·`PUBLISH_BOUND_NOT_POSITIVE`)로 답한다. relay는 시도로 세지 않고 backoff 뒤에 다시 본다. 버린 대안: `orTimeout`(stage가 끝나지 않으면 publisher 쪽 시간을 못 센다).
- **SMTP pool은 thread와 대기열을 고정한다.** `dispatch-concurrency`개 thread와 그 네 배(`QUEUED_SENDS_PER_THREAD`) 대기열이다. SMTP profile들의 max-concurrency 합이 그보다 크면 조립이 실패한다. 한 family의 켜진 profile 전체를 보는 검사는 새 default 메서드 `ProviderRuntimeAssembler.requireTogether(profiles, deliveryLease)`가 하고, `NotificationProviderAssembly`가 SERVING일 때 family마다 한 번 부른다. 버린 대안: assembler가 `assemble`마다 합을 누적하기(조립 순서에 상태가 남는다). pool이 거절한 발송은 relay에 닿지 않은 것으로 기록하고 재시도한다.
- **SMTP 발송은 profile timeout으로 두 번 묶는다.** pool에서 그 시간 안에 시작하지 못한 발송은 버리고(보내지 않음, 재시도), 시작한 뒤 그 시간을 넘긴 발송은 `PROVIDER_RESPONSE_LOST`(자동 재발송 없음)다. 기동 때 timeout은 connect timeout + 명령 timeout 하나보다 길어야 한다. 그래야 인사말을 주지 않는 relay가 socket timeout으로 먼저 안전한 재시도가 된다. lease는 timeout 두 배(대기 + 발송)보다 길어야 기동한다. 두 시한은 `completeOnTimeout`이라 pool이 발송을 받으면 대기 시한이 취소된다. 기본 timeout을 10초에서 30초로 올렸다. 버린 대안: submit부터 한 번 재기(대기열에서 기다린 발송을 결과 불명으로 닫은 뒤 permit 밖에서 실제로 보냈다), timeout 뒤 재시도(같은 메일을 두 번 보낼 수 있다).
- **Redis.** 연산 전체를 `command-timeout` 하나로 묶는다(rate limit과 같은 `effectWithin`). 값 상한은 `app.capabilities.cache.maximum-value-bytes`로 설정하게 한다. 버린 대안: 상수로 두기(큰 값을 쓰는 서비스가 바꿀 길이 없다).
- **S3.** 412에서 다시 읽어 이 호출이 쓴 record 그대로면 성공으로 본다. 버린 대안: 조건부 PUT의 SDK 재시도 끄기(응답을 잃은 첫 쓰기의 결과를 여전히 모른다).
- **MongoDB.** 집계는 `$limit(maxResults + 1)`과 `maxResultBytes`를 집행한다. registry는 `Lease`를 돌려주고, 쓰는 중에는 내보내지 않는다. idle은 마지막 close부터 잰다. 시계는 생성자의 `Clock` 하나다(시각을 받던 `acquire` overload를 지웠다). 닫기 실패는 `evictionCloseFailures`가 센다. migration ledger는 lock 문서의 최신 fence와 새 runner의 checkpoint 둘 다로 바뀐 runner의 기록을 거절한다. 버린 대안: 집계를 `RawBsonDocument`로 재기(converter를 거치지 않으면 반환 타입 mapping이 갈라진다).
- **HTTP client.** `ProxyType`은 `HTTP`만 남긴다. 버린 대안: SOCKS 지원(transport 셋 중 하나만 된다). 압축은 RestClient 기본 헤더로 보내고, `ContentDecoding`이 버퍼·스트리밍 본문을 모두 푼다(보내는 coding 목록도 그 클래스가 가진다). 겹친 coding과 그 밖의 coding은 `HttpTargetRejectedException`(응답 받음 증거)으로 거부한다. 빈 본문은 빈 본문이다. 스트리밍은 identity 본문도 decoded 한도로 센다. Jetty HTTP/3는 기동 뒤 자기 decoder를 비운다. 버린 대안: transport마다 자동으로 풀기(크기 상한을 세는 곳이 transport마다 달라진다).
- **문서.** 408·425·429는 안전하게 멱등인 연산만 재시도한다고 고친다(코드와 같다). Redis 같은 키 재전송에는 failover 비동기 복제 손실 한계를 적는다(manual 05, http-contract).
## 정한 기본값
- SMTP 발송 대기열 = thread 수 × 4.
- SMTP profile timeout 30초(전 10초). connect 5초 + 명령 10초인 출하 socket timeout보다 길다.
- 캐시 값 상한 1 MiB(`APP_CACHE_REDIS_MAXIMUM_VALUE_BYTES`, 1..16777216).
- 압축을 켜면 `Accept-Encoding: gzip, deflate`.
## 위험과 영향
기동 조건, 공개 타입, 동작이 바뀐다. 파생 서비스가 할 일은 `docs/upgrade/2026-11-round9-outbound.md`의 2절 아홉 줄이다. 요약:
- **기동이 실패하는 곳:** SMTP profile들의 max-concurrency 합 > thread × 5, SMTP timeout ≤ connect + 명령 timeout, `dispatch.lease-duration` ≤ SMTP timeout × 2, 캐시 값 상한 범위 밖, `proxy.type: SOCKS`.
- **send pool을 바꿔 끼운 배포:** 부른 thread에서 돌리지 않는 executor여야 한다(`CallerRunsPolicy`·직접 실행 executor는 두 시한이 dispatch thread를 풀지 못한다). `ThreadPoolExecutor`가 아니면 pool 합 검사도 하지 않는다.
- **컴파일이 바뀌는 곳:** `MongoTenantClientRegistry.acquire`가 `Lease`를 돌려주고, `acquire(tenant, Instant)`는 없다. 버리던 호출도 컴파일은 되지만 닫지 않으면 cap을 차지한다. migration `refresh`는 `MongoOperationRejectedException`을 던지고, ledger 생성자는 lock collection을 함께 받는다. `SmtpNotificationProviderAdapter` 생성자가 timeout을 받는다.
- **동작:** profile timeout을 넘은 SMTP 발송은 결과 불명이다. 1 MiB를 넘는 캐시 값은 기록하지 않는다. 바이트 예산을 넘는 집계는 거절된다. `max-wire-bytes`는 압축된 크기로 센다.
- **알고 남긴 한계:** S3에서 두 writer가 같은 버전에서 같은 record를 쓰면 둘 다 성공으로 본다(Javadoc과 안내 3절). 집계 결과는 converter로만 바뀌어 entity callback이 돌지 않는다(안내 4행). claim·fence 안내 6행이 적은 SMTP 한계는 이 PR의 SMTP 발송 상한으로 닫힌다.
- **그룹 B 경로 밖 한 줄:** `config/spotbugs/exclude.xml`에 SMTP 대기 시한 메서드 하나의 `DLS_DEAD_LOCAL_STORE` 제외를 더했다. Error Prone이 요구하는 `unused` 변수와 SpotBugs가 부딪히는 곳이고, 같은 파일의 Jetty `abortAtDeadline` 제외와 같은 모양이다.
- **다른 묶음에 넘긴 것:** `docs/runbooks/outbox-publish-failed.md`에 `PUBLISH_WAIT_EXCEEDED`·`PUBLISH_WAIT_INTERRUPTED`·`PUBLISH_INTERRUPTED_BEFORE_SEND`·`PUBLISH_BOUND_NOT_POSITIVE` 줄, Mongo `evictionCloseFailures()` 지표, SMTP 결과 불명 timeout을 provider health에 반영할지(runbook·지표·관측을 가진 그룹 A).
## 검증
- RED: 고치기 전 트리에 새 시험만 얹어 desktop에서 돌렸다. 새 시험 9건 실패, cache-redis 시험은 컴파일 실패(`~/r9-group-b-logs/pr2-red2.log`). Mongo 셋(RR9-01-20·27·28)과 httpclient 스트리밍 풀기는 RED를 따로 돌리지 않았다.
- GREEN: desktop `scripts/verify.sh pr --on here --no-cache` rc=0. 트리 `5f4ad674`(이 PR head, main `3e908c02` 위), 시험 6978건(실패 0, skip 35), FROM-CACHE 0. 로그 `~/r9-group-b-logs/pr2-verify-r14.log`.
- 전 모듈 컴파일(`--continue`, main·test·testFixtures·모든 시험 source set) rc=0.
- lane: `:adapter:outbound:persistence-mongo:mongoMigrationTest`, `:adapter:outbound:httpclient:httpClientStableContractTest` rc=0, 35건.
- 중간 커밋: B10a 커밋 트리 `6786d55c`만으로 application-core·cache-redis·messaging·notification·composition notification-platform `check`와 `verifyEnvKeys` rc=0, 1156건(skip 20).
- 처음 desktop에서 끝까지 돌렸을 때 빌드 검사에 세 가지가 걸려 고쳤다. Error Prone `FutureReturnValueIgnored`(SMTP 대기 시한), `StringSplitter`(`ContentDecoding`), SpotBugs `USO_UNSAFE_OBJECT_SYNCHRONIZATION`(`MongoTenantClientRegistry`가 자기 인스턴스로 잠가 밖에서 같은 monitor를 잡을 수 있었다 → 전용 lock).
- 노트북: `python3 scripts/check-docs.py`, `python3 scripts/check-work-docs.py` 통과.
## 리뷰어가 볼 곳
- `OutboxMessagePublishAdapter`(마감 계산), `SmtpNotificationProviderAdapter`·`NotificationSmtpProviderConfig`(pool·발송 상한), `RedisCacheRegionAdapter`.
- `SmtpNotificationProviderAdapter.PooledSend`(대기·발송 두 마감의 상태 기계), `SmtpProviderRuntimeAssembler.requireTogether`와 그 호출 시험 `NotificationProviderAssemblyTest`.
- `restclient/ContentDecoding`, `BlockingStreamingGateway`(준비 실패 판정 `setupFailure`), `RestClientRuntimeFactory`, `JettyHttp3TransportProvider`.
- `MongoTenantClientRegistry`, `MongoCollectionMigrationLedger`, `S3ConditionalObjectControlStore`.
## 관련
- 리뷰: `docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.md`
- 안내: `docs/upgrade/2026-11-round9-outbound.md`
## 발견 표
| ID | 판정 | 커밋 |
| --- | --- | --- |
| RR9-01-05 | 고침 | 154cb4b7 |
| RR9-01-15 | 고침 | 154cb4b7 |
| RR9-01-16 | 고침 | 154cb4b7 |
| RR9-01-17 | 고침 | 154cb4b7 |
| RR9-01-18 | 고침 | 154cb4b7 |
| RR9-01-08 | 고침 | 93117876 |
| RR9-01-11 | 고침 | 93117876 |
| RR9-01-19 | 고침 | 93117876 |
| RR9-01-20 | 고침 | 93117876 |
| RR9-01-27 | 고침 | 93117876 |
| RR9-01-28 | 고침 | 93117876 |
| RR9-01-30 | 고침 | 93117876 |
| RR9-01-31 | 고침 | 93117876 |
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
outbox 발행 대기가 publish()가 돌아온 뒤부터 재서, 호출을 붙잡은
publisher는 longestAttempt를 넘겨도 relay를 묶는다. SMTP 발송 pool은
대기열이 찰 때까지 thread 하나로 돌고, profile들의 max-concurrency가 pool이
담는 수를 넘어도 기동한다. 넘친 발송은 결과 불명으로 남는다. SMTP
profile timeout은 명령 하나만 묶어, 느린 relay에서 발송이 lease를 넘으면
lease 복구가 아직 도는 발송을 운영자 확인으로 넘긴다. Redis 캐시
command-timeout에 lane 대기 2초가 더해지고, 값 크기 상한은 설정할 길이
없다.
고른 방법: 발행 대기 마감은 publish() 전에 잡고 남은 시간만 기다린다.
기다리는 중 interrupt는 결과 불명, 이미 interrupt된 thread와 0 이하
longestAttempt는 보내지 않고 REJECTED_RETRYABLE로 돌려준다. SMTP pool은
dispatch-concurrency개 thread와 그 네 배 대기열로 고정한다. 한 family의
켜진 profile 전체를 보는 ProviderRuntimeAssembler.requireTogether를 두고,
SMTP는 max-concurrency 합이 pool보다 크거나 lease가 timeout 두 배 이하면
조립을 실패시킨다. profile timeout은 발송 한 번을 두 번 묶는다:
pool 대기가 넘으면 보내지 않고 재시도, 발송이 넘으면 PROVIDER_RESPONSE_LOST
로 남겨 다시 보내지 않는다. 두 시한은 completeOnTimeout이라 취소된다.
기본 timeout은 10초에서 30초로, socket timeout 합보다 길어야 한다.
Redis 연산 전체를 command-timeout 하나로 묶고
app.capabilities.cache.maximum-value-bytes를 다시 묶는다(1..16 MiB).
버린 대안: 발송 timeout에 재시도(같은 메일을 두 번 보낼 수 있다), 캐시
상한을 상수로 두기(큰 값을 쓰는 서비스가 바꿀 길이 없다), assembler가
assemble마다 합을 누적하기(조립 순서에 상태가 남는다).
위험·한계: 기동 조건이 늘었다(SMTP max-concurrency 합, lease와 SMTP
timeout, 캐시 값 상한 범위). 대기 시한이 돌려주는 stage는 일부러 버린다
(Error Prone 규칙대로 `unused`에 받고, SpotBugs DLS는 config/spotbugs/
exclude.xml에 그 메서드만 제외한다. Jetty abortAtDeadline 선례). send pool을 바꿔 끼운 배포는 부른 thread에서
돌리지 않는 executor여야 한다. outbox 새 거절 코드의 runbook 줄은 runbook
묶음에 넘긴다. claim·fence 커밋 위에 쌓았다.
검증: desktop RED(고치기 전 트리 + 새 시험, pr2-red2) 새 시험 실패.
GREEN은 PR 본문의 verify.sh pr 결과.
Refs: RR9-01-05, RR9-01-15, RR9-01-16, RR9-01-17, RR9-01-18
BREAKING CHANGE: SMTP profile들의 max-concurrency 합이 send pool(thread와 대기열)을 넘거나 dispatch.lease-duration이 SMTP timeout의 두 배 이하면 기동이 실패한다. SMTP 기본 timeout이 30초이고, 넘은 발송은 결과 불명이 된다. SmtpNotificationProviderAdapter 생성자가 timeout을 받는다. Redis 캐시 값이 maximum-value-bytes(기본 1 MiB)를 넘으면 기록하지 않는다. docs/upgrade/2026-11-round9-outbound.md
S3 control 저장소는 SDK가 응답을 잃고 다시 보낸 조건부 PUT의 412를
충돌로 본다. MongoDB 집계는 결과 바이트 예산을 보지 않고 전부 메모리에
올린다. tenant client registry는 쓰는 중인 client를 내보내고, 내보내다
닫기에 실패하면 다른 tenant의 acquire가 실패한다. migration lease를 잃은
runner가 그 뒤에도 checkpoint를 쓴다. HTTP client는 SOCKS proxy를 HTTP로
붙이고, 압축을 켜면 Apache는 스스로 풀어 max-wire-bytes가 푼 크기를
세며, JDK transport는 그 설정을 읽지 않는다.
고른 방법: S3는 412에서 다시 읽어 이 호출이 쓴 record 그대로면 성공으로
본다. 집계는 $limit(maxResults + 1)과 maxResultBytes를 집행한다. registry
acquire는 Lease를 돌려주고 쓰는 중에는 내보내지 않으며 idle은 마지막
close부터 잰다. 상한·lease 수·내보내기는 registry 밖에서 잡을 수 없는 전용
lock 하나로 묶는다. 닫기 실패는 evictionCloseFailures가 센다. migration
ledger는 lock 문서의 현재 fence로 쓴다. ProxyType은 HTTP만 남긴다.
압축은 RestClient 기본 헤더로 보내고 ContentDecoding이 버퍼·스트리밍
본문을 모두 푼다(겹친 coding과 그 밖의 coding은 거부, 빈 본문은 빈
본문). Jetty HTTP/3는 기동 뒤 decoder를 비운다. 버린 대안: SOCKS 지원
(transport 셋 중 하나만 된다), transport마다 자동 풀기(크기 상한이
transport마다 달라진다), 집계를 RawBsonDocument로 재기(converter를 거치지
않으면 반환 타입 mapping이 갈라진다).
위험·한계: MongoTenantClientRegistry.acquire 반환형과 ProxyType이 바뀐다.
S3에서 두 writer가 같은 버전에서 같은 record를 쓰면 둘 다 성공으로 본다
(Javadoc과 안내 3절). 집계 결과는 converter로만 바뀌어 entity callback이
돌지 않는다. evictionCloseFailures 지표는 지표 묶음에 넘긴다.
검증: desktop RED(pr2-red2). GREEN은 PR 본문의 verify.sh pr 결과.
Refs: RR9-01-08, RR9-01-11, RR9-01-19, RR9-01-20, RR9-01-27, RR9-01-28, RR9-01-30, RR9-01-31
BREAKING CHANGE: MongoTenantClientRegistry.acquire가 Lease를 돌려주고, migration lease를 잃은 refresh가 MongoOperationRejectedException을 던진다. HTTP client ProxyType.SOCKS가 없어져 그 설정은 바인딩이 실패한다. request.compression이 모든 transport에서 같은 coding만 받는다. docs/upgrade/2026-11-round9-outbound.md
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 전체 리뷰의 B10a(발행·발송·캐시)와 B10b(S3·Mongo·httpclient) 발견 13건을 고친다. claim·fence PR(#33) 위에 쌓았다. 그 PR을 먼저 병합한다(SMTP lease 조건과 문서가 그 PR의 provider timeout 검사 위에 있다). #33 다음에 main(#29~#31)을 merge 커밋 하나로 받았다. 이 PR의 diff에는 #33이 병합되기 전까지 #33의 커밋이 함께 보인다. 이 PR의 커밋은 마지막 둘이다.
publish()가 돌아온 뒤부터 잰다. 그래서 호출을 붙잡는 publisher는longestAttempt를 넘겨도 relay를 묶고, lease가 지나 같은 event를 두 번 낸다. Redis 캐시는command-timeout에 lane 대기 2초가 더해진다. SMTP profile timeout은 명령 하나만 묶어, 느린 relay에서 발송이 lease를 넘으면 lease 복구가 아직 도는 발송을 운영자 확인으로 넘긴다.고른 방법과 버린 대안
publish()전에 잡는다. 남은 시간만 기다린다. 기다리는 중의 인터럽트는 결과 불명으로 끝내고 인터럽트 표시를 남긴다. 이미 인터럽트된 relay thread와 0 이하의longestAttempt()는 발행하지 않고REJECTED_RETRYABLE(PUBLISH_INTERRUPTED_BEFORE_SEND·PUBLISH_BOUND_NOT_POSITIVE)로 답한다. relay는 시도로 세지 않고 backoff 뒤에 다시 본다. 버린 대안:orTimeout(stage가 끝나지 않으면 publisher 쪽 시간을 못 센다).dispatch-concurrency개 thread와 그 네 배(QUEUED_SENDS_PER_THREAD) 대기열이다. SMTP profile들의 max-concurrency 합이 그보다 크면 조립이 실패한다. 한 family의 켜진 profile 전체를 보는 검사는 새 default 메서드ProviderRuntimeAssembler.requireTogether(profiles, deliveryLease)가 하고,NotificationProviderAssembly가 SERVING일 때 family마다 한 번 부른다. 버린 대안: assembler가assemble마다 합을 누적하기(조립 순서에 상태가 남는다). pool이 거절한 발송은 relay에 닿지 않은 것으로 기록하고 재시도한다.PROVIDER_RESPONSE_LOST(자동 재발송 없음)다. 기동 때 timeout은 connect timeout + 명령 timeout 하나보다 길어야 한다. 그래야 인사말을 주지 않는 relay가 socket timeout으로 먼저 안전한 재시도가 된다. lease는 timeout 두 배(대기 + 발송)보다 길어야 기동한다. 두 시한은completeOnTimeout이라 pool이 발송을 받으면 대기 시한이 취소된다. 기본 timeout을 10초에서 30초로 올렸다. 버린 대안: submit부터 한 번 재기(대기열에서 기다린 발송을 결과 불명으로 닫은 뒤 permit 밖에서 실제로 보냈다), timeout 뒤 재시도(같은 메일을 두 번 보낼 수 있다).command-timeout하나로 묶는다(rate limit과 같은effectWithin). 값 상한은app.capabilities.cache.maximum-value-bytes로 설정하게 한다. 버린 대안: 상수로 두기(큰 값을 쓰는 서비스가 바꿀 길이 없다).$limit(maxResults + 1)과maxResultBytes를 집행한다. registry는Lease를 돌려주고, 쓰는 중에는 내보내지 않는다. idle은 마지막 close부터 잰다. 시계는 생성자의Clock하나다(시각을 받던acquireoverload를 지웠다). 닫기 실패는evictionCloseFailures가 센다. migration ledger는 lock 문서의 최신 fence와 새 runner의 checkpoint 둘 다로 바뀐 runner의 기록을 거절한다. 버린 대안: 집계를RawBsonDocument로 재기(converter를 거치지 않으면 반환 타입 mapping이 갈라진다).ProxyType은HTTP만 남긴다. 버린 대안: SOCKS 지원(transport 셋 중 하나만 된다). 압축은 RestClient 기본 헤더로 보내고,ContentDecoding이 버퍼·스트리밍 본문을 모두 푼다(보내는 coding 목록도 그 클래스가 가진다). 겹친 coding과 그 밖의 coding은HttpTargetRejectedException(응답 받음 증거)으로 거부한다. 빈 본문은 빈 본문이다. 스트리밍은 identity 본문도 decoded 한도로 센다. Jetty HTTP/3는 기동 뒤 자기 decoder를 비운다. 버린 대안: transport마다 자동으로 풀기(크기 상한을 세는 곳이 transport마다 달라진다).정한 기본값
APP_CACHE_REDIS_MAXIMUM_VALUE_BYTES, 1..16777216).Accept-Encoding: gzip, deflate.위험과 영향
기동 조건, 공개 타입, 동작이 바뀐다. 파생 서비스가 할 일은
docs/upgrade/2026-11-round9-outbound.md의 2절 아홉 줄이다. 요약:dispatch.lease-duration≤ SMTP timeout × 2, 캐시 값 상한 범위 밖,proxy.type: SOCKS.CallerRunsPolicy·직접 실행 executor는 두 시한이 dispatch thread를 풀지 못한다).ThreadPoolExecutor가 아니면 pool 합 검사도 하지 않는다.MongoTenantClientRegistry.acquire가Lease를 돌려주고,acquire(tenant, Instant)는 없다. 버리던 호출도 컴파일은 되지만 닫지 않으면 cap을 차지한다. migrationrefresh는MongoOperationRejectedException을 던지고, ledger 생성자는 lock collection을 함께 받는다.SmtpNotificationProviderAdapter생성자가 timeout을 받는다.max-wire-bytes는 압축된 크기로 센다.config/spotbugs/exclude.xml에 SMTP 대기 시한 메서드 하나의DLS_DEAD_LOCAL_STORE제외를 더했다. Error Prone이 요구하는unused변수와 SpotBugs가 부딪히는 곳이고, 같은 파일의 JettyabortAtDeadline제외와 같은 모양이다.docs/runbooks/outbox-publish-failed.md에PUBLISH_WAIT_EXCEEDED·PUBLISH_WAIT_INTERRUPTED·PUBLISH_INTERRUPTED_BEFORE_SEND·PUBLISH_BOUND_NOT_POSITIVE줄, MongoevictionCloseFailures()지표, SMTP 결과 불명 timeout을 provider health에 반영할지(runbook·지표·관측을 가진 그룹 A).검증
~/r9-group-b-logs/pr2-red2.log). Mongo 셋(RR9-01-20·27·28)과 httpclient 스트리밍 풀기는 RED를 따로 돌리지 않았다.scripts/verify.sh pr --on here --no-cacherc=0. 트리5f4ad674(이 PR head, main3e908c02위), 시험 6978건(실패 0, skip 35), FROM-CACHE 0. 로그~/r9-group-b-logs/pr2-verify-r14.log.--continue, main·test·testFixtures·모든 시험 source set) rc=0.:adapter:outbound:persistence-mongo:mongoMigrationTest,:adapter:outbound:httpclient:httpClientStableContractTestrc=0, 35건.6786d55c만으로 application-core·cache-redis·messaging·notification·composition notification-platformcheck와verifyEnvKeysrc=0, 1156건(skip 20).FutureReturnValueIgnored(SMTP 대기 시한),StringSplitter(ContentDecoding), SpotBugsUSO_UNSAFE_OBJECT_SYNCHRONIZATION(MongoTenantClientRegistry가 자기 인스턴스로 잠가 밖에서 같은 monitor를 잡을 수 있었다 → 전용 lock).python3 scripts/check-docs.py,python3 scripts/check-work-docs.py통과.리뷰어가 볼 곳
OutboxMessagePublishAdapter(마감 계산),SmtpNotificationProviderAdapter·NotificationSmtpProviderConfig(pool·발송 상한),RedisCacheRegionAdapter.SmtpNotificationProviderAdapter.PooledSend(대기·발송 두 마감의 상태 기계),SmtpProviderRuntimeAssembler.requireTogether와 그 호출 시험NotificationProviderAssemblyTest.restclient/ContentDecoding,BlockingStreamingGateway(준비 실패 판정setupFailure),RestClientRuntimeFactory,JettyHttp3TransportProvider.MongoTenantClientRegistry,MongoCollectionMigrationLedger,S3ConditionalObjectControlStore.관련
docs/reviews/2026-11-12-round9-review/01-persistence-messaging-performance.mddocs/upgrade/2026-11-round9-outbound.md발견 표
154cb4b7154cb4b7154cb4b7154cb4b7154cb4b793117876931178769311787693117876931178769311787693117876931178763e908c02, round9 #29~#31)을 받는다 141c2a4f6d