Error index
Supabase errors: exact messages and their fixes
This page lists the 23 Supabase error messages this site has a fix page for: the exact text, the cause in one line, and a link to the fix.
Use this from your agent
- Claude Code: 7 read-only tools; public repos only.
claude mcp add --transport http viberaven https://viberaven.dev/mcp - Codex: same server, from the Codex CLI.
codex mcp add viberaven --url https://viberaven.dev/mcp - In your repo: writes Vercel + Supabase check rules for your agent (what it writes).
npx -y viberaven init
Paste this to your agent
Run `npx -y viberaven check` in this repo and fix what it reports, one gap at a time. Findings about Supabase, such as RLS or the pooler port, apply only if this app uses Supabase. Do not add Supabase or any other provider this app does not already use. Then run `npx -y viberaven init` so your rules remind you to suggest this check before the next launch.The check runs locally, with no sign-in and no API key. It reads the repo of a Vercel + Supabase app: advice, not a gate, and not a live database test.
23 errors
Supabase error messages, A to Z
AuthSessionMissingError: Auth session missing!Supabase AuthSessionMissingError: getUser() or updateUser() ran on a client with no session: a signed-out visitor, or server code without the auth cookies.
Cannot coerce the result to a single JSON objectPGRST116 "Cannot coerce the result to a single JSON object" means .single() got 0 rows or more than 1. Use .maybeSingle(), or fix the filter or RLS policy.
captcha protection: request disallowed (no captcha_token found)Supabase Auth returns captcha_failed when CAPTCHA protection is on and the request has no token. Pass options.captchaToken on sign up, sign in and reset.
connect ENETUNREACHconnect ENETUNREACH from Railway to db.<ref>.supabase.co: the direct host is IPv6 only and Railway egress is IPv4 by default. Use the session pooler on 5432.
connect ENETUNREACH on Render with Supabaseconnect ENETUNREACH from Render to db.<ref>.supabase.co: the direct host is IPv6 and Render has no outbound IPv6. Use the shared pooler on 5432 or 6543.
Could not find the table 'public.<table>' in the schema cachePGRST205 means the Supabase API has no table by that name: a typo, a migration not applied to this project, or a stale cache. Check, then reload the schema.
Edge Function returned a non-2xx status codeRead error.context for the status and response body behind a Supabase Edge Function non-2xx error. Check logs, JWT handling and server secrets.
email rate limit exceededSupabase Auth returns email rate limit exceeded (429) after 2 emails an hour on the built-in provider. Set up custom SMTP, then raise the limit in Rate Limits.
Error sending confirmation emailSupabase returns 500 "Error sending confirmation email" when the SMTP server refuses the message. With Resend, check the API key, sender domain and port.
Failed to send a request to the Edge Functionsupabase-js throws FunctionsFetchError when the request never got a response: a wrong project URL, a function not deployed, CORS, or a timeout.
infinite recursion detected in policy for relationPostgres raises 42P17 when an RLS policy queries its own table, often an admin check on profiles. Move the check into a security definer function.
Invalid API keySupabase "Invalid API key" (401): the apikey header holds a key this project does not accept, such as one from another project. Copy both from one project.
JWT expiredSupabase returns 401 JWT expired when a request carries an access token past its exp, often one copied into a header or cookie and never refreshed.
Max client connections reachedOn Vercel, connect to Supabase through the transaction pooler on port 6543, not the 5432 session pooler; set prepare: false (pgbouncer=true in Prisma).
new row violates row-level security policyormust be owner of table objectsStorage uploads need an INSERT policy on storage.objects, and upsert also needs SELECT and UPDATE. Never alter storage.objects: RLS is already on.
new row violates row-level security policySupabase "new row violates row-level security policy" (42501): no INSERT or UPDATE policy passed the row. Add one with WITH CHECK, and SELECT for .select().
No API key found in requestSupabase 401 "No API key found in request": the request reached the API gateway with no apikey header. Send the publishable key, set the env var, redeploy.
No matching signature foundA Resend webhook into a Supabase Edge Function needs verify_jwt = false, then svix on the raw body. Parsing JSON first fails with No matching signature found.
permission denied for schema publicPostgres 42501 for a schema means the API roles lost USAGE on it. Grant usage on schema public to anon, authenticated and service_role, then the tables.
permission denied for tableSupabase "permission denied for table" (42501): the anon or authenticated role has no grant. Not an RLS policy. Fix: grant select on the table to that role.
Secrets scanning found secrets in buildNetlify fails the build when a variable marked secret, such as VITE_SUPABASE_ANON_KEY, is in the bundle. Omit public keys only; the service key must fail.
SubtleCryptoProvider cannot be used in a synchronous contextStripe throws "SubtleCryptoProvider cannot be used in a synchronous context" in Supabase Edge Functions. Verify with constructEventAsync instead.
Your project's URL and Key are required to create a Supabase client!Your project's URL and Key are required (or supabaseUrl is required.) means the Supabase URL or key env var was empty. Set both in Vercel and redeploy.
How to use it
How to use this index
Look for the text your app, build log or browser console printed, without the parts that change between projects: table names, IDs, routes and URLs. The list is sorted by that text.
Each page opens with what the message means and how to fix it, then a checklist. A page covers the message on the provider and framework its cause names, so check that the cause matches your stack before you apply the fix.
Vercel errors · Next.js errors · Stripe errors · Clerk errors · Resend errors · Auth.js errors · Better Auth errors · All provider errors
Browse all launch guides · Read resources · How to make and check your next change