400 Hatalı İstek - Sıkıştırmayı Açma Hatası

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Belirti

İstemci uygulaması, API çağrılarına yanıt olarak messaging.adaptors.http.flow.DecompressionFailureAtRequest hata koduyla birlikte 400 Bad Request HTTP durum kodunu alır.

Hata mesajı

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

HTTP/1.1 400 Bad Request

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

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

Olası nedenler

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

• Content-Encoding HTTP isteği başlığında belirtilen kodlama geçerlidir ve Apigee Edge tarafından desteklenmektedir.

ANCAK

• İstemci tarafından HTTP isteğinin bir parçası olarak gönderilen yük biçimi, Content-Encoding üst bilgisinde belirtilen kodlama biçimiyle eşleşmiyor.

Bunun nedeni, yükün biçimi Content-Encoding başlığında belirtilen kodlamayla aynı biçimde olmadığı için Apigee Edge'in belirtilen kodlamayı kullanarak yükü çözememesidir.

Aşağıda, desteklenen Content-Encoding değerlere ve Apigee Edge'in bu durumlarda yük biçiminin nasıl olmasını beklediğine dair birkaç örnek verilmiştir:

Senaryo	İçerik-Kodlaması	Beklenen yük biçimi
Tek Kodlama	gzip	Unix gzip biçimi. RFC1952 GZIP Biçimi sayfasını inceleyin.
Tek Kodlama	söndürme	Bu biçim, sıkıştırma sıkıştırması algoritmasıyla zlib yapısını kullanır. Bkz. RFC1950 ve RFC1951.
Birden Çok Kodlama	Birden Çok Kodlama Örneğin, kodlama iki kez yapıldığında şu olabilir: gzip, sıkıştırma gzip, gzip deflate, gzip havayı söndürme, azaltma	Başlıkta göründüğü sırada yüke birden fazla kodlama uygulanır.

Bu hatanın olası nedenleri şunlardır:

Neden	Açıklama	Şunun için geçerli sorun giderme talimatları:
İstek yükü biçimi, Content-Encoding başlığında belirtilen kodlamayla eşleşmiyor	İstemci tarafından gönderilen istek yükünün biçimi kodlanmamış veya Content-Encoding başlığında belirtilen kodlamayla eşleşmiyor.	Edge Herkese Açık ve Özel Bulut kullanıcıları

Yaygın teşhis adımları

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

Neden: İstek yükü biçimi, Content-Encoding başlığında belirtilen kodlamayla eşleşmiyor

Content-Encoding istek başlığı hem geçerli hem de desteklenen bir kodlama içeriyorsa Apigee Edge varsayılan olarak yükü her zaman açar. Bu nedenle, istek yükünün biçiminin Content-Encoding istek başlığında belirtilen kodlamayla eşleşmesi beklenir. Uyuşmazlık varsa bu hatayı alırsınız.

Teşhis

1. API Monitoring, İzleme aracı veya NGINX erişim günlüklerini kullanarak gözlemlenen hata için Yaygın teşhis adımları bölümünde açıklandığı şekilde Hata Kodu ve Hata Kaynağı'nı belirleyin.
2. Hata Kodu messaging.adaptors.http.flow.DecompressionFailureAtRequest ise ve Hata Kaynağı policy veya proxy değerine sahipse bu durum, istemci uygulaması tarafından gönderilen isteğin, Content-Encoding istek başlığında belirtilen desteklenen kodlamayla eşleşmeyen bir yüke sahip olduğunu gösterir.

