Debugging guide · 22 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 Missing? Fix for Next.js (2026)

8 min read

Supabase Email Confirmation Not Sending: 5 Fixes (2026)

10 min read

Supabase Auth Errors in Middleware: 5 Fixes That Work

10 min read

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 (Production 2026)

9 min read

Supabase RLS Policies Silently Failing: 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.

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.

Vercel Next.js Environment Variables: Fix & Deploy (2026)

10 min read

Fix Next.js "Module Not Found" After Deploy or Build

11 min read

Next.js Middleware Not Running on Vercel: 3 Causes

8 min read

Fix ChunkLoadError: Loading Chunk Failed in Next.js

9 min read

Cache / stale data

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

Next.js Stale Data: How I Fixed Cache Revalidation

15 min read

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

Supabase Realtime Gotchas: 7 Issues and How to Fix Them

11 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