414 طلب معرّف موارد منتظم (URI) طويل جدًا - OverBigLine

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

المشكلة

يحصل تطبيق العميل على رمز حالة HTTP 414 Request-URI Too Long مع رمز الخطأ protocol.http.TooBigLine كاستجابة لطلبات واجهة برمجة التطبيقات.

رسالة الخطأ

يتلقى تطبيق العميل رمز الاستجابة التالي:

HTTP/1.1 414 Request-URI Too Long

بالإضافة إلى ذلك، قد تلاحظ رسالة الخطأ التالية:

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

تجدر الإشارة إلى أنّ faultstring في رسالة الخطأ أعلاه يحتوي على الحدّ الأقصى المسموح به لسطر الطلب في Apigee Edge، وهو 7168 bytes (7 كيلوبايت).

الأسباب المحتملة

يحدث هذا الخطأ إذا كان حجم سطر الطلب الذي أرسله تطبيق العميل إلى Apigee Edge كجزء من طلب HTTP أكبر من الحد المسموح به في Apigee Edge.

قبل أن نتعرّف على الأسباب المحتمَلة لهذا الخطأ، لنتعرّف على معنى سطر الطلب وكيفية التحقّق من حجمه.

فهم سطر الطلب

يتألف طلب HTTP النموذجي من ثلاثة أجزاء:

1. سطر الطلب
2. ( مجموعة من عناوين HTTP )
3. [ النص الأساسي ]

يتكون سطر الطلب من ثلاثة أجزاء كما هو موضح أدناه.

Request-Line = <Method> <Request-URI> <HTTP-Version>

عندما يقدم تطبيق العميل طلب HTTP إلى خادم، يحتوي السطر الأول الذي ينتقل إلى الخادم على سطر الطلب المذكور أعلاه. يلي ذلك العناوين وطلب النص الأساسي/الحمولة.

تعرض لقطة الشاشة التالية نموذج طلب curl وجزء الطلب (بالإضافة إلى سطر الطلب) وجزء الردّ.

فهم حجم سطر الطلب

1. في النموذج الذي تمت مناقشته أعلاه، يكون سطر start (السطر الأول) في الطلب، والمشار إليه أيضًا باسم Request-Line، كما يلي:

   GET /test/ HTTP/1.1
   

   حجم سطر الطلب هو ~19 bytes لأنّه يحتوي على 19 ASCII characters. بما أنّ هذا الطلب يقع ضمن الحدّ المسموح به في Apigee Edge، تتمّ معالجة الطلب بدون أيّ أخطاء وستحصل على ردّ ناجح.

2. وبالمثل إذا نظرت إلى faultstring في رسالة الخطأ الموضحة أعلاه، ستحتوي على "request line size exceeding 7,168". يشير هذا إلى أنّ سطر الطلب في طلب HTTP الذي أجراه العميل تجاوز 7,168 بايت.

في ما يلي الأسباب المحتملة لهذا الخطأ:

السبب	الوصف	تعليمات تحديد المشاكل وحلّها السارية على
حجم حمولة الطلب أكبر من الحد المسموح به	إنّ حجم "Request-URI" الذي يرسله تطبيق العميل كجزء من طلب HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.	مستخدمو Edge العام والخاص على السحابة الإلكترونية

خطوات التشخيص الشائعة

استخدِم إحدى الأدوات/الأساليب التالية لتشخيص هذا الخطأ:

السبب: حجم حمولة الطلب أكبر من الحد المسموح به

التشخيص

