mirror of
https://github.com/supabase/supabase.git
synced 2026-06-15 18:17:09 +08:00
360140b3de
## I have read the [CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md) file. YES ## What kind of change does this PR introduce? Updating to the current status code <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit ## Documentation * Updated docs for HTTP status code 546 to reference the correct resource limit identifier: WORKER_RESOURCE_LIMIT. * Added a note that the limit was previously named WORKER_LIMIT for clarity. * Revised troubleshooting guidance and examples to reflect the new identifier and to include both WORKER_RESOURCE_LIMIT and the prior WORKER_LIMIT naming where relevant. <!-- review_stack_entry_start --> [](https://app.coderabbit.ai/change-stack/supabase/supabase/pull/46051?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack) <!-- review_stack_entry_end --> <!-- end of auto-generated comment: release notes by coderabbit.ai -->
121 lines
3.7 KiB
Plaintext
121 lines
3.7 KiB
Plaintext
---
|
|
id: 'functions-status-codes'
|
|
title: 'Status codes'
|
|
description: 'Edge Functions can return following status codes.'
|
|
subtitle: 'Understand HTTP status codes returned by Edge Functions to properly debug issues and handle responses.'
|
|
---
|
|
|
|
{/* supa-mdx-lint-disable Rule001HeadingCase */}
|
|
|
|
## Success Responses
|
|
|
|
### 2XX Success
|
|
|
|
Your Edge Function executed successfully and returned a valid response. This includes any status code in the 200-299 range that your function explicitly returns.
|
|
|
|
### 3XX Redirect
|
|
|
|
Your Edge Function used the `Response.redirect()` API to redirect the client to a different URL. This is a normal response when implementing authentication flows or URL forwarding.
|
|
|
|
---
|
|
|
|
## Client Errors
|
|
|
|
These errors indicate issues with the request itself, which typically require changing how the function is called.
|
|
|
|
### 401 Unauthorized
|
|
|
|
**Cause:** The Edge Function has JWT verification enabled, but the request was made with an invalid or missing JWT token.
|
|
|
|
**Solution:**
|
|
|
|
- Ensure you're passing a valid JWT token in the `Authorization` header
|
|
- Check that your token hasn't expired
|
|
- For webhooks or public endpoints, consider disabling JWT verification
|
|
|
|
### 404 Not Found
|
|
|
|
**Cause:** The requested Edge Function doesn't exist or the URL path is incorrect.
|
|
|
|
**Solution:**
|
|
|
|
- Verify the function name and project reference in your request URL
|
|
- Check that the function has been deployed successfully
|
|
|
|
### 405 Method Not Allowed
|
|
|
|
**Cause:** You're using an unsupported HTTP method. Edge Functions only support: `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, and `OPTIONS`.
|
|
|
|
**Solution:** Update your request to use a supported HTTP method.
|
|
|
|
---
|
|
|
|
## Server Errors
|
|
|
|
These errors indicate issues with the function execution or underlying platform.
|
|
|
|
### 500 Internal Server Error
|
|
|
|
**Cause:** Your Edge Function threw an uncaught exception (`WORKER_ERROR`).
|
|
|
|
**Common causes:**
|
|
|
|
- Unhandled JavaScript errors in your function code
|
|
- Missing error handling for async operations
|
|
- Invalid JSON parsing
|
|
|
|
**Solution:** Check your Edge Function logs to identify the specific error and add proper error handling to your code.
|
|
|
|
```tsx
|
|
// ✅ Good error handling
|
|
try {
|
|
const result = await someAsyncOperation()
|
|
return new Response(JSON.stringify(result))
|
|
} catch (error) {
|
|
console.error('Function error:', error)
|
|
return new Response('Internal error', { status: 500 })
|
|
}
|
|
```
|
|
|
|
You can see the output in the [Edge Function Logs](/docs/guides/functions/logging).
|
|
|
|
### 503 Service Unavailable
|
|
|
|
**Cause:** Your Edge Function failed to start (`BOOT_ERROR`).
|
|
|
|
**Common causes:**
|
|
|
|
- Syntax errors preventing the function from loading
|
|
- Import errors or missing dependencies
|
|
- Invalid function configuration
|
|
|
|
**Solution:** Check your Edge Function logs and verify your function code can be executed locally with `supabase functions serve`.
|
|
|
|
### 504 Gateway Timeout
|
|
|
|
**Cause:** Your Edge Function didn't respond within the [request timeout limit](/docs/guides/functions/limits).
|
|
|
|
**Common causes:**
|
|
|
|
- Long-running database queries
|
|
- Slow external API calls
|
|
- Infinite loops or blocking operations
|
|
|
|
**Solution:**
|
|
|
|
- Optimize slow operations
|
|
- Add timeout handling to external requests
|
|
- Consider breaking large operations into smaller chunks
|
|
|
|
### 546 Resource Limit (Custom Error Code)
|
|
|
|
**Cause:** Your Edge Function execution was stopped due to exceeding resource limits (`WORKER_RESOURCE_LIMIT`, previously it was `WORKER_LIMIT`). Edge Function logs should provide which [resource limit](/docs/guides/functions/limits) was exceeded.
|
|
|
|
**Common causes:**
|
|
|
|
- Memory usage exceeded available limits
|
|
- CPU time exceeded execution quotas
|
|
- Too many concurrent operations
|
|
|
|
**Solution:** Check your Edge Function logs to see which resource limit was exceeded, then optimize your function accordingly.
|