502 गलत गेटवे - DecompressionFailureAtResponse

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी

समस्या का ब्यौरा

क्लाइंट ऐप्लिकेशन को एपीआई कॉल के रिस्पॉन्स के तौर पर, गड़बड़ी कोड messaging.adaptors.http.flow.DecompressionFailureAtResponse के साथ 502 Bad Gateway का एचटीटीपी स्टेटस कोड मिलता है.

गड़बड़ी का मैसेज

क्लाइंट ऐप्लिकेशन को यह रिस्पॉन्स कोड मिलता है:

HTTP/1.1 502 Bad Gateway

इसके अलावा, आपको गड़बड़ी का एक मैसेज भी दिख सकता है, जो नीचे दिखाए गए मैसेज से मिलता-जुलता हो:

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

संभावित कारण

यह गड़बड़ी सिर्फ़ तब दिखती है, जब:

• एचटीटीपी रिस्पॉन्स (बैकएंड/टारगेट सर्वर से) हेडर में बताए गए एन्कोडिंग Content-Encoding मान्य है और Apigee Edge के साथ काम करता है,

लेकिन

• एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर बैकएंड/टारगेट सर्वर से भेजा गया पेलोड फ़ॉर्मैट, Content-Encoding हेडर में बताए गए कोड में बदलने के फ़ॉर्मैट से मेल नहीं खाता

इसकी वजह यह है कि Apigee Edge, बताए गए कोड में बदलने के तरीके का इस्तेमाल करके पेलोड को डिकोड नहीं कर पाता है. ऐसा इसलिए होता है, क्योंकि पेलोड का फ़ॉर्मैट, Content-Encoding हेडर में बताए गए फ़ॉर्मैट में नहीं होता.

यहां इस्तेमाल की जा सकने वाली Content-Encoding वैल्यू के कुछ उदाहरण दिए गए हैं. साथ ही, यहां बताया गया है कि ऐसे मामलों में Apigee Edge पेलोड कैसा दिखेगा:

स्थिति	कॉन्टेंट को कोड में बदलने का तरीका	पेलोड प्रज़ेंटेशन
सिंगल एन्कोडिंग	gzip	Unix gzip फ़ॉर्मैट. RFC1952 GZIP फ़ॉर्मैट देखें.
सिंगल एन्कोडिंग	कम करना	इस फ़ॉर्मैट में, डिलेट कंप्रेशन एल्गोरिदम के साथ zlib स्ट्रक्चर का इस्तेमाल किया जाता है. RFC1950 और RFC1951. देखें
एक से ज़्यादा एन्कोडिंग	एक से ज़्यादा एन्कोडिंग उदाहरण के लिए, जब एन्कोडिंग दो बार की जाती है, तो यह हो सकता है: gzip, डिफ़्लेट gzip, gzip डिफ़्लेट, gzip अपस्फीति, अपस्फीति	पेलोड पर, दिए गए क्रम में एक से ज़्यादा एन्कोडिंग लागू की गई हैं, जैसा कि हेडर में दिखता है.

इस गड़बड़ी की ये वजहें हो सकती हैं:

वजह	ब्यौरा	समस्या हल करने के लिए निर्देश
रिस्पॉन्स पेलोड फ़ॉर्मैट, कॉन्टेंट को कोड में बदलने के तरीके से मेल नहीं खाता	बैकएंड/टारगेट सर्वर से भेजे गए रिस्पॉन्स पेलोड के फ़ॉर्मैट को या तो कोड में नहीं बदला गया है या वह Content-Encoding हेडर में बताए गए एन्कोडिंग से मेल नहीं खाता.	Edge के सार्वजनिक और निजी क्लाउड के उपयोगकर्ता

निदान के सामान्य चरण

इस गड़बड़ी का पता लगाने के लिए, नीचे दिए गए किसी टूल/तकनीक का इस्तेमाल करें:

वजह: रिस्पॉन्स पेलोड फ़ॉर्मैट, कॉन्टेंट को कोड में बदलने के तरीके से मेल नहीं खाता

अगर रिस्पॉन्स हेडर Content-Encoding में मान्य हो और काम करने वाली एन्कोडिंग हो, तो Apigee Edge डिफ़ॉल्ट रूप से, पेलोड को हमेशा डीकंप्रेस कर देता है. इसलिए, यह उम्मीद की जाती है कि रिस्पॉन्स पेलोड का फ़ॉर्मैट, रिस्पॉन्स हेडर Content-Encoding में बताए गए एन्कोडिंग से मिलता रहे. अगर कुछ मेल नहीं खाता, तो आपको यह गड़बड़ी दिखेगी.

संक्रमण की जांच

1. एपीआई मॉनिटरिंग, ट्रेस टूल या NGINX ऐक्सेस लॉग का इस्तेमाल करके मिली गड़बड़ी के लिए, गलत कोड और गलत सोर्स का पता लगाएं. डाइग्नोस्टिक के सामान्य तरीके में बताया गया है.
2. अगर गलत कोड messaging.adaptors.http.flow.DecompressionFailureAtResponse है और गलत सोर्स की वैल्यू target है, तो इससे पता चलता है कि बैकएंड/टारगेट सर्वर से भेजे गए रिस्पॉन्स पेलोड का फ़ॉर्मैट, रिस्पॉन्स हेडर Content-Encoding में बताए गए इस्तेमाल किए जा सकने वाले एन्कोडिंग से मेल नहीं खाता.

