Start here if your Next.js + Supabase app breaks in production
Pick your symptom below. Each path leads to a verified fix with code you can copy and steps you can follow. No generic advice.
Want the full checklist?
Next.js + Supabase Production Debugging Checklist — free download
Supabase Auth problems
OAuth redirects failing, session lost after refresh, email confirmation broken, middleware loops.
RLS / security problems
Policy passes in SQL editor but fails in app, infinite recursion, silent failures, service role leaks.
Supabase RLS Not Working: Debug & Fix Policies (2026)
13 min read
Fix Supabase RLS Infinite Recursion Error (Postgres Policy Loop Explained — Production Fix 2026)
9 min read
Why Your Supabase RLS Policies Are Silently Failing (And How to Debug Them)
7 min read
Supabase service_role Key: Bypass RLS Safely in Next.js
12 min read
Server Components / SSR session
Session null in Server Components, use client vs use server confusion, dynamic rendering errors.
Vercel deployment problems
Env vars missing at runtime, middleware not running, ChunkLoadError after deploy, module not found.
Cache / stale data
revalidatePath not working, stale data after mutation, routes stuck as static, ISR not refreshing.
Realtime
Subscription not receiving events, channel lifecycle issues, replication not enabled.
Postgres / database
Foreign key constraint violations, concurrent update serialization errors, DISTINCT ON queries.
Don't see your issue?
Search across all guides and articles, or browse by topic hub.