3. Uyuşmazlığı, aşağıdaki yöntemlerden birini kullanarak HTTP isteğinin bir parçası olarak belirleyebilirsiniz:

   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 dokümanına bakın.

      Örnek hata mesajı:

      "faultstring":"Decompression failure at request"
      

   2. Yukarıdaki hata mesajında, isteğin Content-Encoding üstbilgisinde belirtilen kodlama kullanılarak sıkıştırılamadığı anlamına gelen "Decompression failure at request" görüntülenir.

   Trace

   Trace kullanarak doğrulamak için:

   1. Yaygın teşhis adımlarında açıklandığı şekilde, Trace kullanarak Content-Encoding istek başlığı ve error.cause özelliğinin değerini belirleyin.

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

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

      İstek başlığındaki Content-Encoding değeri, gzip şeklindedir. Ancak, istek yükü GZIP biçiminde değildir (error.cause ile gösterilir). Bu nedenle Apigee Edge, 400 Bad Request ve messaging.adaptors.http.flow.DecompressionFailureAtRequest hata koduyla yanıt verir.

   Gerçek istek

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

   İstemci uygulaması tarafından yapılan gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:

   1. Content-Encoding istek başlığına iletilen değeri belirleyin.
   2. İsteğin bir parçası olarak gönderilen yükün biçimini belirleyin.

   3. Content-Encoding üst bilgisinin değeri desteklenen kodlama listesindeyse ancak istek yükünün biçimi Content-Encoding başlığında belirtilen kodlamayla eşleşmiyorsa sorunun nedeni budur.

      Örnek istek:

      curl -v "http://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.zip
      

      Yukarıdaki örnek istek, gzip değerini Apigee Edge'de desteklenen bir kodlama olan Content-Encoding başlığına gönderir. Ancak request_payload.zip istek yükü ZIP biçiminde. Bu nedenle, bu istek bir 400 Bad Request durum kodu ve şu hata koduyla başarısız olur: messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   Mesaj İşleyici günlükleri

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

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

   1. API Monitoring, Trace aracı veya NGINX erişim günlüklerini kullanarak başarısız isteğin mesaj kimliğini Yaygın teşhis adımları bölümünde açıklandığı şekilde belirleyin.

   2. İleti İşleyici günlüğünde ileti kimliğini arayın:

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

   3. Aşağıdaki istisnalardan birini görürsünüz:

      1. Senaryo

      1. Senaryo: API isteği, Content-Encoding: gzip başlığına sahip olduğunda

      2021-07-28 10:21:16,861  NIOThread@0 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-57-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0
      bytesWritten=28764 age=2739893ms  lastIO=0ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      
      2021-07-28 10:21:16,862  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rt-57-1, exception:java.util.zip.ZipException: Not in GZIP format,
      context:Context@71ea5ac input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1
      bytesRead=0 bytesWritten=28764 age=2739894ms  lastIO=0ms  isOpen=true)
      2021-07-28 10:21:16,862  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() :
      Exception java.util.zip.ZipException: Not in GZIP format occurred while writing
      to channel null
      2021-07-28 10:21:16,863  NIOThread@0 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ı, Content-Encoding öğesinin gzip olarak belirtilmesine rağmen istek yükünün GZIP biçiminde gönderilmediğini belirtir. Bu nedenle Apigee Edge bu durumu ortadan kaldırır ve istemci uygulamalarına messaging.adaptors.http.flow.DecompressionFailureAtRequest hata koduna sahip bir 400 durum kodu döndürür.

      2. Senaryo

      2. Senaryo: API isteği Content-Encoding: deflate başlığına sahip olduğunda

      2021-07-28 15:26:31,893  NIOThread@1 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-47875-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.81.72:45954]@29276 useCount=1 bytesRead=0
      bytesWritten=37230 age=3498856ms  lastIO=1ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
                        ….
      Caused by: java.util.zip.DataFormatException: incorrect header check
             ..
      2021-07-28 15:26:31,894  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rrt-47875-1, exception:java.util.zip.ZipException:
      incorrect header check, context:Context@69b3ac45
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276
      useCount=1 byt	esRead=0 bytesWritten=37230 age=3498856ms
      lastIO=1ms  isOpen=true)
      

      Yukarıdaki hata mesajındaki java.util.zip.ZipException: incorrect header check ve Caused by: java.util.zip.DataFormatException: incorrect header check satırları, istek yükünün deflate biçiminde gönderilmediğini ve deflate'in Content-Encoding başlığında belirtilen kodlamayla eşleşmediğini gösterir. Bu nedenle Apigee Edge bu durumu bir kenara koyar ve istemci uygulamalarına messaging.adaptors.http.flow.DecompressionFailureAtRequest hata koduna sahip 400 durum kodu döndürür.

Çözünürlük

1. Apigee Edge'deki API proxy akışında ve arka uç sunucusunda sıkıştırılmış istek yüküne gerek yoksa Content-Encoding başlığını iletin. İstek yükünü sıkıştırmanız gerekiyorsa 2. adıma gidin.
2. İstemci uygulamasının her zaman aşağıdakileri gönderdiğinden emin olun:
   • İstekte Content-Encoding üst bilgisinin değeri olarak desteklenen kodlamalardan herhangi biri
   • Apigee Edge'e desteklenen biçimdeki istek yükü, Content-Encoding başlığında belirtilen kodlama biçimiyle eşleşir
3. Yukarıda açıklanan örnekte, istek yükü ZIP biçimindedir ancak istek başlığı Content-Encoding: gzip değerini belirtir. İstek üst bilgisini Content-Encoding: gzip ve istek yükünü de gzip biçiminde göndererek sorunu düzeltebilirsiniz:

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

Spesifikasyon

Apigee Edge, aşağıdaki RFC özelliklerine göre messaging.adaptors.http.flow.DecompressionFailureAtRequest hata koduyla 400 Bad Request durum koduyla yanıt verir:

Spesifikasyon
RFC 7231, bölüm 6.5.1
RFC 7231, bölüm 3.1.2.2

Apigee Desteği'nden hâlâ yardıma ihtiyacınız varsa Teşhis bilgilerini toplamalısınız başlıklı makaleyi inceleyin.

Teşhis bilgileri toplanmalıdır

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

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

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

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

• Başarısız istekler için gözlemlenen tam hata mesajı
• Ortam adı
• API Proxy paketi
• API istekleri 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# gerçek değerlerle değiştirilir.

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