درحال مشاهده اسناد 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 پشتیبانی شود، - قالب پایهبار ارسالی توسط سرور پشتیبان/مقصد بهعنوان بخشی از پاسخ HTTP
با قالب کدبندی مشخصشده در سرصفحه
Content-Encodingمطابقت ندارد
BUT
دلیل این است که Apigee Edge نمیتواند پایهبار را بااستفاده از کدبندی مشخصشده رمزگشایی کند زیرا قالب پایهبار با قالب کدبندی مشخصشده در
سرصفحه Content-Encoding یکسان نیست.
در اینجا چند نمونه از مقادیر پشتیبانیشده Content-Encoding و نحوه انتظار Apigee Edge
از نمایش بار در این موارد آورده شده است:
| سناریو | Content-Encoding | نمایش بار مفید ایمیل |
|---|---|---|
| کدبندی تکی | gzip | قالب یونیکس به قالب RFC1952 GZIP مراجعه کنید. |
| کدبندی تکی | کاهش دادن | این قالب از ساختار |
| کدبندی چندگانه | کدبندی چندگانه برای مثال، در مواردی که کدبندی دوبار انجام میشود، میتواند اینگونه باشد:
|
چندین کدبندی به ترتیب دادهبار در سرصفحه اعمال شده است. |
دلایل احتمالی این خطا به شرح زیر است:
| علت | شرح | دستورالعملهای عیبیابی برای موارد زیر قابلاجرا است |
|---|---|---|
| قالب بار پاسخ با «کدبندی محتوا» مطابقت ندارد | قالب پایهبار پاسخ ارسالی از سرور پشتیبان/مقصد یا
کدبندی نشده است یا
با کدبندی مشخصشده در سرصفحه Content-Encoding مطابقت ندارد. |
کاربران «فضای ابری خصوصی و عمومی لبهای» |
مراحل متداول تشخیص خرابی
برای تشخیص این خطا، از یکی از ابزارها/تکنیکهای زیر استفاده کنید:
پایش میانای برنامهسازی کاربردی
برای تشخیص خطا بااستفاده از «پایش API»:
- بهعنوان کاربری با نقش مناسب به سیستم Apigee Edge UI وارد شوید.
به سازمانی که میخواهید مشکل را در آن بررسی کنید بروید.
- به صفحه تجزیهوتحلیل > پایش API > بررسی پیمایش کنید.
- بازه زمانی خاصی را که در آن خطاها را مشاهده کردهاید انتخاب کنید.
- مطمئن شوید که فیلتر پروکسی روی همه تنظیم شده باشد.
- رسم کد خطا دربرابر زمان.
سلولی را که کد خطای
messaging.adaptors.http.flow.DecompressionFailureAtResponseرا دارد انتخاب کنید همانطور که در زیر نشان داده شده است:
اطلاعات مربوط به کد خطا
messaging.adaptors.http.flow.DecompressionFailureAtResponseبهصورت زیر نمایش داده میشود:
روی مشاهده گزارشها کلیک کنید و ردیفی را که با خطای
502ناموفق بوده است ازهم باز کنید.
- از پنجره گزارشها، جزئیات زیر را یادداشت کنید:
- کد وضعیت:
502 - منبع خطا:
target - کد خطا:
messaging.adaptors.http.flow.DecompressionFailureAtResponse.
- کد وضعیت:
- اگر منبع خطا مقدار
targetرا داشته باشد، این نشان میدهد که قالب پایهبار پاسخ با کدبندی پشتیبانیشده مشخصشده در سرصفحه پاسخ سرور زیرینهContent-Encodingمطابقت ندارد.
ابزار ردیابی
برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:
- جلسه ردیابی
و یکی از این موارد را فعال کنید:
- منتظر بمانید تا خطای
502 Bad Gatewayرخ دهد، یا - اگر میتوانید مشکل را بازتولید کنید، تماس API را برقرار کنید و مشکل را بازتولید کنید
502 Bad Gateway.
- منتظر بمانید تا خطای
مطمئن شوید که نمایش همه FlowInfos فعال باشد:
- یکی از پاسخهای ناموفق را انتخاب کنید و ردیابی را بررسی کنید.
- در مراحل مختلف ردیابی پیمایش کنید و مکان وقوع خطا را پیدا کنید.
معمولاً خطا را در جاریسازی درست پساز مرحله پاسخ دریافتی از سرور مقصد پیدا خواهید کرد، همانطور که در زیر نشان داده شده است:
-
مقادیر ویژگیها را از ردیابی یادداشت کنید:
- Content-Encoding:
gzip - بدنه محتوای پاسخ:
{"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}
- Content-Encoding:
به مرحله خطا درست پساز مرحله پاسخ از سرور مقصد دریافت شد پیمایش کنید:
خواص را یادداشت کنید:
- خطا:
Decompression failure at response - error.class:
com.apigee.errors.http.server.BadGateway error.cause:
Not in GZIP formaterror.cause بیان میکند که بار پاسخ در قالب GZIP نیست. این یعنی Apigee Edge انتظار داشت بار پاسخ در قالب GZIP باشد، همانطور که در سرصفحه
Content-Encodingمشخص شده است (در مرحله قبلی تعیین شده است).بنابراین، Apigee Edge نمیتواند بار را بااستفاده از gzip ازهم فشرده کند و خطایDecompression failure at responseرا برمیگرداند.
توجه داشته باشید که پاسخ از سرور هدف/زیرینه در این مورد
200است؛ بااینحال، برنامه مشتری پاسخ502را دریافت خواهد کرد زیرا خطا توسط Apigee Edge برگردانده میشود.- خطا:
به فاز پاسخ ارسالشده به مشتری در ردیابی پیمایش کنید و روی آن کلیک کنید.
جزئیات زیر را از ردیابی یادداشت کنید:
- رمز وضعیت:
502 Bad Gateway. - محتوای خطا:
{"fault":{"faultstring":"Decompression failure at response","detail":{"errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtResponse"}}}
- رمز وضعیت:
به فاز AX (دادههای Analytics ضبطشده) در ردیابی پیمایش کنید و روی آن کلیک کنید.
- به بخش جزئیات فاز، سرایندهای خطا در پایین پیمایش کنید و
مقادیر X-Apigee-fault-code و X-Apigee-fault-source
را همانطور که در زیر نشان داده شده است تعیین کنید:
- مقادیر X-Apigee-fault-code و X-Apigee-fault-source
را بهصورت
messaging.adaptors.http.flow.DecompressionFailureAtResponseوtargetخواهید دید که نشان میدهد قالب بار پاسخ با کدبندی مشخصشده در سرصفحهContent-Encodingمطابقت ندارد.سرایندهای پاسخ مقدار X-Apigee-fault-code messaging.adaptors.http.flow.DecompressionFailureAtResponseX-Apigee-fault-source target
NGINX
برای تشخیص خطا بااستفاده از گزارشهای دسترسی NGINX:
- اگر کاربر «ابر خصوصی» هستید، میتوانید از گزارشهای دسترسی NGINX برای
تعیین اطلاعات کلیدی درباره خطاهای
502HTTP استفاده کنید. گزارشهای دسترسی NGINX را بررسی کنید:
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_logمکان: ORG، ENV، و PORT# با مقادیر واقعی جایگزین میشوند.
- جستجو کنید تا ببینید آیا در طول مدت مشخصی خطاهای
502وجود دارد یا نه (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز پاسخهایی با502ناموفق هستند یا نه. اگر خطاهای
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.DecompressionFailureAtResponseX-Apigee-fault-source target
دلیل: قالب بار پاسخ با «کدبندی محتوا» مطابقت ندارد
بهطور پیشفرض، اگر سرایند پاسخ
Content-Encoding حاوی کدبندی معتبر و
پشتیبانیشده باشد، Apigee Edge همیشه بار را ازهم فشرده میکند. بنابراین، انتظار میرود که قالب بار پاسخ
با کدبندی مشخصشده در سرصفحه پاسخ Content-Encoding مطابقت داشته باشد.
اگر عدم تطابقی وجود داشته باشد، این خطا را دریافت میکنید.
تشخیص
- کد خطا و منبع خطا را برای خطای مشاهدهشده بااستفاده از «پایش میانای برنامهسازی کاربردی»، «ابزار ردیابی»، یا گزارشهای دسترسی NGINX همانطور که در مراحل تشخیص متداول توضیح داده شده است تعیین کنید.
- اگر کد خطا
messaging.adaptors.http.flow.DecompressionFailureAtResponseباشد و منبع خطا مقدارtargetرا داشته باشد، این نشان میدهد که قالب پایهبار پاسخ ارسالی از سرور هدف/زیرینه با کدبندی پشتیبانیشده مشخصشده در سرصفحه پاسخContent-Encodingمطابقت ندارد. میتوانید عدم تطابق را بهعنوان بخشی از پاسخ HTTP بااستفاده از یکی از روشهای زیر تعیین کنید: روشها:
پیام خطا
برای راستیآزمایی بااستفاده از پیام خطا:
-
اگر به پیام خطای کامل دریافتی از Apigee Edge دسترسی دارید، به
faultstringمراجعه کنید.پیام خطای نمونه:
"faultstring":"Decompression failure at response"
- در پیام خطای بالا،
"Decompression failure at response"نمایش داده میشود که به این معنی است که پاسخ بااستفاده از کدبندی مشخصشده در سرصفحهContent-Encodingنمیتواند ازهم فشرده شود.
ردیابی
برای اعتبارسنجی بااستفاده از «ردیابی»:
- Content-Type و error.cause را بااستفاده از Trace همانطور که در مراحل تشخیص خرابی رایج توضیح داده شده است تعیین کنید.
مقادیر نمونه ردیابی بهصورت زیر است:
- 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پاسخ میدهد.- Content-Encoding:
درخواست واقعی
برای اعتبارسنجی بااستفاده از درخواست واقعی:
اگر به درخواست واقعی که به برنامه سرور هدف/زیرینه ارسال شده است دسترسی دارید، مراحل زیر را انجام دهید:
- اگر کاربر «ابر عمومی/ابر خصوصی» هستید، از سرور پشتیبان خود یا هر ماشین دیگری که اجازه دارید از آن به سرور پشتیبان درخواست ارسال کنید، مستقیماً به سرور پشتیبان درخواست ارسال کنید.
- اگر کاربر «ابر خصوصی» هستید، میتوانید درخواست را از یکی از «پردازشگرهای پیام» به سرور زیرینه نیز ارسال کنید.
- پاسخ ارسالی از سرور زیرینه را بررسی کنید و مقدار
گذراندهشده در سرایند پاسخ
Content-Encoding.را تعیین کنید - قالب بار ارسالی بهعنوان بخشی از درخواست را تعیین کنید.
- اگر مقدار سرصفحه
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استفاده کنید.گزارش «پردازشگر پیام» را بررسی کنید:
/opt/apigee/var/log/edge-message-processor/logs/system.logجستجو کنید تا ببینید آیا در طول مدت زمان خاصی (اگر مشکل در گذشته رخ داده است) خطاهای
502وجود دارد یا خیر، یا اینکه آیا هنوز پاسخهایی با502ناموفق هستند یا خیر. میتوانید از رشته جستجوی زیر استفاده کنید:grep -ri "ZipException"
خطوطی از 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() : Exceptionjava.util.zip.ZipException: Not in GZIP formatoccurred 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به برنامههای مشتری برمیگرداند.
-
وضوح
- اگر در جریان پراکسی API در Apigee Edge
و در سرور زیرینه نیازی به بار فشرده پاسخ فشرده نیست، سرصفحه
Content-Encodingرا ارسال نکنید. اگر نیاز به فشردهسازی بار پاسخ وجود دارد، به مرحله ۲ بروید. - اگر نیاز به فشرده کردن بار پاسخ وجود دارد، مطمئن شوید که سرور پشتیبان
همیشه موارد زیر را ارسال میکند:
- هریک از
کدبندیهای پشتیبانیشده بهعنوان مقدار سرایند
Content-Encodingدر پاسخ - بار پاسخ در قالب پشتیبانیشده به Apigee Edge با قالب کدبندی مشخصشده در سرایند
Content-Encodingمطابقت دارد
- هریک از
کدبندیهای پشتیبانیشده بهعنوان مقدار سرایند
- در مثال بالا، بار پاسخ در قالب 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