fix(browser-transfer): 상한보다 긴 Retry-After는 앱에도 retryable:false로 준다
문제: part 단계(BFF 발급, object store PUT)가 상한(maxRetryAfterMs, 기본 30초)보다 긴 Retry-After로 429·503을 받으면 runtime은 기다리지 않고 멈춘다. 그런데 앱에 주는 실패는 retryable:true다. 포트 표대로면 "자동 재시도해도 된다"는 뜻이라, 서버가 45초 기다리라고 한 요청을 앱이 바로 다시 보낸다. 같은 429에 control plane 전송은 retryable:false를 준다. control plane도 전송 상한이 정책 상한보다 크면 retryable:true가 된다. 고친 방법: provider 실패를 앱 실패로 바꾸는 한 곳(stripProviderFailure)이 정책 상한을 받아, 지우는 retryAfterMs가 상한을 넘었으면 retryable을 false로 만든다. control plane 전송이 이미 쓰는 규칙이다. 한 곳에서 하므로 두 단계와 두 factory 상한 조합이 모두 같은 답을 낸다. 포트 주석과 설계 문서(presigned-transfer-and-image-cdn.md 7절)에 같은 규칙을 적었다. 버린 대안: 현상 유지 + 포트 주의 한 줄은 앱이 기다릴 값을 모르므로 지킬 수 없다. 앱 실패에 retryAfterMs를 싣는 안은 공유 타입 BrowserDataFailure를 바꿔 다른 포트까지 퍼진다. 상한 밖 값도 기다리는 안은 한 호출이 끝없이 늘어지지 않는다는 상한의 목적을 깬다(리뷰 5절 D2). 위험·한계: upload()·abort()의 실패 값이 바뀐다. 상한 밖 Retry-After는 RESUME에 retryable:false가 되어, 자동 재시도하던 다운스트림은 사람이 누르는 재시도로 넘어간다. 상한 안 대기, PUT 403 재발급, 발급 401/403 NONE은 바뀌지 않는다(기존 테스트 그대로 통과). 헤더 없는 part 단계 429가 backoff로 재시도하는 차이는 이 변경 범위 밖이다. 검증: - 고치기 전: 새 단언 5건 실패(part 단계 4건, 전송 상한 60초 조합 1건) - 고친 뒤: 영역 단위 테스트 15파일 274건 통과 - check:types, eslint(바꾼 파일) 통과 Refs: docs/reviews/2026-11-03-maturity-review/01-adapters-browser-transfer.md 01-02
This commit is contained in:
@@ -120,7 +120,10 @@ export interface ResumableUploadPort {
|
||||
* | | only replay. |
|
||||
*
|
||||
* No other recovery value is returned from `upload()`. `NONE` and
|
||||
* `RESELECT` always come with `retryable: false` (0929/01-01).
|
||||
* `RESELECT` always come with `retryable: false` (0929/01-01). A server
|
||||
* `Retry-After` longer than the runtime's `maxRetryAfterMs` comes back as
|
||||
* `RESUME` with `retryable: false`: the runtime did not wait that long, so
|
||||
* the caller does not resend at once either (2026-11-03 01-02).
|
||||
*/
|
||||
upload(
|
||||
request: ResumableUploadRequest,
|
||||
|
||||
Reference in New Issue
Block a user