Errors
DSAR-VB-1002: STORAGE_VERCEL_BLOB_RETRY_EXHAUSTED
Alpha
DSAR is currently in alpha. APIs, package surfaces, configuration, and documentation may change as the project evolves.
Meaning
A Vercel Blob storage operation failed after exhausting all configured retry attempts.
Probable Causes
- Persistent transient errors (timeouts, rate limits, network issues) across all retries.
- Vercel Blob service experiencing an extended outage.
- Retry budget (
retryMaxAttempts) is too low for the current error rate.
How to Fix
- Inspect
error.details.lastError.messageanderror.details.lastError.codeto identify the underlying failure class. - Confirm retry metadata (
error.details.attemptsorerror.details.lastAttempt) anderror.operation/error.typeso logs show exactly which operation exhausted retries. - Surface these fields in logs and alerts:
lastError.message,lastError.code, retry attempt count, and failed operation/type. - Check Vercel status (
https://www.vercel-status.com, or your org status page) for incidents during the failure window. - If needed, tune retry settings (for example
storageAdapter.retryMaxAttemptsandstorageAdapter.retryBackoffMs) and document expected values per environment. - Verify blob endpoint reachability and validate storage adapter credentials/tokens.
Retryable
Not automatically retryable until the root cause is addressed. Retries are exhausted for the current operation, but a new attempt may succeed after fixing the underlying issue.
Minimal Trigger Example
A Vercel Blob put or list operation that fails with retriable errors on every attempt up to the configured maximum.