502 गलत गेटवे - DecompressionFailureAtResponse

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

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

क्लाइंट ऐप्लिकेशन को एपीआई कॉल के जवाब के तौर पर, 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"
      }
   }
}

संभावित कारण

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

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

BUT

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

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

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

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

गड़बड़ी का पता लगाने के सामान्य चरण

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

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

डिफ़ॉल्ट रूप से, Apigee Edge हमेशा पेलोड को डिकंप्रेस करता है. ऐसा तब होता है, जब रिस्पॉन्स हेडर में Content-Encoding मान्य और सपोर्ट की गई एन्कोडिंग शामिल हो. इसलिए, यह ज़रूरी है कि रिस्पॉन्स पेलोड का फ़ॉर्मैट, रिस्पॉन्स हेडर 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. 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. अगर आप Private Cloud के उपयोगकर्ता हैं, तो मैसेज प्रोसेसर में से किसी एक से बैकएंड सर्वर को अनुरोध भी भेजा जा सकता है.
   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 के उपयोगकर्ता हैं, तो एचटीटीपी 502 गड़बड़ियों के बारे में अहम जानकारी पाने के लिए, Message Processor के लॉग का इस्तेमाल किया जा सकता है.

   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 दिखाता है.

      Scenario #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 से पता चलता है कि रिस्पॉन्स पेलोड को डिफ़्लेट फ़ॉर्मैट में नहीं भेजा गया है. साथ ही, यह डिफ़्लेट के 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, 502 Bad Gateway स्टेटस कोड के साथ जवाब देता है. इसमें गड़बड़ी का कोड messaging.adaptors.http.flow.DecompressionFailureAtResponse होता है. यह जवाब, आरएफ़सी की इन खास बातों के मुताबिक होता है:

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

डाइग्नोस्टिक जानकारी इकट्ठा करना ज़रूरी है

गड़बड़ी की यह जानकारी इकट्ठा करें. इसके बाद, Apigee Edge की सहायता टीम से संपर्क करें:

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

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

अगर आप 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