تقدير المشروع
← كل المقالات

يا للهول، انتهت المهلة...

هل يواجه تطبيقك انتهاء المهلة قبل أن يتمكن من الرد؟ إليك ما يمكنك فعله حيال ذلك.

4 دقائق قراءة
التطويرنقاط نهاية HTTPتطوير التطبيقاتالصيانة

هل سبق أن واجه تطبيقك مشكلة في ردود تنتهي مهلتها؟

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

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

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

إذن ما هي خياراتنا؟

ضبط الإعدادات بدقة

عندما يمكنك تقدير الوقت الذي ستستغرقه المهمة، قد يكون أبسط حل هو رفع حد المهلة لنوع الطلب المحدد. وعادةً لا يكفي تغيير القيمة في مكان واحد: فيجب تحديث العميل والخادم وأي وسطاء (مثل موازنات الحمل).

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

وإذا تبين أن ضبط المهلات للطلبات المتزامنة إشكالي، فهناك دائمًا خيار معالجة المهام بشكل غير متزامن.

المعالجة غير المتزامنة للمهام طويلة الأمد

إذا كان انتظار انتهاء المعالجة يؤدي إلى انتهاء المهلة، فيمكننا ببساطة التوقف عن الانتظار.
يمكن لتطبيقنا بدلًا من ذلك أن يخبر العميل بأن الطلب سُجِّل بنجاح وأن المعالجة ستبدأ قريبًا.

للبدء، ينبغي أن يخزّن التطبيق نية تنفيذ المهمة ثم يرد برمز حالة مصمم خصيصًا لهذه الحالة: 202 Accepted. بعد ذلك يمكن لعامل في الخلفية أن يلتقط المهام الجديدة من المخزن بانتظام ويبدأ معالجتها. وحالما ينجح العمل (أو يفشل)، ينبغي أن يحدّث السجل المخزَّن بنتيجة المعالجة أو بسبب الفشل. والمهم هو التأكد من عدم بدء العمل نفسه مرتين في وقت واحد. ويمكن تحقيق ذلك بانتخاب قائد واحد مسؤول عن المعالجة، أو باستخدام نوع من آليات القفل.

ينبغي أن تحتوي استجابة الطلب الأصلي على ترويسة Location تخبر العميل بمكان العثور على النتائج عندما تصبح جاهزة. وعادةً تشير إلى نقطة نهاية أخرى في التطبيق. وطالما أن المهمة لا تزال قيد التنفيذ، ينبغي أن تستمر نقطة النهاية هذه في الرد بـ 202 Accepted، ويمكن أن يتضمن متن الاستجابة معلومات التقدم اختياريًا. وبمجرد انتهاء المهمة، ينبغي أن تسلّم الاستجابة التالية النتائج المحسوبة بحالة 200 Ok أو 201 Created. وإذا حدث خطأ ما، فقد تعيد نقطة النهاية 404 أو حتى 410 Gone.

في هذا التدفق، يكون العميل مسؤولًا عن الاستعلام الدوري من نقطة نهاية المورد حتى تكتمل المهمة. وتتيح لنا الترويسة Retry-After اقتراح المدة التي ينبغي له انتظارها قبل المحاولة مجددًا. ويمكننا أيضًا جعل الحل أكثر استجابة بدفع التحديثات من الخادم، مثلًا بإتاحة نقطة نهاية Server-Sent Events تخبر العميل بانتهاء العمل.

من منظور هندسة البرمجيات، يطبّق هذا التدفق غير المتزامن نمط الصندوق الوارد (inbox pattern) باستخدام نقاط نهاية HTTP.

مثال

إليك مثالًا. يوفر تطبيقنا نقطتي نهاية: POST /item التي تبدأ إنشاء عنصر، وGET /item/{id} التي تعيد حالة العمل ونتائجه.

ولجعل الـ API أكثر متانة، يمكننا جعل نقطة نهاية POST غير قابلة للتغيير (immutable). فعندما يرسل العميل طلبًا آخر ببيانات إدخال مطابقة، يمكننا ببساطة إعادة موقع العنصر الذي يجري إنشاؤه بالفعل (أو الذي أُنشئ فعلًا) – وهو في حالتنا مجرد عنوان URL بمعرّف العنصر نفسه. وطالما أن المهمة قيد التنفيذ، فإن أي محاولة لجلب النتائج تعيد 202 Accepted.

وبمجرد إنشاء العنصر، تحدّث عملية العامل السجل في جدول العناصر، وتبدأ نقطة النهاية بإعادة النتائج برمز الحالة 201 Created.

الخلاصة

أردت بهذا المقال تقديم لمحة عن بناء معالجة غير متزامنة فوق نقاط نهاية HTTP. آمل أن يكون مفيدًا!