From 154cb4b7959916b66fcd99b18380967d59b83924 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 16:21:16 +0900 Subject: [PATCH] =?UTF-8?q?fix(outbound)!:=20=EB=B0=9C=ED=96=89=20?= =?UTF-8?q?=EB=8C=80=EA=B8=B0=C2=B7SMTP=20=EB=B0=9C=EC=86=A1=C2=B7?= =?UTF-8?q?=EC=BA=90=EC=8B=9C=20=EC=8B=9C=EA=B0=84=20=EC=83=81=ED=95=9C?= =?UTF-8?q?=EC=9D=84=20=EC=A7=80=ED=82=A8=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .env.example | 3 +- config/spotbugs/exclude.xml | 9 ++ docs/notification/configuration-reference.md | 33 +++- docs/registries/env-keys.yaml | 11 +- docs/upgrade/2026-11-round9-claim-fence.md | 2 +- docs/upgrade/2026-11-round9-outbound.md | 29 ++++ src/adapter/outbound/cache-redis/README.md | 7 +- .../cache/redis/SemanticRedisCall.java | 24 +++ .../redis/cache/RedisCacheRegionAdapter.java | 73 ++++++++- .../redis/capability/RedisCacheConfig.java | 3 +- .../capability/RedisCapabilitySettings.java | 26 +++ .../config/module-defaults/cache-redis.yml | 3 + .../cache/RedisCacheRegionAdapterTest.java | 127 ++++++++++++++- .../RedisCacheValueCeilingSettingTest.java | 40 +++++ src/adapter/outbound/messaging/AGENTS.md | 4 +- src/adapter/outbound/messaging/README.md | 11 ++ .../outbox/OutboxMessagePublishAdapter.java | 69 +++++++- .../OutboxMessagePublishAdapterTest.java | 150 ++++++++++++++++++ .../NotificationProviderAssembly.java | 28 ++++ .../NotificationSmtpProviderConfig.java | 20 ++- .../ProviderRuntimeAssembler.java | 18 +++ .../SmtpProviderRuntimeAssembler.java | 101 +++++++++++- .../smtp/SmtpNotificationProviderAdapter.java | 140 +++++++++++++++- .../NotificationProviderAssemblyTest.java | 118 ++++++++++++++ .../NotificationSmtpExecutorTest.java | 58 +++++++ .../SmtpProviderRuntimeAssemblerTest.java | 114 ++++++++++++- .../SmtpNotificationProviderAdapterTest.java | 130 ++++++++++++++- .../event/IntegrationEventPublishPort.java | 9 +- .../FakeIntegrationEventPublisher.java | 65 +++++++- .../config/module-defaults/notification.yml | 2 +- 30 files changed, 1384 insertions(+), 43 deletions(-) create mode 100644 docs/upgrade/2026-11-round9-outbound.md create mode 100644 src/adapter/outbound/cache-redis/src/test/java/dev/caskeleton/adapter/outbound/cache/redis/capability/RedisCacheValueCeilingSettingTest.java create mode 100644 src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/platform/autoconfigure/NotificationSmtpExecutorTest.java diff --git a/.env.example b/.env.example index 1c68b40e..09bb6b74 100644 --- a/.env.example +++ b/.env.example @@ -171,6 +171,7 @@ APP_CACHE_REDIS_COMMAND_TIMEOUT=200ms APP_CACHE_REDIS_POSITIVE_SOFT_TTL=30s APP_CACHE_REDIS_MINIMUM_HARD_TTL=1s APP_CACHE_REDIS_SEMANTIC_REGION=default +APP_CACHE_REDIS_MAXIMUM_VALUE_BYTES=1048576 APP_MESSAGING_BROKER=kafka APP_MESSAGING_PRODUCER_ID= APP_MESSAGING_KAFKA_BROKERS= @@ -293,7 +294,7 @@ APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=false APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY=true APP_NOTIFICATION_PLATFORM_SMTP_ENVIRONMENT=local APP_NOTIFICATION_PLATFORM_SMTP_CREDENTIAL_PROFILE=default -APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT=10s +APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT=30s APP_NOTIFICATION_PLATFORM_SMTP_MAX_CONCURRENCY=4 APP_NOTIFICATION_PLATFORM_SMTP_RATE_PER_SECOND=10 APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY=no-reply@example.invalid diff --git a/config/spotbugs/exclude.xml b/config/spotbugs/exclude.xml index 2ee07473..156d6eae 100644 --- a/config/spotbugs/exclude.xml +++ b/config/spotbugs/exclude.xml @@ -359,6 +359,15 @@ + + + + + + +