هذي أكثر جملة نسمعها: «يشتغل عندي، وأول ما أرفعه يطيح». الجواب المختصر: بيئة النشر غير جهازك، والفرق غالبًا واحد من ستة أشياء. بس قبلها، شوف وش يقول الخطأ نفسه.
أول خطوة: صفحة بيضاء أو نشر فاشل؟ شوف الخطأ
- إذا الموقع يطلع صفحة بيضاء: افتحه، واضغط F12، وافتح تبويب Console. أول سطر أحمر هو بداية الخيط.
- إذا النشر نفسه فشل: افتح سجل البناء (Build Logs) في منصة النشر، وانزل لأول خطأ، مو آخر واحد.
- إذا الصفحة تفتح بس شي معيّن ما يشتغل: سجل السيرفر (Logs) في منصة النشر يقول لك وش صار.
1. الإعدادات السرية ما انتقلت
منتجك يحتاج مفاتيح: مفتاح الدفع، ورابط قاعدة البيانات، ومفتاح الذكاء الاصطناعي. على جهازك موجودة في ملف إعدادات، بس بيئة النشر ما تعرف عنها شي إلا إذا أضفتها بنفسك.
- افتح إعدادات النشر في المنصة اللي تنشر عليها، ودوّر على «Environment Variables».
- قارن أسماءها بأسماء الإعدادات اللي على جهازك. أي اسم ناقص هو المشتبه الأول.
2. غيّرت الإعداد وما تغيّر شي
المتغيرات اللي تبدأ بـ VITE_ أو NEXT_PUBLIC_ تنكتب داخل ملفات الموقع وقت البناء. يعني إذا أضفتها أو غيّرتها في إعدادات الاستضافة بعد النشر، ما يتغيّر شي لين تعيد النشر.
3. الرابط يأشّر على جهازك
كثير من الكود اللي يكتبه الذكاء الاصطناعي فيه روابط مثل localhost:3000. تشتغل عندك وبس. دوّر في الكود على كلمة localhost، وأي نتيجة خارج ملفات الإعدادات تحتاج تتغيّر.
4. حرف كبير وحرف صغير
جهازك (ويندوز أو ماك) يعتبر Logo.png و logo.png نفس الملف، وسيرفرات النشر تعتبرها ملفين. فإذا الكود يطلب logo.png والملف اسمه Logo.png، يشتغل عندك ويطيح عندهم. نفس الشي في أسماء ملفات الكود.
5. الصفحة الداخلية تطلع 404
الرئيسية تفتح، بس لما تفتح رابط مثل /dashboard مباشرة أو تضغط تحديث، تطلع 404. السبب إن تطبيقك صفحة وحدة تتحكم في الروابط من المتصفح، والاستضافة تدوّر على ملف بهالاسم وما تلقاه. الحل قاعدة توجيه (rewrite) ترجّع كل الروابط لـ index.html، وكل منصة نشر لها طريقتها.
6. قاعدة البيانات غير
لما تجرّب، تشتغل على قاعدة بيانات فيها جداول وبيانات تجريبية. بيئة النشر غالبًا تتصل بقاعدة ثانية فاضية، أو ما فيها آخر التغييرات على الجداول. كيف تعرف: افتح القاعدة اللي يتصل فيها الموقع المنشور وقارن جداولها باللي عندك. أي جدول أو عمود ناقص يعني إن فيه تغييرات (migrations) ما انطبقت عليها.
إذا ما لقيت السبب
خلّ مهندس يشوفه معك في مكالمة استشارية: نشارك الشاشة ونوصل لأصل المشكلة، ويوصلك التسجيل وخطوات مكتوبة. إذا منتجك على Lovable، شوف بعد مشاكل Lovable الأشهر.