Lorixen.
AR

تصميم موقع Django يختفي بعد إطفاء DEBUG: حل collectstatic

باختصار: إذا اختفى تصميم موقعك المبني بـ Django فجأة وأصبح نصاً عادياً بلا ألوان ولا صور ولا قوائم، مباشرة بعد إطفاء وضع DEBUG، فالموقع لم يتعطل بل فقد الطريقة المؤقتة التي كانت تخدم ملفات CSS وJavaScript. توثيق Django يوضح أن خادم التطوير يخدم هذه الملفات تلقائياً فقط عندما يكون DEBUG مفعلاً، ويصف هذه الطريقة بأنها غير فعالة إطلاقاً وربما غير آمنة وغير مناسبة للإنتاج. الحل ليس إعادة تشغيل DEBUG، بل ضبط STATIC_ROOT، وتشغيل أمر collectstatic، وجعل خادم الويب يخدم المجلد الناتج.

المشهد الذي يربك أصحاب المواقع

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

الحل الذي يخطر للبعض هو إعادة DEBUG كما كان. هذا يعيد التصميم، لكنه يعيد معه المشكلة الأمنية التي أردت حلها. هذا مثال توضيحي لحالة شائعة.

لماذا كانت الملفات تعمل من قبل؟

توثيق Django يشرح أنه أثناء التطوير، إذا كنت تستخدم تطبيق staticfiles، فإن أمر runserver يخدم الملفات الثابتة تلقائياً عندما يكون DEBUG مفعلاً. ثم يحذر مباشرة: هذه الطريقة غير فعالة إطلاقاً وربما غير آمنة، ولذلك هي غير مناسبة للإنتاج، ويحيل إلى دليل نشر الملفات الثابتة.

ويذكر التوثيق أيضاً أن الدالة المساعدة التي يضيفها بعض المطورين إلى ملف الروابط لخدمة الملفات الثابتة تعمل فقط في وضع التصحيح. إذن عندما يُطفأ DEBUG، تتوقف كل هذه الطرق المؤقتة دفعة واحدة، فيبقى الموقع بلا ملفات تصميم.

إذا كان موقعك يعمل في الإنتاج بأمر runserver نفسه، فهذه مشكلة أكبر من التصميم، وتستحق نقاشاً مع المطور حول طريقة تشغيل الموقع.

كيف يجب أن تُخدم الملفات الثابتة في الإنتاج؟

دليل النشر في توثيق Django يلخص الطريقة الأساسية في خطوتين:

  1. تشغيل أمر collectstatic كلما تغيرت الملفات الثابتة.
  2. جعل المجلد الذي جُمعت فيه الملفات، وهو STATIC_ROOT، يُخدم من خادم الملفات الثابتة.

وفي الحالة البسيطة التي يعمل فيها كل شيء على خادم واحد، يصف التوثيق العملية هكذا: رفع الكود إلى خادم النشر، ثم تشغيل collectstatic على الخادم لنسخ كل الملفات الثابتة إلى STATIC_ROOT، ثم إعداد خادم الويب ليخدم الملفات الموجودة في STATIC_ROOT تحت الرابط المحدد في STATIC_URL.

الإعدادات الثلاثة التي يجب أن تفهمها

  • STATIC_URL: الرابط الذي تظهر تحته الملفات، مثل static/. التوثيق يطلب تعريفه في ملف الإعدادات، وتستخدمه وسوم static في القوالب لبناء روابط الملفات.
  • STATICFILES_DIRS: قائمة مجلدات إضافية يبحث فيها Django عن الملفات الثابتة غير المرتبطة بتطبيق معين، مثل مجلد static في جذر المشروع.
  • STATIC_ROOT: المجلد الذي يجمع فيه أمر collectstatic كل الملفات من التطبيقات والمجلدات الإضافية في مكان واحد. هذا هو المجلد الذي يخدمه خادم الويب.

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

خطوات الإصلاح العملية

  1. اترك DEBUG مطفأً في الإنتاج.
  2. حدد STATIC_ROOT بمجلد واضح على الخادم.
  3. شغّل collectstatic على الخادم بعد كل نشر يغير ملفات التصميم.
  4. اضبط خادم الويب ليخدم ذلك المجلد تحت رابط STATIC_URL. التوثيق يعرض مثالاً بخادم Apache مع mod_wsgi، والفكرة نفسها تنطبق على الخوادم الأخرى.
  5. أعد تحميل الصفحة مع تفريغ ذاكرة المتصفح وتحقق أن ملفات CSS تعود برمز 200 في أدوات المطور.

لا تنسَ إضافتها إلى خطوات النشر

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

إذا نسي أحدهم collectstatic بعد تعديل التصميم، فستظهر مشكلة مختلفة: الموقع يعمل، لكن التعديلات الجديدة على الألوان أو الشعار لا تظهر، لأن خادم الويب ما زال يخدم النسخة القديمة المجمعة.

الصور التي يرفعها المستخدمون ليست ملفات ثابتة

انتبه للفرق: الملفات الثابتة هي ملفات التصميم التي يكتبها المطور، مثل CSS وJavaScript والشعار. أما الصور التي يرفعها الموظفون أو الزبائن، مثل صور الأطباء أو مرفقات الحجز، فهي نوع آخر يُدار بإعدادات منفصلة، وأمر collectstatic لا يجمعها. إذا اختفت صور الأطباء أيضاً بعد إطفاء DEBUG، فهذه مسألة ثانية تحتاج إعدادها الخاص، ولا تُحل بالتجميع. التوثيق يذكر أن الدالة المساعدة لخدمة الملفات في وضع التصحيح فقط لا تصلح للإنتاج، وهذا ينطبق على الحالتين.

عندما يصبح الموقع أكبر

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

اختبر قبل أن تطفئ DEBUG على الموقع الحقيقي

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

علامات تساعدك في التشخيص

  • الموقع بلا تصميم بعد إطفاء DEBUG مباشرة: الملفات الثابتة لا تُخدم في الإنتاج.
  • التصميم موجود لكن التعديلات الجديدة لا تظهر: لم يُشغّل collectstatic بعد النشر، أو المتصفح يعرض نسخة مخزنة.
  • بعض الملفات تعمل وبعضها 404: ملفات في مجلد لم يُضف إلى STATICFILES_DIRS أو داخل تطبيق غير مفعل.
  • الصور المرفوعة وحدها مفقودة: إعدادات ملفات المستخدمين، لا الملفات الثابتة.

أسئلة شائعة

ليش موقع Django صار بدون تصميم لما طفيت DEBUG؟

لأن خادم التطوير يخدم ملفات التصميم تلقائياً فقط مع DEBUG مفعّل. في الإنتاج تحتاج collectstatic وخادم ويب يخدم STATIC_ROOT.

هل أرجّع DEBUG وبخلص؟

لا. التوثيق يصف تلك الطريقة بأنها غير فعالة وربما غير آمنة وغير مناسبة للإنتاج.

شو بيعمل أمر collectstatic؟

ينسخ كل الملفات الثابتة من التطبيقات والمجلدات الإضافية إلى مجلد STATIC_ROOT ليخدمها خادم الويب.

عدّلت الألوان وما تغيرت، ليش؟

غالباً لم يُشغّل collectstatic بعد التعديل، فما زال الخادم يخدم النسخة القديمة.

إذا اختفى تصميم موقعك المبني بـ Django بعد ضبطه للإنتاج، تواصل معنا ونرتب خدمة الملفات معك.

المصادر

WhatsAppاحجز مكالمة