502 Hatalı Ağ Geçidi - DecompressionFailureAtResponse

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Belirti

İstemci uygulaması 502 Bad Gateway HTTP durum kodunu hata koduyla alıyor API'ye yanıt olarak messaging.adaptors.http.flow.DecompressionFailureAtResponse çağrısının en iyi yolu.

Hata mesajı

İstemci uygulaması aşağıdaki yanıt kodunu alır:

HTTP/1.1 502 Bad Gateway

Ayrıca, aşağıda gösterilene benzer bir hata mesajı da görebilirsiniz:

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

Olası nedenler

Bu hata yalnızca aşağıdaki durumlarda oluşur:

• HTTP yanıtı başlığında belirtilen kodlama (arka uç/hedef sunucudan) Content-Encoding geçerli ve Apigee Edge tarafından destekleniyor,

ANCAK

• HTTP yanıtının bir parçası olarak arka uç/hedef sunucu tarafından gönderilen yük biçimi CANNOT TRANSLATE Content-Encoding başlıkta belirtilen kodlama biçimiyle eşleşmelidir.

Bunun nedeni, Apigee Edge'in yük biçiminin, Content-Encoding üstbilgisi.

Desteklenen Content-Encoding değerler ve Apigee Edge'in bazı örnekleri yük temsilinin aşağıdaki durumlarda olmasını bekler:

Bu hatanın olası nedenleri aşağıda açıklanmıştır:

Sık kullanılan teşhis adımları

Bu hatayı teşhis etmek için aşağıdaki araçlardan/tekniklerden birini kullanın:

Neden: Yanıt yükü biçimi Content-Encoding ile eşleşmiyor

Varsayılan olarak, Apigee Edge yanıt başlığı Content-Encoding, geçerli ve desteklenen kodlamayı kullanın. Dolayısıyla, yanıt yükünün biçiminin Content-Encoding yanıt başlığında belirtilen kodlamayla eşleşmelidir. Uyuşmazlık varsa bu hatayı alırsınız.

Teşhis

1. API kullanılarak gözlemlenen hatanın Hata Kodu ve Hata Kaynağı'nı belirleme İzleme, İzleme aracı veya NGINX erişim günlükleri aşağıda açıklandığı gibi Yaygın teşhis adımları.
2. Hata kodu messaging.adaptors.http.flow.DecompressionFailureAtResponse ve Hata Kaynağı target değerine sahipse bu arka uç/hedef sunucu tarafından gönderilen yanıt yükünün biçiminin desteklenen kodlama yanıt başlığında Content-Encoding belirtilir.

