502 - مدخل غير صالح - MakeBigHeaders

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

المشكلة

يتلقّى تطبيق العميل رمز حالة HTTP ‏502 Bad Gateway مع رمز الخطأ protocol.http.TooBigHeaders كردّ على طلبات البيانات من واجهة برمجة التطبيقات.

رسالة الخطأ

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"response headers size exceeding 25,600",
      "detail":{
         "errorcode":"protocol.http.TooBigHeaders"
      }
   }
}

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

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

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

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

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

السبب: حجم العناوين في الاستجابة أكبر من الحدّ المسموح به

التشخيص

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

   رسالة الخطأ

   للتأكّد باستخدام رسالة الخطأ:

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

   مثال على رسالة الخطأ:

   "faultstring":"response headers size exceeding 25,600"

   في رسالة الخطأ أعلاه، لاحظ في faultstring أنّ الاستجابة تتضمّن عناوين يتجاوز حجمها الإجمالي الحدّ المسموح به.

   الطلب الفعلي

   للتأكّد باستخدام الطلب الفعلي:

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

   1. إذا كنت مستخدم Public Cloud/Private Cloud، أرسِل طلبًا مباشرةً إلى الخادم الخلفي من الخادم الخلفي نفسه أو أي جهاز آخر يُسمح لك منه بإرسال الطلب إلى الخادم الخلفي server.
   2. إذا كنت مستخدم Private Cloud، يمكنك أيضًا إرسال الطلب إلى الخادم الخلفي من أحد معالِجات الرسائل.
   3. افحص الاستجابة التي تم تلقّيها من الخادم الخلفي، واحتسِب حجم العناوين التي تم تمريرها في الاستجابة وتأكَّد منه على وجه التحديد.

   4. إذا تبيّن لك أنّ حجم العناوين في حمولة الاستجابة أكبر من الـ حدّ المسموح به في Apigee Edge، يكون ذلك هو سبب المشكلة.

      مثال على الاستجابة من الخادم الوجهة:

      curl -v https://TARGET_SERVER_HOST/test
      

      * About to connect() to 10.1.0.10 port 9000 (#0)
      *   Trying 10.1.0.10...
      * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
      > GET /test HTTP/1.1
      > User-Agent: curl/7.29.0
      > Host: 10.1.0.10:9000
      > Accept: */*
      <
      < HTTP/1.1 200 OK
      < Accept-Ranges: bytes
      < Content-Length: 0
      < Content-Type: text/plain; charset=utf-8
      < Last-Modified: Tue, 20 Jul 2021 09:23:56 GMT
      < Testheader1: XVlBzgba—-<snipped>---THctcuAx
      < Testheader2: hxKQFDaFpLSj—-<snipped>---FbcXoEFfRsWxP
      < Date: Fri, 23 Jul 2021 09:51:22 GMT
      <
      * Connection #0 to host 10.1.0.10 left intact
      

      في المثال أعلاه، يتجاوز حجم Testheader1 و Testheader2 الحدّ المسموح به، ما يؤدي إلى ظهور هذا الخطأ في Apigee Edge.

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

   للتأكّد باستخدام سجلّات معالج الرسائل:

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

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

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

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

      grep -ri "response headers size exceeding"
      

   3. ستعثر على أسطر من system.log مشابهة لما يلي. قد يختلف حجم رؤوس الاستجابة في حالتك:

      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest rev:1
      messageid:r23ijb1b-1  NIOThread@1 ERROR HTTP.CLIENT -
      HTTPClient$Context$3.onException() :  ClientChannel[Connected:
      Remote:3.7.1.1:9000 Local:192.168.2.1:56098]@8414 useCount=1
      bytesRead=0 bytesWritten=207 age=640ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response headers size exceeding 25,600
      
      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest
      rev:1 messageid:r23ijb1b-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@31f3ef88, response headers size exceeding 25,600)

   4. فور أن يتلقّى معالج الرسائل الاستجابة من الخادم الخلفي/الخادم الوجهة ويجد أنّ الحجم الإجمالي للعناوين أكبر من 25 كيلوبايت، يتوقف ويعرض الخطأ:

      response headers size exceeding 25,600

      يعني ذلك أنّ إجمالي حجم الرأس أكبر من 25 كيلوبايت ويعرض Apigee الخطأ عندما يبدأ الحجم في تجاوز الحدّ المسموح به وهو 25 كيلوبايت مع رمز الخطأ كـ protocol.http.TooBigHeaders

الدقة

الحدود

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

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

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

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

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

   grep -ri "HTTPResponse.headers.limit" /opt/apigee/edge-message-processor/conf
   

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

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.headers.limit=25k

3. في نموذج الناتج أعلاه، لاحظ أنّه تم ضبط الخاصية HTTPResponse.headers.limit بالقيمة 25k في http.properties.

   يشير ذلك إلى أنّ الحدّ المسموح به لحجم حمولة الاستجابة الذي تم ضبطه في Apigee لـ Private Cloud هو 25 كيلوبايت.

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

المعلومات التشخيصية التي يجب جمعها

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

إذا كنت مستخدم Public Cloud، قدِّم المعلومات التالية:

• اسم المؤسسة
• اسم البيئة
• اسم الخادم الوكيل لواجهة برمجة التطبيقات
• أمر curl الكامل المستخدَم لإعادة إظهار الخطأ 502
• ملف التتبُّع لطلبات البيانات من واجهة برمجة التطبيقات
• الناتج الكامل للاستجابة من الخادم الوجهة/الخادم الخلفي مع حجم العناوين

إذا كنت مستخدم Private Cloud، قدِّم المعلومات التالية:

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

• سجلّات الوصول إلى 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