Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: document NOT_FOUND_FUNCTION_BLOB Edge Function error (#48411)

Abhishek Tripathid101d6f3de4c
diff --git a/apps/docs/content/troubleshooting/edge-function-404-error-response.mdx b/apps/docs/content/troubleshooting/edge-function-404-error-response.mdx
index 19afdd4c4aa..c3016171c83 100644
--- a/apps/docs/content/troubleshooting/edge-function-404-error-response.mdx
+++ b/apps/docs/content/troubleshooting/edge-function-404-error-response.mdx
@@ -8,9 +8,14 @@ database_id = "a3cfff33-d640-4395-99bc-a110b7fb637c"
http_status_code = 404
code = "NOT_FOUND"
message = "Requested function was not found"
+
+[[errors]]
+http_status_code = 404
+code = "NOT_FOUND_FUNCTION_BLOB"
+message = "Function deployment bundle not found"
---
-The edge function is not recognized by Supabase
+The edge function is not recognized by Supabase, or its deployed bundle cannot be found.
## Context for the error
@@ -51,6 +56,20 @@ When an edge function fails due to a platform 404 error, it will return the erro
}
```
+A different platform 404 error, `NOT_FOUND_FUNCTION_BLOB`, can occur when the function name is recognized but the runtime cannot find the deployed bundle. This can happen even when the function appears as `ACTIVE` in the dashboard, because the status shows that the function record exists while the actual deployment bundle is missing or inaccessible:
+
+```json
+{
+ "code": "NOT_FOUND_FUNCTION_BLOB",
+ "message": "Function deployment bundle not found"
+}
+```
+
+The difference between the two errors is:
+
+- `NOT_FOUND`: The function name in the request URL is not recognized.
+- `NOT_FOUND_FUNCTION_BLOB`: The function name is recognized, but the runtime cannot find the deployed bundle.
+
### Inspecting the logs
<Admonition type='note'>
@@ -99,20 +118,23 @@ If the call works, consider double checking your code for typos or to see if it
### Step 4: Redeploy the function
-If step 3 fails, it may be a sign of an internal bug and it may be necessary to redeploy your function. This can be done within the [Function Dashboard](/dashboard/project/_/functions) under the respective function's code tab:
+If step 3 fails, it may be a sign of an internal bug and it may be necessary to redeploy your function. The same applies if you see the `NOT_FOUND_FUNCTION_BLOB` error, which means the function is recognized but its deployed bundle cannot be found. This can occur even when the function appears as `ACTIVE` in the dashboard.
+
+This can be done within the [Function Dashboard](/dashboard/project/_/functions) under the respective function's code tab:
![image](/docs/img/troubleshooting/edge_function_404_redeploy.png)
Alternatively, if you develop locally, you can redeploy the function with the [Supabase CLI](/docs/guides/local-development/cli/getting-started?queryGroups=platform&platform=macos):
```sh
+# Redeploy one affected function
supabase functions deploy FUNCTION_NAME
-# If you want to deploy all functions, run the `deploy` command without specifying a function name:
+# Or redeploy all functions if several are affected
supabase functions deploy
```
-Then write in a ticket to [Supabase Support](/dashboard/support/new)
+After redeploying, retry the request. If the error persists, write in a ticket to [Supabase Support](/dashboard/support/new).
## Additional resources