إصلاح · فيرسل والنشر

متغير بيئة ناقص على Vercel (يعمل محلياً)

تعطّل عملكلم يُفحص مقابل شاشات الجهة الحالية

ما قد تراه

يعمل على جهازي ويظهر أخطاء أو بيانات فارغة في الموقع المنشور
يقول الخطأ undefined أو مفتاح ناقص أو عنوان غير صالح

السبب الأرجح

يبقى ملف .env على جهازك؛ والموقع المنشور يعرف فقط المتغيرات التي أضفتها في إعدادات مشروع Vercel.

افحص أولاً (نحو دقيقتين)

اكتب أسماء المتغيرات في ملف .env (الأسماء فقط، وليس القيم أبداً).
افتح إعدادات مشروع Vercel وصفحة Environment Variables (قد يختلف الاسم) وقارن الأسماء.

أمر الإصلاح

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

نص الخطأ بالضبط أو ما تراه

ما فعلته قبل أن يحدث

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

أنت مهندس خبير وصبور ينشر المواقع على Vercel كل يوم ويشرح ذلك لأشخاص ليسوا مبرمجين. أنا لست مبرمجاً، لذلك اشرح كل خطوة بكلمات بسيطة وحدّد لي بالضبط أي زر أو قائمة أو أمر تقصد. إذا لم تكن متأكداً من شيء فقل ذلك ولا تخمّن.

أسماء القوائم والأزرار تتغير مع الوقت. إذا لم تجد زراً أو صفحة أذكرها فقل ذلك وأخبرني عمّا أبحث بدلاً من التخمين.

المشكلة
متغير بيئة ناقص على Vercel (يعمل محلياً)

نص الخطأ كما ظهر لي، أو ما أراه
[الصق هنا نص الخطأ كما ظهر لك]

ما فعلته قبل أن تحدث المشكلة
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

السبب الأرجح
يبقى ملف .env على جهازك؛ والموقع المنشور يعرف فقط المتغيرات التي أضفتها في إعدادات مشروع Vercel.

نفّذ هذه الخطوات بهذا الترتيب
1. ابحث في الشيفرة عن كل process.env.<NAME> (أو import.meta.env في Vite) واعرض الأسماء التي يستخدمها التطبيق.
2. قارن القائمة بالأسماء التي سأعطيك إياها من Vercel. لا تطلب القيم أبداً.
3. أخبرني أي الأسماء ناقصة وفي أي بيئات (Production وPreview وDevelopment) يجب إضافتها وكيف أضيفها في Vercel.
4. ذكّرني أن التغيير يحتاج نشراً جديداً، وأن متغيرات المتصفح تحتاج البادئة العامة للإطار (NEXT_PUBLIC_ أو VITE_) وأنها مرئية للجميع.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

تأكد أن الحل نجح
- بعد إعادة النشر يعرض الموقع بيانات حقيقية ويزول الخطأ.
أخبرني بالضبط ماذا يجب أن أرى على الشاشة عندما ينجح.

لا تغيّر
- لا تنسخ ملف .env إلى المستودع أو إلى الشيفرة.
- لا تضع مفاتيح سرية في متغيرات ببادئة عامة.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

ابحث في الشيفرة عن كل process.env.<NAME> (أو import.meta.env في Vite) واعرض الأسماء التي يستخدمها التطبيق.
قارن القائمة بالأسماء التي سأعطيك إياها من Vercel. لا تطلب القيم أبداً.
أخبرني أي الأسماء ناقصة وفي أي بيئات (Production وPreview وDevelopment) يجب إضافتها وكيف أضيفها في Vercel.
ذكّرني أن التغيير يحتاج نشراً جديداً، وأن متغيرات المتصفح تحتاج البادئة العامة للإطار (NEXT_PUBLIC_ أو VITE_) وأنها مرئية للجميع.

لا تفعل هذا

لا تلصق قيم المفاتيح الحقيقية في المحادثة؛ أضفها مباشرة في Vercel.
لا تنسخ ملف .env إلى المستودع أو إلى الشيفرة.
لا تضع مفاتيح سرية في متغيرات ببادئة عامة.