3. Aşağıdakilerden birini kullanarak HTTP yanıtının bir parçası olarak uyumsuzluğu belirleyebilirsiniz yöntemleri:

   Hata mesajı

   Hata mesajını kullanarak doğrulamak için:

   1. Apigee Edge'den alınan hata mesajının tamamına erişiminiz varsa faultstring inceleyin.

      Örnek hata mesajı:

      "faultstring":"Decompression failure at response"

   2. Yukarıdaki hata mesajında "Decompression failure at response": Bu, yanıtın Content-Encoding başlığı.

   Trace

   Trace kullanarak doğrulamak için:

   1. Content-Type ve error.cause değerlerini belirleyin. Trace'i kullanarak Yaygın teşhis adımları bölümünde açıklandığı gibi.

   2. Örnek izdeki değerler aşağıdaki gibidir:

      • İçerik Kodlaması: gzip
      • error.cause: Not in GZIP format

      Content-Encoding yanıt başlığındaki değer gzip şeklindedir; ancak yanıt yükü GZIP biçiminde değil (error.cause tarafından belirtildiği gibi). Bu nedenle Apigee Edge, 502 Bad Gateway ve hata kodu messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   Gerçek istek

   Gerçek isteği kullanarak doğrulamak için:

   Hedef/arka uç sunucuya gönderilen gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:

   1. Herkese Açık Bulut/Private Cloud kullanıcısıysanız istekte bulunun veya başka bir sunucudan doğrudan arka uç sunucusuna arka uç sunucuya istek yapmanıza izin verilen makineyi seçin.
   2. Private Cloud kullanıcısıysanız da istekte bulunabilirsiniz. arka uç sunucusuna postalayın.
   3. Arka uç sunucusu tarafından gönderilen yanıtı inceleyin ve Content-Encoding. yanıt başlığında başarılı
   4. İstek kapsamında gönderilen yükün biçimini belirleyin.
   5. Content-Encoding üstbilgisinin değeri kodlamayı destekler, ancak yanıt yükünün biçimi Content-Encoding başlığında belirtilen kodlamayla eşleşmediğinde, sorunun nedeni budur.

      Örnek:

      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)>
      

      Yukarıdaki örnek yanıt, gzip değerini Content-Encoding üstbilgisi desteklenen kodlamayı kullanıma sunuyoruz. Ancak response_payload.zip, zip dosyası olarak gönderilir. Dolayısıyla, yanıtı, hata koduyla birlikte 502 Bad Gateway hatası vererek başarısız oluyor: messaging.adaptors.http.flow.DecompressionFailureAtResponse.

   İleti işleyen günlükleri

   İleti İşleyici günlüklerini kullanarak doğrulamak için:

   Private Cloud kullanıcısıysanız Mesaj İşleyici günlüklerini kullanabilirsiniz HTTP 502 hatalarıyla ilgili önemli bilgileri belirlemek için.

   1. Mesaj İşleyici günlüğünü kontrol edin:

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

   2. Belirli bir sırasında 502 hatası olup olmadığını görmek için arama yapın (sorun geçmişte olduysa) veya yanıt verildiyse hâlâ 502 ile başarısız oluyor. Aşağıdaki arama dizesini kullanabilirsiniz:

      grep -ri "ZipException"
      

   3. system.log adresinde şuna benzer satırlar bulacaksınız:

      1. Senaryo

      1. Senaryo: API yanıtı Content-Encoding: gzip başlığına sahip olduğunda

      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
      

      Yukarıdaki hata mesajındaki java.util.zip.ZipException: Not in GZIP format satırı, yanıtın Content-Encoding olsa bile yük GZIP biçiminde gönderilmez. gzip olarak belirtilir. Bu nedenle, Apigee Edge istisnayı hata koduyla birlikte bir 502 durum kodu döndürür messaging.adaptors.http.flow.DecompressionFailureAtResponse özellikler sunar.

      2. Senaryo

      2. Senaryo: API yanıtı Content-Encoding: deflate olduğunda

      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
      
      

      Çizgiler java.util.zip.ZipException: incorrect header check. ve Caused by: java.util.zip.DataFormatException: incorrect header check yukarıdaki hata mesajında, yanıt yükünün kodlamayla eşleşmediğinden emin olun, Content-Encoding deflate başlığı. Bu nedenle Apigee Edge istisnayı bildirir ve şunu içeren bir 502 durum kodu döndürür: hata kodu messaging.adaptors.http.flow.DecompressionFailureAtResponse özellikler sunar.

Çözünürlük

1. Apigee Edge'deki API proxy akışında sıkıştırılmış yanıt yüküne ihtiyaç duymuyorsanız arka uç sunucusunda geçirmeyin Content-Encoding. Yanıt yükünü sıkıştırmak gerekirse 2. adıma gidin.
2. Yanıt yükünü sıkıştırmak gerekiyorsa arka uç sunucusunun her zaman şunları gönderir:
   • Şunlardan herhangi biri: desteklenen kodlamayı Content-Encoding üstbilgisi için yanıt
   • Apigee Edge'e desteklenen biçimdeki yanıt yükü kodlamayla eşleşir Content-Encoding başlığında belirtilen biçim
3. Yukarıda açıklanan örnekte, yanıt yükü ZIP biçiminde, ancak yanıt başlığı Content-Encoding: gzip belirtir. Yanıt göndererek sorunu düzeltebilirsiniz Content-Encoding: gzip olarak başlığı ve gzip içinde yanıt yükü biçim:

   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)>
   

Spesifikasyon

Apigee Edge, 502 Bad Gateway durum koduyla hata mesajı veriyor Aşağıdaki RFC'ye göre messaging.adaptors.http.flow.DecompressionFailureAtResponse özellikler:

Hâlâ Apigee Destek Ekibi'nden yardım almak istiyorsanız adresine gidin. Teşhis bilgileri toplanmalıdır.

Teşhis bilgileri toplanmalıdır

Aşağıdaki teşhis bilgilerini toplayın, ardından Apigee Edge Destek Ekibi ile iletişime geçin:

Herkese açık Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Kuruluş adı
• Ortam adı
• API Proxy adı
• 502 hatasını yeniden oluşturmak için kullanılan curl komutunu tamamlayın
• API yanıtları için izleme dosyası

Private Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Başarısız yanıtlar için tam hata mesajı gözlemlendi
• Ortam adı
• API Proxy paketi
• API yanıtları için izleme dosyası

• NGINX erişim günlükleri /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Yer: ORG, ENV ve PORT# şununla değiştirilir: gerçek değerler.

• Mesaj İşleyici sistem günlükleri /opt/apigee/var/log/edge-message-processor/logs/system.log