502 مدخل غير صالح - إلغاء الضغط مضغوط لـFailureAtResponse

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

المشكلة

يتلقّى تطبيق العميل رمز حالة HTTP‏ 502 Bad Gateway مع رمز الخطأ messaging.adaptors.http.flow.DecompressionFailureAtResponse كاستجابة لطلبات البيانات من واجهة برمجة التطبيقات.

رسالة الخطأ

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

HTTP/1.1 502 Bad Gateway

بالإضافة إلى ذلك، قد تظهر لك رسالة خطأ مشابهة للرسالة الموضّحة أدناه:

{
   "fault":{
      "faultstring":"Decompression failure at response",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"
      }
   }
}

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

يحدث هذا الخطأ فقط في الحالات التالية:

• التشفير المحدّد في عنوان استجابة HTTP (من الخادم الخلفي/الخادم المستهدف) Content-Encoding صالح و متوافق مع Apigee Edge،

لكن

• لا يتطابق تنسيق الحمولة الذي يرسله الخادم الخلفي/الخادم المستهدف كجزء من استجابة HTTP مع تنسيق الترميز المحدّد في العنوان Content-Encoding .

ويرجع ذلك إلى أنّ Apigee Edge يتعذّر عليه فك ترميز الحمولة باستخدام الترميز المحدّد لأنّ تنسيق الحمولة ليس بالتنسيق نفسه الذي تم تحديده في عنوان Content-Encoding.

في ما يلي بعض الأمثلة على قيم Content-Encoding المتوافقة والطريقة التي تتوقّع بها Apigee Edge أن يكون تمثيل الحمولة في هذه الحالات:

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

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

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

السبب: لا يتطابق تنسيق حمولة الاستجابة مع Content-Encoding

تزيل Apigee Edge الضغط عن الحمولة تلقائيًا إذا كان عنوان الاستجابة Content-Encoding يحتوي على ترميز صالح ومتوافق. لذلك، من المتوقّع أن يتطابق تنسيق حمولة الرد مع الترميز المحدّد في عنوان الاستجابة Content-Encoding. إذا كان هناك عدم تطابق، سيظهر لك هذا الخطأ.

التشخيص

1. حدِّد رمز الخطأ ومصدر الخطأ للخطأ الذي تم رصده باستخدام أداة مراقبة واجهة برمجة التطبيقات أو أداة التتبُّع أو سجلّات الوصول إلى NGINX كما هو موضّح في خطوات التشخيص الشائعة.
2. إذا كان رمز الخطأ هو messaging.adaptors.http.flow.DecompressionFailureAtResponse وكان مصدر الخطأ يتضمّن القيمة target، يشير ذلك إلى أنّ تنسيق حمولة الاستجابة التي أرسلها الخادم الخلفي/خادم الهدف لا يتطابق مع التشفير المتوافق المحدّد في عنوان الاستجابة Content-Encoding.

