Debugging guide · 18 verified fixes

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

Get it

Supabase Auth problems

OAuth redirects failing, session lost after refresh, email confirmation broken, middleware loops.

Supabase Auth Callback Redirect Not Working? Next.js Fix

11 min read

Supabase Auth Session Disappears on Refresh? Fix (2026)

8 min read

Supabase "Error sending confirmation email" (500): 5 fixes

10 min read

Supabase AuthSessionMissingError in Middleware: 5 Fixes

10 min read

RLS / security problems

Policy passes in SQL editor but fails in app, infinite recursion, silent failures, service role leaks.

Fix Supabase RLS Infinite Recursion (Production 2026)

9 min read

Does Supabase service_role Bypass RLS? Yes — Use It Safely

12 min read

Server Components / SSR session

Session null in Server Components, use client vs use server confusion, dynamic rendering errors.

use client vs use server in Next.js: The Real Difference

8 min read

Fix Dynamic Server Usage Error in Next.js App Router

9 min read

Vercel deployment problems

Env vars missing at runtime, middleware not running, ChunkLoadError after deploy, module not found.

Next.js Environment Variables Undefined on Vercel? Fix

10 min read

Next.js 'Module not found: Can't resolve': 6 Fixes

11 min read

Next.js Middleware Not Running on Vercel: 3 Causes

8 min read

Fix ChunkLoadError: Loading chunk failed (Next.js, webpack)

9 min read

Cache / stale data

revalidatePath not working, stale data after mutation, routes stuck as static, ISR not refreshing.

Fix Next.js revalidatePath Not Working in Server Actions

8 min read

Next.js 15 Caching Explained: Why Data Shows Stale

11 min read

Realtime

Subscription not receiving events, channel lifecycle issues, replication not enabled.

Supabase Realtime Not Receiving Events: Complete Fix

8 min read

Postgres / database

Foreign key constraint violations, concurrent update serialization errors, DISTINCT ON queries.

Fix Foreign Key Constraint Violation in Supabase (23503)

9 min read

Fix Postgres 'Could Not Serialize Access' (40001)

9 min read

Select the First Row per Group in Supabase Postgres

8 min read

Don't see your issue?

Search across all guides and articles, or browse by topic hub.

Search all articles Browse Next.js + Supabase hub