Lorixen.
AR

تطبيق React يعطي 404 عند تحديث الصفحة على Apache: الحل

باختصار: إذا كان موقع متجرك أو لوحة الحجز مبنياً كتطبيق صفحة واحدة، بـ React أو Vue مثلاً، ويعمل بشكل ممتاز عند التنقل من الصفحة الرئيسية، لكنه يعطي خطأ 404 عندما يحدّث الزائر الصفحة أو يفتح رابطاً مباشراً مثل ‎/products/abaya-123‎ من واتساب، فالمشكلة في إعداد الخادم لا في التطبيق. على خادم Apache، وهو الشائع في الاستضافة المشتركة، يمكن حل ذلك بتعليمة FallbackResource من وحدة mod_dir، التي يشرح توثيق Apache أنها تحدد ملفاً يعالج كل رابط لا يقابله ملف حقيقي على الخادم بدل إرجاع 404، دون التأثير على الملفات الموجودة فعلاً.

الشكوى كما تصل إليك

متجر عبايات في عمّان أطلق موقعاً جديداً سريعاً مبنياً بـ React. الزبونة تدخل الصفحة الرئيسية، تختار قسماً، ثم منتجاً، وكل شيء يعمل. لكن عندما ترسل رابط المنتج لأختها على واتساب، تفتحه الأخت فتظهر صفحة «404 Not Found». وإذا حدّثت الزبونة نفسها الصفحة وهي على صفحة المنتج، يظهر الخطأ نفسه.

النتيجة: روابط المنتجات في الإعلانات والرسائل لا تعمل، وزر المشاركة بلا فائدة. هذا مثال توضيحي لمشكلة متكررة في المواقع المبنية بهذه الطريقة.

لماذا يعمل التنقل ويفشل التحديث؟

في تطبيق الصفحة الواحدة، الخادم يرسل ملفاً واحداً تقريباً، عادة index.html، ومعه JavaScript. بعد ذلك، عندما تضغط الزبونة على منتج، لا يطلب المتصفح صفحة جديدة من الخادم. بل يغير JavaScript المحتوى المعروض، ويغير العنوان في شريط المتصفح باستخدام واجهة History في المتصفح. توثيق MDN يعرض كيف تضيف دالة pushState مدخلاً جديداً إلى سجل التصفح مع عنوان جديد.

المشكلة تظهر عندما يطلب المتصفح ذلك العنوان من الخادم مباشرة، عند التحديث أو فتح الرابط من خارج الموقع. الخادم يبحث عن ملف أو مجلد اسمه products/abaya-123، فلا يجده، فيرد بـ 404. الخادم لا يعرف أن هذا «عنوان داخلي» يفهمه التطبيق.

الحل: كل رابط غير موجود يذهب إلى التطبيق

المطلوب أن يقول الخادم: «إذا طُلب رابط لا يقابله ملف حقيقي، فأرسل index.html، واترك التطبيق يقرر ماذا يعرض».

توثيق Apache يشرح أن FallbackResource تحدد معالجاً لأي رابط لا يقابل شيئاً في نظام الملفات وكان سيعيد 404. ويعطي مثالاً: تعليمة تجعل الطلبات للملفات غير الموجودة تُعالج بملف محدد، بينما الطلبات للملفات الموجودة لا تتأثر. ويذكر أن هذا النمط شائع ويُسمى غالباً «وحدة التحكم الأمامية»، وأن الملفات الموجودة مثل الصور وملفات CSS تُخدم بشكل طبيعي.

في تطبيق صفحة واحدة، يكون الملف المعالج عادة index.html في جذر الموقع. يمكن للمطور إضافة التعليمة في ملف ‎.htaccess‎، إذ يذكر التوثيق أن تعليمات هذه الوحدة يمكن استخدامها في هذا السياق، بشرط أن تسمح الاستضافة بذلك.

إذا كان الموقع داخل مجلد فرعي

أحياناً لا يكون التطبيق في جذر النطاق، بل في مجلد مثل ‎/shop/‎ بينما الصفحة الرئيسية موقع تعريفي منفصل. التوثيق يوضح أنه في مسار فرعي يجب ذكر المسار الفرعي في التعليمة، ويعرض مثالاً لمدونة في ‎/blog/‎ مع معالج خاص بها. ويعرض أيضاً كيف يمكن تعطيل الميزة لمجلد فرعي معين، مثل مجلد الصور، بالقيمة disabled، إذا لم تكن تريد أن يرث الإعداد من المجلد الأعلى.

