Free fixes
70 Next.js, Auth.js, Prisma and Stripe errors and how to fix them
Every error AI coding agents commonly cause in Next.js 16 apps, one page each: what it looks like, what it means, the fix, and a prompt for Cursor or Claude Code. Free. Or paste your own error into the VibeBoot Doctor.
Next.js errors
- useState / useEffect in a Server Component
- Event handlers cannot be passed to Client Component props
- Functions cannot be passed directly to Client Components
- Only plain objects can be passed to Client Components
- "use client" must be placed before other expressions
- export "metadata" from a "use client" page
- async Client Component
- 'server-only' cannot be imported from a Client Component module
- Module not found: Can't resolve 'fs'
- PrismaClient is unable to run in this browser environment
- Server Actions must be async functions
- useSearchParams() should be wrapped in a suspense boundary
- Next.js encountered runtime / uncached data during prerendering (cacheComponents)
- params.slug is undefined (params is a Promise)
- missing generateStaticParams() with output: export
- next/image hostname is not configured
- Hydration failed: server HTML didn't match the client
- The "middleware" file convention is deprecated
- npm ci: package.json and package-lock.json are not in sync
- Maximum update depth exceeded
Auth.js errors
- error=Configuration
- MissingSecret
- UntrustedHost
- GitHub: redirect_uri mismatch
- Redirected to localhost after deploy
- OAuthAccountNotLinked
- error=Verification
- MissingAdapter
- AdapterError / table does not exist
- InvalidCheck (PKCE / state)
- JWTSessionError
- SessionTokenError
- AccessDenied
- MissingCSRF
- v4 code in a v5 app (getServerSession, authOptions)
Prisma errors
- @prisma/client did not initialize yet
- Property 'x' does not exist on type 'PrismaClient'
- Prisma has detected that this project was built on Vercel
- PrismaClient is unable to run in this browser environment
- PrismaClient is not configured to run in Edge Runtime
- Environment variable not found: DATABASE_URL
- The URL must start with the protocol postgresql://
- P1001: Can't reach database server
- P1000: Authentication failed against database server
- P2021: The table does not exist in the current database
- P2002: Unique constraint failed
- P2025: Record required but not found
- P2003: Foreign key constraint violated
- PrismaClientValidationError: Unknown argument
- PrismaClientValidationError: Argument is missing
- P2024: Timed out fetching a new connection from the connection pool
- Drift detected: database schema is not in sync with migration history
- P3005: The database schema is not empty
- P3009: migrate found failed migrations
- Prisma Client could not locate the Query Engine
Stripe webhook errors
- No signatures found matching the expected signature
- Wrong webhook secret (CLI vs Dashboard, test vs live)
- 307 / 308 / 301 redirect
- 401 / 403 from auth middleware or Vercel Deployment Protection
- 404 Not Found (wrong path)
- Timed out / not returning 2xx fast
- Duplicate events / missing idempotency
- Out-of-order events
- Edge runtime / crypto errors
- Missing raw body / body already used
- Events not enabled on the endpoint (nothing arrives)
- stripe listen forwarding problems (local)
- Timestamp outside the tolerance zone
- Can't map the event to a user (missing metadata / customer id)
- Static export can't run API routes