feat: Add automatic retries for transient Postgrest errors#1246
Open
thagikura wants to merge 3 commits intosupabase-community:masterfrom
Open
feat: Add automatic retries for transient Postgrest errors#1246thagikura wants to merge 3 commits intosupabase-community:masterfrom
thagikura wants to merge 3 commits intosupabase-community:masterfrom
Conversation
Idempotent requests (GET, HEAD) that fail with network errors or HTTP 503/520 are now automatically retried with exponential backoff. - Default: 3 retries with delays of 1s, 2s, 4s (max 30s) - Configurable via Postgrest.Config.maxRetries - Per-query opt-out via noRetry() in the request builder - x-retry-count header sent on retried requests - Non-idempotent methods (POST, PATCH, DELETE) are not retried - Catches RestException for retryable HTTP status codes and HttpRequestException for network errors Closes supabase-community#1243
jan-tennert
reviewed
Apr 14, 2026
Contributor
Author
|
228d293 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What kind of change does this PR introduce?
Feature
Closes #1243
What is the current behavior?
All Postgrest requests fail immediately on transient errors (HTTP 503/520, network failures) with no retry
mechanism. This is problematic for intermittent infrastructure issues where a retry would succeed.
What is the new behavior?
Idempotent requests (GET, HEAD) are automatically retried with exponential backoff on transient errors:
Postgrest.Config.maxRetriesnoRetry()in the request builderx-retry-countheader sent on retried requestsAdditional context
Matches the retry behavior in supabase-js (PR supabase/supabase-js#2072). The retry logic catches both
RestException (for retryable HTTP status codes) and HttpRequestException (for network errors) since they
represent different failure modes in the supabase-kt HTTP stack.