Home/Wiki Errors/Vibe Coding
Vibe Coding / Deploy

Vercel preview works but production fails

Preview and production differ in env vars, domains, callbacks, build settings, or protected resources.

Error text / 报错原文

  • preview works production fails
  • Vercel production failed
  • works locally but not production

What it means

Preview and production differ in env vars, domains, callbacks, build settings, or protected resources.

Most common causes

  • Missing production env var
  • Callback URL still points to preview
  • Database branch mismatch
  • Different Node version

Fastest fix

  • Reproduce the smallest failing case.
  • Check environment, platform, and production settings.
  • Use the related local tool to classify the issue.
  • Fix the highest-risk security or data issue first.

Safe fix

  • Keep secrets out of client code and logs.
  • Prefer least privilege and explicit allowlists.
  • Add a regression test or checklist before retrying.
  • Document the working production configuration.

What not to do

  • Do not disable security controls as a permanent fix.
  • Do not paste secrets into public issue trackers or AI chats.
  • Do not trust preview success as production readiness.

Diagnostic commands

npm run build
git diff --check
grep -R "SERVICE_ROLE\|STRIPE_SECRET\|SUPABASE" .

Related tools

Related errors

Sources