3. يمكنك تحديد عدم التطابق كجزء من استجابة HTTP باستخدام إحدى الطرق التالية:

   رسالة الخطأ

   لإثبات صحة المعلومات باستخدام رسالة الخطأ، اتّبِع الخطوات التالية:

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

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

      "faultstring":"Decompression failure at response"

   2. في رسالة الخطأ أعلاه، يظهر "Decompression failure at response" ما يعني أنّه تعذّر فك ضغط الاستجابة باستخدام الترميز المحدّد في العنوان Content-Encoding.

   التتبّع

   لإثبات صحة البيانات باستخدام "التتبُّع"، اتّبِع الخطوات التالية:

   1. حدِّد Content-Type وerror.cause باستخدام Trace كما هو موضّح في خطوات التشخيص الشائعة.

   2. في ما يلي القيم من التتبُّع النموذجي:

      • Content-Encoding: gzip
      • error.cause: Not in GZIP format

      القيمة في عنوان الاستجابة Content-Encoding هي gzip، ولكن حمولة الاستجابة ليست بتنسيق GZIP (كما هو موضّح في error.cause). لذلك، تستجيب Apigee Edge بالرمز 502 Bad Gateway ورمز الخطأ messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   الطلب الفعلي

   لإثبات صحة الرمز باستخدام الطلب الفعلي، اتّبِع الخطوات التالية:

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

   1. إذا كنت مستخدمًا للسحابة الإلكترونية العامة أو الخاصة، يمكنك تقديم طلب مباشرةً إلى خادم الخلفية من خادم الخلفية نفسه أو أي جهاز آخر يُسمح لك من خلاله بتقديم الطلب إلى خادم الخلفية.
   2. إذا كنت مستخدمًا للسحابة الإلكترونية الخاصة، يمكنك أيضًا إرسال الطلب إلى خادم الخلفية من أحد معالِجات الرسائل.
   3. افحص الاستجابة التي أرسلها خادم الخلفية وحدِّد القيمة التي تم تمريرها في عنوان الاستجابة Content-Encoding..
   4. تحديد تنسيق الحمولة المُرسَلة كجزء من الطلب
   5. إذا كانت قيمة العنوان Content-Encoding مدرَجة في قائمة الترميز المتوافق ولكن تنسيق حمولة الاستجابة لا يتطابق مع الترميز المحدّد في العنوان Content-Encoding، يكون ذلك هو سبب المشكلة.

      عيّنة:

      curl -v https://HOSTALIAS/test
      

      ***trimmed***
      >
      < HTTP/1.1 200 OK
      < Accept-Ranges: bytes
      < Content-Encoding: gzip
      < Date: Mon, 02 Aug 2021 08:17:35 GMT
      < Transfer-Encoding: chunked
      <
      < response_payload.zip Response Body(not in GZIP format)>
      

      ترسل استجابة النموذج أعلاه القيمة gzip إلى العنوان Content-Encoding، وهو ترميز متوافق في Apigee Edge. ومع ذلك، يتم إرسال response_payload.zip كملف zip. لذلك، يتعذّر عرض هذه الاستجابة ويظهر الخطأ 502 Bad Gateway مع رمز الخطأ: messaging.adaptors.http.flow.DecompressionFailureAtResponse.

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

   لإثبات صحة البيانات باستخدام سجلّات "معالج الرسائل"، اتّبِع الخطوات التالية:

   إذا كنت مستخدمًا في Private Cloud، يمكنك استخدام سجلّات "معالج الرسائل" لتحديد المعلومات الأساسية حول أخطاء HTTP 502.

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

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

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

      grep -ri "ZipException"
      

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

      السيناريو 1

      السيناريو 1: عندما يتضمّن ردّ واجهة برمجة التطبيقات العنوان Content-Encoding: gzip

      2021-08-02 06:50:25,433  NIOThread@2 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:10.0.115.32:41298]@38140 useCount=1 bytesRead=0
      bytesWritten=203 age=469ms  lastIO=0ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      ---trimmed--
      2021-08-02 06:50:25,433  NIOThread@2 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details : host=null
      path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:50:25,434  NIOThread@2 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@4806fdab, Not in GZIP format)
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: Not in GZIP format
      occurred while writing to channel null
      2021-08-02 06:50:25,434  NIOThread@2 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: Not in GZIP format
      

      يشير السطر java.util.zip.ZipException: Not in GZIP format في رسالة الخطأ أعلاه إلى أنّه لم يتم إرسال حمولة الرد بتنسيق GZIP على الرغم من تحديد Content-Encoding على أنّه gzip. لذلك، يعرض Apigee Edge الاستثناء ويعرض رمز الحالة 502 مع رمز الخطأ messaging.adaptors.http.flow.DecompressionFailureAtResponse لتطبيقات العميل.

      السيناريو 2

      السيناريو 2: عندما يتضمّن ردّ واجهة برمجة التطبيقات العنوان Content-Encoding: deflate

      2021-08-02 06:35:21,215  NIOThread@0 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :  ClientInputChannel(ClientChannel[Connected:
      Remote:3.8.1.1:9000 Local:192.168.194.140:35224]@36014 useCount=1 bytesRead=0
      bytesWritten=202 age=439ms  lastIO=2ms  isOpen=true).onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
      ---trimmed----
      Caused by:
      java.util.zip.DataFormatException: incorrect header check
      ---trimmed---
      2021-08-02 06:35:21,215  NIOThread@0 INFO  HTTP.CLIENT -
      HTTPClient$Context.logContextDetails() : Request details :
      host=null path=/folder/testFile method=GET. Channel details : Bytes read=0
      2021-08-02 06:35:21,216  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError(HTTPResponse@3966e277,
      incorrect header check)
      2021-08-02 06:35:21,216  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception
      java.util.zip.ZipException: incorrect header check occurred while writing to channel null
      2021-08-02 06:35:21,217  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: incorrect header check
      
      

      يشير السطران java.util.zip.ZipException: incorrect header check و Caused by: java.util.zip.DataFormatException: incorrect header check في رسالة الخطأ أعلاه إلى أنّه لم يتم إرسال حمولة الاستجابة بتنسيق deflate وأنّها لا تتطابق مع الترميز المحدّد في عنوان Content-Encoding الخاص بتنسيق deflate. لذلك، يعرض Apigee Edge الاستثناء ويعرض رمز الحالة 502 مع رمز الخطأ messaging.adaptors.http.flow.DecompressionFailureAtResponse لتطبيقات العميل.

الدقة

1. إذا لم تكن هناك حاجة إلى حمولة الاستجابة المضغوطة في مسار خادم وكيل لواجهة برمجة التطبيقات في Apigee Edge وفي خادم الخلفية، لا تمرِّر العنوان Content-Encoding. إذا كان من الضروري ضغط حمولة الرد، انتقِل إلى الخطوة 2.
2. إذا كان من الضروري ضغط حمولة الاستجابة، تأكَّد من أنّ خادم الخلفية يرسل دائمًا ما يلي:
   • أي من عمليات الترميز المتوافقة كقيمة لعنوان Content-Encoding في الاستجابة
   • تتطابق حمولة الاستجابة بالتنسيق المتوافق مع Apigee Edge مع تنسيق الترميز المحدّد في العنوان Content-Encoding
3. في المثال الموضّح أعلاه، تكون حمولة الرد بتنسيق ZIP، ولكن يحدّد عنوان الاستجابة Content-Encoding: gzip. يمكنك حلّ المشكلة من خلال إرسال عنوان الاستجابة بالتنسيق Content-Encoding: gzip وحِمل الاستجابة بالتنسيق gzip:

   curl -v https://HOSTALIAS/v1/test
   

   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Encoding: gzip
   < Date: Mon, 02 Aug 2021 08:17:35 GMT
   < Transfer-Encoding: chunked
   <
   < response_payload.gz Response Body(in GZIP format)>
   

المواصفات

تستجيب Apigee Edge برمز الحالة 502 Bad Gateway مع رمز الخطأ messaging.adaptors.http.flow.DecompressionFailureAtResponse وفقًا لمواصفات RFC التالية:

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

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

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

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

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

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

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

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