‫۵۰۲ دروازه نادرست - DecompressionFailureAtResponse

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

نشانه

برنامه مشتری کد وضعیت HTTP 502 Bad Gateway را با کد خطا messaging.adaptors.http.flow.DecompressionFailureAtResponse به‌عنوان پاسخ به فراخوانی‌های API دریافت می‌کند.

پیام خطا

برنامه کارخواه کد پاسخ زیر را دریافت می‌کند:

HTTP/1.1 502 Bad Gateway

علاوه‌براین، ممکن است پیام خطایی مشابه پیام زیر مشاهده کنید:

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

علل احتمالی

این خطا فقط در شرایط زیر رخ می‌دهد:

  • کدبندی مشخص‌شده در سرایند پاسخ HTTP (از سرور پشتیبان/مقصد) Content-Encoding معتبر باشد و توسط Apigee Edge پشتیبانی شود،
  • BUT

  • قالب پایه‌بار ارسالی توسط سرور پشتیبان/مقصد به‌عنوان بخشی از پاسخ HTTP با قالب کدبندی مشخص‌شده در سرصفحه Content-Encoding مطابقت ندارد

دلیل این است که Apigee Edge نمی‌تواند پایه‌بار را بااستفاده از کدبندی مشخص‌شده رمزگشایی کند زیرا قالب پایه‌بار با قالب کدبندی مشخص‌شده در سرصفحه Content-Encoding یکسان نیست.

در اینجا چند نمونه از مقادیر پشتیبانی‌شده Content-Encoding و نحوه انتظار Apigee Edge از نمایش بار در این موارد آورده شده است:

سناریو Content-Encoding نمایش بار مفید ایمیل
کدبندی تکی gzip

قالب یونیکس gzip.

به قالب RFC1952 GZIP مراجعه کنید.

کدبندی تکی کاهش دادن

این قالب از ساختار zlib با الگوریتم فشرده‌سازی deflate استفاده می‌کند.

RFC1950 و RFC1951. را ببینید

کدبندی چندگانه

کدبندی چندگانه

برای مثال، در مواردی که کدبندی دوبار انجام می‌شود، می‌تواند این‌گونه باشد:

  • gzip،‏ deflate
  • gzip،‏ gzip
  • deflate،‏ gzip
  • باد خالی کردن، باد خالی کردن
چندین کدبندی به ترتیب داده‌بار در سرصفحه اعمال شده است.

دلایل احتمالی این خطا به شرح زیر است:

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
قالب بار پاسخ با «کدبندی محتوا» مطابقت ندارد قالب پایه‌بار پاسخ ارسالی از سرور پشتیبان/مقصد یا کدبندی نشده است یا با کدبندی مشخص‌شده در سرصفحه Content-Encoding مطابقت ندارد. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»

مراحل متداول تشخیص خرابی

برای تشخیص این خطا، از یکی از ابزارها/تکنیک‌های زیر استفاده کنید:

پایش میانای برنامه‌سازی کاربردی

برای تشخیص خطا بااستفاده از «پایش API»:

  1. به‌عنوان کاربری با نقش مناسب به سیستم Apigee Edge UI وارد شوید.
  2. به سازمانی که می‌خواهید مشکل را در آن بررسی کنید بروید.

  3. به صفحه تجزیه‌وتحلیل > پایش API > بررسی پیمایش کنید.
  4. بازه زمانی خاصی را که در آن خطاها را مشاهده کرده‌اید انتخاب کنید.
  5. مطمئن شوید که فیلتر پروکسی روی همه تنظیم شده باشد.
  6. رسم کد خطا دربرابر زمان.
  7. سلولی را که کد خطای messaging.adaptors.http.flow.DecompressionFailureAtResponse را دارد انتخاب کنید همان‌طور که در زیر نشان داده شده است:

    ( مشاهده تصویر بزرگ‌تر)

  8. اطلاعات مربوط به کد خطا messaging.adaptors.http.flow.DecompressionFailureAtResponse به‌صورت زیر نمایش داده می‌شود:

    ( مشاهده تصویر بزرگ‌تر)

  9. روی مشاهده گزارش‌ها کلیک کنید و ردیفی را که با خطای 502 ناموفق بوده است ازهم باز کنید.

    ( مشاهده تصویر بزرگ‌تر)

  10. از پنجره گزارش‌ها، جزئیات زیر را یادداشت کنید:
    • کد وضعیت: 502
    • منبع خطا: target
    • کد خطا: messaging.adaptors.http.flow.DecompressionFailureAtResponse.
  11. اگر منبع خطا مقدار target را داشته باشد، این نشان می‌دهد که قالب پایه‌بار پاسخ با کدبندی پشتیبانی‌شده مشخص‌شده در سرصفحه پاسخ سرور زیرینه Content-Encoding مطابقت ندارد.