1. حدِّد رمز الخطأ ومصدر الخطأ وحجم طول الطلب للخطأ الذي تم رصده باستخدام مراقبة واجهة برمجة التطبيقات أو أداة التتبُّع أو سجلات وصول NGINX كما هو موضّح في خطوات التشخيص الشائعة.
2. إذا كانت قيمة مصدر الخطأ apigee أو MP، يعني ذلك أنّ حجم الطلب الذي أرسله تطبيق العميل إلى Apigee أكبر من الحد المسموح به في Apigee Edge.
3. يمكنك التحقّق من أنّ حجم سطر الطلب تجاوز الحدّ الأقصى المسموح به البالغ 7 كيلوبايت باستخدام إحدى الطريقتَين التاليتَين:

   رسالة الخطأ

   للتأكُّد من استخدام رسالة الخطأ، اتّبِع الخطوات التالية:

   إذا كان بإمكانك الوصول إلى رسالة الخطأ الكاملة التي تم تلقّيها من Apigee Edge، يُرجى الرجوع إلى faultstring. تشير السمة faultstring إلى أنّ حجم سطر الطلب تجاوز الحدّ الأقصى المسموح به وهو 7 كيلوبايت.

   نموذج لرسالة خطأ:

   "faultstring":"request line size exceeding 7,168"
   

   الطلب الفعلي

   للتحقّق من استخدام الطلب الفعلي:

   إذا كان بإمكانك الوصول إلى الطلب الفعلي الذي تم إجراؤه من خلال تطبيق العميل، اتّبِع الخطوات التالية:

   1. تحقق من حجم معرف الموارد المنتظم (URI) الذي تم تمريره في الطلب.

   2. إذا وجدت أنّ حجم معرّف الموارد المنتظم (URI) يتجاوز الحد المسموح به في Apigee Edge، هذا هو سبب المشكلة.

      نموذج طلب:

      curl http://<hostalias>/testtoobigline?_qparam=000000000000000000……..000000<trimmed> -k -X POST
      

      في الحالة المذكورة أعلاه، تكون قيمة معلَمة طلب البحث qparam أكبر من 7 كيلوبايت، أي أنّها تحتوي على أكثر من 7 أحرف ASCII.

      إذا كنت تستخدم برنامج عميل آخر، يمكنك مراجعة سجلات العميل ومحاولة معرفة حجم سطر الطلب الذي يتم إرساله إلى Apigee Edge.

   سجلّات "معالج الرسائل"

   للتحقق من صحة استخدام سجلات معالج الرسائل:

   إذا كنت من مستخدمي Private Cloud، يمكنك استخدام سجلّات "معالج الرسائل" للتحقّق مما إذا كان حجم "سطر الطلب" قد تجاوز الحد المسموح به في Apigee Edge.

   1. تحقَّق من سجلات معالج الرسائل:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. ابحث عن أي أخطاء 414 خلال مدة معيّنة (إذا كانت المشكلة قد حدثت في الماضي) أو لمعرفة ما إذا كانت هناك أي طلبات لا تزال يتعذّر إجراؤها من خلال 414. يمكنك استخدام سلاسل البحث التالية.

      grep -ri "exceeding"
      

      grep -ri "RequestURITooLong"
      

   3. ستجد سطورًا من system.log مشابهة لما يلي:

      2021-07-12 08:53:31,461  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:null, uri:null,
      message Id:null, exception:com.apigee.errors.http.user.RequestURITooLong{
      code = protocol.http.TooBigLine, message = request line size exceeding 7,168,
      associated contexts = []}, context:Context@366f4217
      input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.195.90:8443
      Local:192.168.67.23:34256]@301912 useCount=1 bytesRead=0 bytesWritten=45849
      age=2254670ms lastIO=0ms isOpen=true)
      

      يشير النص message = request line size exceeding 7,168 في رسالة الخطأ أعلاه إلى أن حجم عنوان URI للطلب أكبر من 7 كيلوبايت. لذلك، تعرض Apigee Edge الاستثناء com.apigee.errors.http.user.RequestURITooLong وتعرض رمز الحالة 414 برمز الخطأ protocol.http.TooBigline إلى تطبيقات العميل.

درجة الدقّة

الحدود المسموح بها

تتوقّع Apigee ألا يرسل تطبيق العميل وخادم الخلفية طلبات/خطوط الاستجابة التي تكون أحجامها أكبر من الحد المسموح به كما هو موثق في الحد الأقصى لسطر الطلب/الاستجابة في حدود Apigee Edge.

1. إذا كنت من مستخدمي Public Cloud، يكون الحدّ الأقصى لحجم الطلب وسطر الاستجابة كما هو موثَّق في حجم الطلب/الاستجابة-سطر في حدود Apigee Edge.
2. إذا كنت من المستخدمين الخاصين على السحابة الإلكترونية ، قد يكون تم تعديل الحدّ الأقصى التلقائي لحجم الطلب وسطر الرد (على الرغم من أنّ ذلك لا يُنصَح به). يمكنك تحديد الحدّ الأقصى المسموح به لحجم الطلب من خلال اتّباع التعليمات الواردة في كيفية التحقّق من الحدّ الحالي.

كيف يمكن التحقّق من الحد الحالي؟

يوضّح هذا القسم كيفية التحقق من أنّه قد تم تعديل الخاصية HTTPRequest.line.limit بقيمة جديدة في معالجات الرسائل.

1. في جهاز معالجة الرسائل، ابحث عن السمة HTTPRequest.line.limit في الدليل /opt/apigee/edge-message-processor/conf وتحقَّق لمعرفة القيمة التي تم ضبطها كما هو موضّح أدناه:

   grep -ri "HTTPRequest.line.limit" /opt/apigee/edge-message-processor/conf
   

2. في ما يلي نموذج النتيجة من الأمر أعلاه:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.line.limit=7k
   

3. في مثال الإخراج أعلاه، لاحظ أنّه تم ضبط السمة HTTPRequest.line.limit على القيمة 7k في http.properties.

   ويشير ذلك إلى أنّ الحدّ الأقصى لحجم سطر الطلب الذي تم ضبطه في Apigee لخدمات السحابة الإلكترونية الخاصة هو 7 كيلوبايت.

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

ضرورة جمع معلومات التشخيص

اجمع معلومات التشخيص التالية، ثم تواصَل مع فريق دعم Apigee Edge:

إذا كنت من مستخدمي Cloud Cloud، يُرجى تقديم المعلومات التالية:

• اسم المؤسسة
• اسم البيئة
• اسم الخادم الوكيل لواجهة برمجة التطبيقات
• أكمِل أمر curl المستخدَم لإعادة إظهار الخطأ 414.
• ملف التتبُّع الخاص بطلبات واجهة برمجة التطبيقات

إذا كنت مستخدم Cloud خاصًا، يُرجى تقديم المعلومات التالية:

• رسالة الخطأ الكاملة التي تم رصدها للطلبات التي تعذّر تنفيذها
• اسم المؤسسة
• اسم البيئة
• حزمة الخادم الوكيل لواجهة برمجة التطبيقات
• ملف التتبُّع الخاص بطلبات واجهة برمجة التطبيقات التي تعذّر تنفيذها
• أكمِل أمر curl المستخدَم لإعادة إظهار الخطأ 414.

• سجلات وصول NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  المكان: يتم استبدال ORG وENV وPORT# بالقيم الفعلية.

• سجلات نظام معالج الرسائل في /opt/apigee/var/log/edge-message-processor/logs/system.log