fix(objectstorage)!: 포트 밖으로 adapter 예외를 내보내지 않고 포트 실패 하나로 알린다 #45
Open
donghyeon.kang
wants to merge 1 commits from
claude/r9-objstore-exceptions into main
pull from: claude/r9-objstore-exceptions
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#45
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.
무엇을, 왜
round9 리뷰가 B20을 고치며 찾은 RR9-03-34를 고친다. objectstorage 포트 밖으로 adapter 예외가 그대로 나갔다. 저장소 실패, 내용 불일치, producer·consumer 실패가
ObjectStorageProviderException·ObjectControlConflictException(adapter 패키지)이었다. 포트를 쓰는 유스케이스는 그 타입을 import할 수 없어RuntimeException으로만 다뤘고, 포트 계약도 그 경우를 「어떤 unchecked 예외든」으로 비워 뒀다.model.ObjectStorageFailureException하나와 분류error()(ObjectOperationError).CONTENT_MISMATCH,CONTENT_PRODUCTION_FAILED,CONTENT_CONSUMPTION_FAILED.@throws로 선언한다.routing.ObjectStoragePortBoundary를 지난다.IllegalArgumentException·IllegalStateException)은 그대로 나간다.RoutingObjectPublicationHandoffAdapter로 옮겼다.provider.ContentCallbackFailures): 전에는 local·S3 모두 producer 자신의 실패, sink 안의 취소, sink의 쓰기 실패를IO_FAILURE하나로 뭉갰다.PRODUCER_FAILED·CONSUMER_FAILED가 되고, 그 예외가 원인으로 실린다.INDETERMINATE대신 body가 기록한 분류를 쓴다.REPLAYED다. producer는 다시 부르지 않는다.CONFLICT다.transferForScan. fake는IllegalStateException이었고, adapter는 abort가 지운 데이터를 읽으려다 provider 예외를 냈다. adapter도 같은 거절을 먼저 한다.IO_FAILURECORRUPT_DATA(읽지 않는 것은 그대로)IO_FAILUREINDETERMINATECORRUPT_DATAIO_FAILURE(다시 abort하면 된다)inspect가IllegalArgumentException으로 답했다. 이제 빈 값이고,transfer는 「게시되지 않음」 거절이다(포트 Javadoc대로). 같은 key로 다시 게시하면 끝난다.CANCELLED이고, provider·SDK 시한 초과는PROVIDER_UNAVAILABLE이다. 전에는 둘 다DEADLINE_EXCEEDED였다.UNSUPPORTED_CAPABILITY다(다시 해도 소용없다). create 전 확인(resolveCreate)이 이 거절과 손상까지 「결과 모름」으로 삼키던 것도 고쳤다. 이제 결과를 모르는 실패(IO·시한·throttle·불명)만 그렇다.CANCELLED다(local·fake는CONTENT_MISMATCH, S3는CANCELLED였다). 다 쓰고 스스로 실패한 producer는 S3에서도PRODUCER_FAILED다(SDK가 길이를 다 받고 거는 cancel을 취소로 세던 것).CONTENT_MISMATCH(호출자 바이트 문제)였다.CORRUPT_DATA로 바꿨다. PUT이 암호화 profile을 적용하지 않은 것은UNSUPPORTED다. body가 선언대로 끝났는데 S3가 BadDigest를 답하면 전송 중 손상이라IO_FAILURE다(다시 하면 된다). 읽기 증거 불일치(PRECONDITION_FAILED)도CORRUPT_DATA다. 전에는 포트에서 「그새 바뀜, 다시 해도 됨」으로 읽혔다.고른 방법과 버린 대안
ObjectOperationError(receipt가 이미 쓰는 분류)를 예외에도 쓴다. 예외마다 타입을 나누는 안(ObjectContentMismatchException등 여럿)은 버렸다. 유스케이스가 잡을 타입이 늘고, receipt의 분류와 두 어휘가 된다.try/catch를 두는 안은 버렸다. 메서드 하나를 빠뜨리면 다시 샌다. 경계 한 곳과 변환표 시험(ObjectStoragePortBoundaryTest)으로 고정한다.정한 기본값
ObjectOperationError에 값을 더하는 공개 API 변경이다. 소유자가 뒤집을 수 있다.위험과 영향(파생 서비스가 따라 할 일)
docs/upgrade/2026-11-round9-objectstorage.md5~14행. 커밋!하나.검증
desktop,
--no-build-cache.b21-red): 기준(B20) 코드에 새 시험과 선언 타입(포트 예외, enum 값)만 얹었다. adapter 쪽 15건이 실패하고 fake 쪽은 모두 통과했다. 실패한 곳은 포트 계약의 내용 불일치·producer·consumer·취소·중단 stage scan, provider 계약의 consumer 둘·producer, 겹친 게시 둘이다.b21-green8, 트리47483690): 두 leafcheck,architectureCheck,:app-bootstrap:architectureTest,testQualityCheck둘,objectStorageMinioContractTest(실제 MinIO). 663건 실패 0, rc=0. MinIO lane은 따로 다섯 번 다시 돌려 모두 통과했다(b21-green6).SdkClientException으로 감싸 consumer 실패가IO_FAILURE로 나왔다.callerSideReadFailure로 고쳤다.scripts/verify.sh pr --no-cache: heade7235bac(트리7a1986b5) 7103건 실패 0, 건너뜀 35, rc=0,FROM-CACHE0. 기준 mainc7a18ec7. 첫 실행은 SpotBugsUSO_UNSAFE_METHOD_SYNCHRONIZATION(바깥에 드러난 자기 객체로 잠금)을 잡았다.AtomicReference로 고쳤다. 둘째 실행에서는 새 BadDigest 시험이 mock 순서 때문에 흔들려 고쳤다. 그 뒤 rc=0이다scripts/verify.sh docsrc=0.call을 부르는지만 본다.발견 ID 표
e7235bac관련
c7a18ec7) 다음 묶음이다.docs/reviews/2026-11-12-round9-review/(기록 갱신 PR #36이 RR9-03-34를 적는다).View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.