ابزار ردیابی

برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:

  1. جلسه ردیابی و یکی از این موارد را فعال کنید:
    1. منتظر بمانید تا خطای 502 Bad Gateway رخ دهد، یا
    2. اگر می‌توانید مشکل را بازتولید کنید، تماس API را برقرار کنید و مشکل را بازتولید کنید 502 Bad Gateway.
  2. مطمئن شوید که نمایش همه FlowInfos فعال باشد:

  3. یکی از پاسخ‌های ناموفق را انتخاب کنید و ردیابی را بررسی کنید.
  4. در مراحل مختلف ردیابی پیمایش کنید و مکان وقوع خطا را پیدا کنید.
  5. معمولاً خطا را در جاری‌سازی درست پس‌از مرحله پاسخ دریافتی از سرور مقصد پیدا خواهید کرد، همان‌طور که در زیر نشان داده شده است:

    ( مشاهده تصویر بزرگ‌تر)

  6. مقادیر ویژگی‌ها را از ردیابی یادداشت کنید:

    • Content-Encoding: gzip
    • بدنه محتوای پاسخ: {"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}
  7. به مرحله خطا درست پس‌از مرحله پاسخ از سرور مقصد دریافت شد پیمایش کنید:

    ( مشاهده تصویر بزرگ‌تر)

    خواص را یادداشت کنید:

    • خطا: Decompression failure at response
    • error.class: com.apigee.errors.http.server.BadGateway
    • error.cause: Not in GZIP format

      error.cause بیان می‌کند که بار پاسخ در قالب GZIP نیست. این یعنی Apigee Edge انتظار داشت بار پاسخ در قالب GZIP باشد، همان‌طور که در سرصفحه Content-Encoding مشخص شده است (در مرحله قبلی تعیین شده است).بنابراین، Apigee Edge نمی‌تواند بار را بااستفاده از gzip ازهم فشرده کند و خطای Decompression failure at response را برمی‌گرداند.

    توجه داشته باشید که پاسخ از سرور هدف/زیرینه در این مورد 200 است؛ بااین‌حال، برنامه مشتری پاسخ 502 را دریافت خواهد کرد زیرا خطا توسط Apigee Edge برگردانده می‌شود.

  8. به فاز پاسخ ارسال‌شده به مشتری در ردیابی پیمایش کنید و روی آن کلیک کنید.

    ( مشاهده تصویر بزرگ‌تر)

    جزئیات زیر را از ردیابی یادداشت کنید:

    • رمز وضعیت: 502 Bad Gateway.
    • محتوای خطا: {"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}
  9. به فاز AX (داده‌های Analytics ضبط‌شده) در ردیابی پیمایش کنید و روی آن کلیک کنید.

  10. به بخش جزئیات فاز، سرایندهای خطا در پایین پیمایش کنید و مقادیر X-Apigee-fault-code و X-Apigee-fault-source را همان‌طور که در زیر نشان داده شده است تعیین کنید:

    ( مشاهده تصویر بزرگ‌تر)

  11. مقادیر X-Apigee-fault-code و X-Apigee-fault-source را به‌صورت messaging.adaptors.http.flow.DecompressionFailureAtResponse و target خواهید دید که نشان می‌دهد قالب بار پاسخ با کدبندی مشخص‌شده در سرصفحه Content-Encoding مطابقت ندارد.
    سرایند‌های پاسخ مقدار
    X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtResponse
    X-Apigee-fault-source target

NGINX

برای تشخیص خطا بااستفاده از گزارش‌های دسترسی NGINX:

  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید از گزارش‌های دسترسی NGINX برای تعیین اطلاعات کلیدی درباره خطاهای 502 HTTP استفاده کنید.
  2. گزارش‌های دسترسی NGINX را بررسی کنید:

    /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

    مکان: ORG، ENV، و PORT# با مقادیر واقعی جایگزین می‌شوند.

  3. جستجو کنید تا ببینید آیا در طول مدت مشخصی خطاهای 502 وجود دارد یا نه (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز پاسخ‌هایی با 502 ناموفق هستند یا نه.
  4. اگر خطاهای 502 را با X-Apigee-fault-code مطابق با مقدار messaging.adaptors.http.flow.DecompressionFailureAtResponse پیدا کردید، مقدار X-Apigee-fault-source را تعیین کنید.

    نمونه خطای ۵۰۲ از گزارش دسترسی NGINX:

    ورودی نمونه بالا از گزارش دسترسی NGINX مقادیر زیر را برای X-Apigee-fault-code و X-Apigee-fault-source: دارد:

    سرایند‌های پاسخ مقدار
    X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtResponse
    X-Apigee-fault-source target

دلیل: قالب بار پاسخ با «کدبندی محتوا» مطابقت ندارد

به‌طور پیش‌فرض، اگر سرایند پاسخ Content-Encoding حاوی کدبندی معتبر و پشتیبانی‌شده باشد، Apigee Edge همیشه بار را ازهم فشرده می‌کند. بنابراین، انتظار می‌رود که قالب بار پاسخ با کدبندی مشخص‌شده در سرصفحه پاسخ 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 ناموفق است.

    گزارش‌های «پردازشگر پیام»

    برای اعتبارسنجی بااستفاده از گزارش‌های «پردازشگر پیام»:

    اگر کاربر «ابر خصوصی» هستید، می‌توانید از گزارش‌های «پردازشگر پیام» برای تعیین اطلاعات کلیدی درباره خطاهای HTTP 502 استفاده کنید.

    1. گزارش «پردازشگر پیام» را بررسی کنید:

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

    2. جستجو کنید تا ببینید آیا در طول مدت زمان خاصی (اگر مشکل در گذشته رخ داده است) خطاهای 502 وجود دارد یا خیر، یا اینکه آیا هنوز پاسخ‌هایی با 502 ناموفق هستند یا خیر. می‌توانید از رشته جستجوی زیر استفاده کنید:

      grep -ri "ZipException"
      
    3. خطوطی از system.log مشابه با موارد زیر پیدا خواهید کرد:

      سناریو شماره ۱

      سناریو ۱: وقتی پاسخ میانای برنامه‌سازی کاربردی دارای سرایند 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 به برنامه‌های مشتری برمی‌گرداند.

      سناریو شماره ۲

      سناریو شماره ۲: وقتی پاسخ «میانای برنامه‌سازی کاربردی» سرصفحه «کدبندی محتوا: 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. اگر در جریان پراکسی API در Apigee Edge و در سرور زیرینه نیازی به بار فشرده پاسخ فشرده نیست، سرصفحه Content-Encoding را ارسال نکنید. اگر نیاز به فشرده‌سازی بار پاسخ وجود دارد، به مرحله ۲ بروید.
  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 زیر پاسخ می‌دهد:

مشخصات
RFC 7231، بخش ۶.۵.۱
RFC 7231، بخش ۳.۱.۲.۲

اگر هنوز به کمک «پشتیبانی Apigee» نیاز دارید، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

باید اطلاعات تشخیص خرابی را جمع‌آوری کند

اطلاعات تشخیص خرابی زیر را جمع‌آوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید:

اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:

  • نام سازمان
  • نام محیط
  • نام پراکسی میانای برنامه‌سازی کاربردی
  • فرمان کامل 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