يعمل محلياً ويفشل بعد النشر بسبب متغيرات البيئة

Env Vars Missing in Production

خطأمتوسطالخطورة: عاليةالنشر

أخطاء undefined أو 401 أو فشل الاتصال بقاعدة البيانات بعد النشر فقط.

الأعراض

  • أخطاء undefined أو 401 أو فشل الاتصال بقاعدة البيانات بعد النشر فقط.

السبب

ملف .env المحلي لا يُرفع (وهذا صحيح)، ولم تُضبط المتغيرات في منصة النشر، أو ضُبطت بعد البناء دون إعادة النشر.

الحل

  • أضف المتغيرات في إعدادات المنصة (Environment Variables) للبيئة الصحيحة.
  • أعد البناء والنشر بعد الإضافة.
  • تحقق من البادئات المطلوبة للمتغيرات العامة في إطارك.

الوقاية

  • احتفظ بملف .env.example محدّث.
  • اطلب قائمة نشر مخصصة من الوكيل.

المصادر

  1. Vercel Docs: Deployments
  2. Vite: Env Variables and Modes