هذه نقطة مهمة: إذا وُضع المعالج بشكل خاطئ، فقد تظهر الصفحة الرئيسية للتطبيق بدلاً من صورة مفقودة، أو يعمل التطبيق في الجذر ويفشل في المجلد الفرعي.

يجب أن يعرف التطبيق نفسه أن الصفحة غير موجودة

عندما يرسل الخادم index.html لكل رابط مجهول، يصبح التطبيق مسؤولاً عن صفحة «غير موجود». إذا كتب أحدهم رابطاً خاطئاً تماماً، يجب أن يعرض التطبيق رسالة واضحة بالعربية، مثل «هذا المنتج غير متوفر، تصفحي المنتجات المشابهة»، لا صفحة فارغة.

وهناك جانب يخص محركات البحث: الخادم هنا سيرد على كل رابط مجهول بصفحة تبدو ناجحة، لا بخطأ 404 حقيقي. ناقش مع المطور كيف يتعامل الموقع مع المنتجات المحذوفة والروابط القديمة، كي لا تبدو آلاف الروابط الخاطئة صفحات حقيقية.

روابط الحملات والإعلانات أول من يتأثر

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

بدائل حسب الاستضافة

  • Apache مع ملف ‎.htaccess‎: FallbackResource هو الأبسط إذا كانت الوحدة مفعلة ومسموح استخدامها.
  • إذا لم تسمح الاستضافة: بعض الاستضافات تقيد ما يمكن وضعه في ‎.htaccess‎. اسأل الدعم الفني عن الطريقة المسموحة لتوجيه كل الروابط إلى ملف واحد.
  • خوادم أخرى أو خدمات استضافة المواقع الثابتة: لكل منها طريقته في إعداد «صفحة احتياطية». الفكرة واحدة، والإعداد مختلف.
  • التوجيه بعلامة #: بعض التطبيقات تتجنب المشكلة بروابط تحتوي علامة # مثل ‎/#/products/123‎. هذا يعمل دون إعداد خادم، لكنه يجعل الروابط أقل وضوحاً ويؤثر على طريقة فهم محركات البحث لها، فلا يُنصح به لمتجر يعتمد على الظهور في البحث.

قائمة فحص بعد الإصلاح

  1. افتح رابط منتج مباشرة في نافذة متصفح جديدة. هل يظهر المنتج؟
  2. حدّث الصفحة وأنت داخل قسم أو منتج. هل يبقى المحتوى؟
  3. افتح رابطاً من واتساب على الهاتف. هل يعمل؟
  4. افتح رابط صورة أو ملف CSS مباشرة. هل يظهر الملف نفسه، لا الصفحة الرئيسية؟
  5. اكتب رابطاً خاطئاً عمداً. هل تظهر رسالة «غير موجود» واضحة؟
  6. إذا كان التطبيق في مجلد فرعي، كرر الاختبارات داخله.

اسأل عن هذا قبل التسليم

عند الاتفاق مع مطور على موقع من هذا النوع، أضف إلى شروط التسليم: «كل رابط داخلي يجب أن يعمل عند فتحه مباشرة وعند تحديث الصفحة، على الاستضافة الفعلية لا على جهاز المطور». على جهاز المطور، أدوات التطوير غالباً تعالج هذه الحالة تلقائياً، لذلك لا تظهر المشكلة إلا بعد الرفع إلى الاستضافة.

أسئلة شائعة

ليش بيطلع 404 لما أعمل تحديث للصفحة بموقعي؟

لأن الخادم يبحث عن ملف بنفس الرابط ولا يجده. التطبيق هو من يفهم هذا الرابط، فيجب توجيه الطلب إليه.

ليش الرابط شغال من داخل الموقع ومش شغال من واتساب؟

من داخل الموقع يغير JavaScript العنوان دون طلب الخادم. من واتساب يُطلب الرابط من الخادم مباشرة.

شو بيعمل FallbackResource بالضبط؟

يجعل Apache يعالج كل رابط لا يقابله ملف حقيقي بملف تحدده، مثل index.html، ويترك الملفات الموجودة تُخدم بشكل طبيعي.

هل بأثر على الصور وملفات التصميم؟

لا، الملفات الموجودة لا تتأثر بحسب توثيق Apache، طالما أن مساراتها صحيحة.

إذا كانت روابط منتجاتك تعطي 404 عند مشاركتها أو تحديثها، اكتب لنا ونضبط الاستضافة معك.

المصادر

WhatsAppاحجز مكالمة