3. एचटीटीपी रिस्पॉन्स के तौर पर, मेल न खाने वाले आइटम का पता लगाने के लिए यहां दिए गए तरीकों में से किसी एक का इस्तेमाल किया जा सकता है:

   गड़बड़ी का मैसेज

   गड़बड़ी के मैसेज का इस्तेमाल करके पुष्टि करने के लिए:

   1. अगर आपके पास Apigee Edge से मिले गड़बड़ी के पूरे मैसेज का ऐक्सेस है, तो faultstring देखें.

      गड़बड़ी के मैसेज का सैंपल:

      "faultstring":"Decompression failure at response"
      

   2. ऊपर दिए गए गड़बड़ी के मैसेज में, यह "Decompression failure at response" दिखाता है. इसका मतलब है कि रिस्पॉन्स को, Content-Encoding हेडर में बताए गए कोड में बदलने के तरीके का इस्तेमाल करके डीकंप्रेस नहीं किया जा सका.

   ट्रेस

   ट्रेस की मदद से पुष्टि करने के लिए:

   1. गड़बड़ी की जानकारी के सामान्य तरीके में बताए गए तरीके से, ट्रेस का इस्तेमाल करके, कॉन्टेंट-टाइप और error.cause की पहचान करें.

   2. सैंपल ट्रेस में से वैल्यू इस तरह हैं:

      • कॉन्टेंट को कोड में बदलने का तरीका: gzip
      • error.cause: Not in GZIP format

      रिस्पॉन्स हेडर कॉन्टेंट-एन्कोडिंग में वैल्यू 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.

   मैसेज प्रोसेसर के लॉग

   Message प्रोसेसर लॉग का इस्तेमाल करके पुष्टि करने के लिए:

   अगर आप प्राइवेट क्लाउड उपयोगकर्ता हैं, तो आपके पास मैसेज प्रोसेसर लॉग का इस्तेमाल करके, एचटीटीपी 502 की गड़बड़ियों के बारे में अहम जानकारी तय करने का विकल्प होता है.

   1. Message प्रोसेसर का लॉग देखें:

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

   2. यह देखने के लिए खोजें कि किसी खास अवधि के दौरान 502 से जुड़ी कोई गड़बड़ी तो नहीं हुई है (अगर समस्या पहले हुई थी) या क्या 502 में अब भी कोई जवाब काम नहीं कर रहा है. इन खोज स्ट्रिंग का इस्तेमाल किया जा सकता है:

      grep -ri "ZipException"
      

   3. आपको System.log से मिलती-जुलती लाइनें दिखेंगी:

      स्थिति #1

      स्थिति #1: जब एपीआई के रिस्पॉन्स में कॉन्टेंट-कोड में बदलने का हेडर: 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: जब एपीआई के रिस्पॉन्स में हेडर कॉन्टेंट-कोड में बदलने का तरीका हो: 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 से पता चलता है कि रिस्पॉन्स पेलोड को डिलेट फ़ॉर्मैट में नहीं भेजा गया है. साथ ही, यह डिलेट के Content-Encoding हेडर में बताए गए एन्कोडिंग से मेल नहीं खाता. इसलिए, Apigee Edge, अपवाद को दिखाता है और क्लाइंट ऐप्लिकेशन को गड़बड़ी कोड messaging.adaptors.http.flow.DecompressionFailureAtResponse के साथ, 502 स्टेटस कोड दिखाता है.

रिज़ॉल्यूशन

1. अगर 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 गड़बड़ी कोड messaging.adaptors.http.flow.DecompressionFailureAtResponse के साथ स्टेटस कोड 502 Bad Gateway के साथ जवाब देता है:

खास जानकारी
आरएफ़सी 7231, सेक्शन 6.5.1
आरएफ़सी 7231, सेक्शन 3.1.2.2

अगर आपको अब भी Apigee सहायता से कोई मदद चाहिए, तो गड़बड़ी की जानकारी इकट्ठा करना ज़रूरी है पर जाएं.

ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़ी जानकारी इकट्ठा करनी होगी

ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़ी यह जानकारी इकट्ठा करें और Apigee Edge की सहायता टीम से संपर्क करें:

अगर आप Public Cloud उपयोगकर्ता हैं, तो यह जानकारी दें:

• संगठन का नाम
• परिवेश का नाम
• एपीआई प्रॉक्सी का नाम
• 502 गड़बड़ी को फिर से दिखाने के लिए, पूरे curl निर्देश का इस्तेमाल किया गया
• एपीआई से मिले रिस्पॉन्स के लिए ट्रेस फ़ाइल

अगर आप प्राइवेट क्लाउड उपयोगकर्ता हैं, तो यह जानकारी दें:

• असफल रिस्पॉन्स के लिए देखा गया पूरा गड़बड़ी का मैसेज
• परिवेश का नाम
• एपीआई प्रॉक्सी बंडल
• एपीआई से मिले रिस्पॉन्स के लिए ट्रेस फ़ाइल

• 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