400 Permintaan Buruk - DekompresiFailureAtRequest

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Gejala

Aplikasi klien mendapatkan kode status HTTP 400 Bad Request dengan kode error messaging.adaptors.http.flow.DecompressionFailureAtRequest sebagai respons terhadap panggilan API.

Pesan error

Aplikasi klien mendapatkan kode respons berikut:

HTTP/1.1 400 Bad Request

Selain itu, Anda mungkin melihat pesan error yang mirip dengan yang ditunjukkan di bawah ini:

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

Kemungkinan penyebab

Error ini hanya terjadi jika:

• Encoding yang ditentukan di header permintaan HTTP Content-Encoding valid dan didukung oleh Apigee Edge,

TETAPI

• Format payload yang dikirim oleh klien sebagai bagian dari permintaan HTTP tidak cocok dengan format encoding yang ditentukan di header Content-Encoding

Hal ini karena Apigee Edge gagal mendekode payload menggunakan encoding yang ditentukan karena format payload tidak sama dengan format encoding yang ditentukan di header Content-Encoding.

Berikut beberapa contoh nilai Content-Encoding yang didukung dan cara Apigee Edge mengharapkan format payload dalam kasus tersebut:

Kemungkinan penyebab error ini adalah sebagai berikut:

Langkah-langkah diagnosis umum

Gunakan salah satu alat/teknik berikut untuk mendiagnosis error ini:

Penyebab: Format payload permintaan tidak cocok dengan encoding yang ditentukan di header Content-Encoding

Secara default, Apigee Edge selalu mendekompresi payload jika header permintaan Content-Encoding berisi encoding yang valid dan didukung. Oleh karena itu, format payload permintaan diharapkan cocok dengan encoding yang ditentukan di header permintaan Content-Encoding. Jika ada ketidakcocokan, Anda akan mendapatkan error ini.

Diagnosis

1. Tentukan Kode Kesalahan dan Sumber Kesalahan untuk error yang diamati menggunakan Pemantauan API, alat Trace, atau log akses NGINX seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.
2. Jika Kode Error adalah messaging.adaptors.http.flow.DecompressionFailureAtRequest dan Sumber Error memiliki nilai policy atau proxy, maka hal ini menunjukkan bahwa permintaan yang dikirim oleh aplikasi klien memiliki payload yang tidak cocok dengan encoding yang didukung yang ditentukan di header permintaan Content-Encoding.

3. Anda dapat menentukan ketidakcocokan sebagai bagian dari permintaan HTTP menggunakan salah satu metode berikut:

   Pesan error

   Untuk memvalidasi menggunakan pesan error:

   1. Jika Anda memiliki akses ke pesan error lengkap yang diterima dari Apigee Edge, maka lihat faultstring.

      Contoh pesan error:

      "faultstring":"Decompression failure at request"

   2. Dalam pesan error di atas, ditampilkan "Decompression failure at request" yang menyiratkan bahwa permintaan tidak dapat didekompresi menggunakan encoding yang ditentukan dalam header Content-Encoding.

   Trace

   Untuk memvalidasi menggunakan Trace:

   1. Tentukan nilai header permintaan Content-Encoding dan properti error.cause menggunakan Trace seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.

   2. Nilai dari rekaman aktivitas sampel adalah sebagai berikut:

      • Content-Encoding: gzip
      • error.cause: Not in GZIP format

      Nilai di header permintaan Content-Encoding adalah gzip; namun, payload permintaan tidak dalam format GZIP (seperti yang ditunjukkan oleh error.cause). Oleh karena itu, Apigee Edge merespons dengan 400 Bad Request dan kode error messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   Permintaan sebenarnya

   Untuk memvalidasi menggunakan permintaan sebenarnya:

   Jika Anda memiliki akses ke permintaan sebenarnya yang dibuat oleh aplikasi klien, lakukan langkah-langkah berikut:

   1. Tentukan nilai yang diteruskan ke header permintaan Content-Encoding.
   2. Tentukan format payload yang dikirim sebagai bagian dari permintaan.

   3. Jika nilai header Content-Encoding ada dalam daftar encoding yang didukung, tetapi format payload permintaan tidak cocok dengan encoding yang ditentukan di header Content-Encoding, maka itulah penyebab masalahnya.

      Contoh permintaan:

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

      Contoh permintaan di atas mengirimkan nilai gzip ke header Content-Encoding yang merupakan encoding yang didukung di Apigee Edge. Namun, payload permintaan request_payload.zip dalam format ZIP. Oleh karena itu, permintaan ini gagal dengan kode status 400 Bad Request dan kode error: messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   Log Message Processor

   Untuk memvalidasi menggunakan log Message Processor:

   Jika Anda adalah pengguna Private Cloud, Anda dapat menggunakan log Message Processor untuk menentukan informasi utama tentang error HTTP 400.

   1. Tentukan ID pesan permintaan yang gagal menggunakan Pemantauan API, alat Trace, atau log akses NGINX seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.

   2. Telusuri ID pesan di log Message Processor:

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

   3. Anda akan melihat salah satu pengecualian berikut:

      Skenario #1

      Skenario #1: Saat permintaan API memiliki header Content-Encoding: gzip

      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
      

      Baris java.util.zip.ZipException: Not in GZIP format dalam pesan error di atas menunjukkan bahwa payload permintaan tidak dikirim dalam format GZIP meskipun Content-Encoding ditentukan sebagai gzip. Oleh karena itu, Apigee Edge akan memunculkan pengecualian dan menampilkan kode status 400 dengan kode kesalahan messaging.adaptors.http.flow.DecompressionFailureAtRequest ke aplikasi klien.

      Skenario #2

      Skenario #2: Saat permintaan API memiliki header Content-Encoding: deflate

      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)
      

      Baris java.util.zip.ZipException: incorrect header check dan Caused by: java.util.zip.DataFormatException: incorrect header check dalam pesan error di atas menunjukkan bahwa payload permintaan tidak dikirim dalam format deflate dan tidak cocok dengan encoding yang ditentukan dalam header Content-Encoding deflate. Oleh karena itu, Apigee Edge akan memunculkan pengecualian dan menampilkan kode status 400 dengan kode kesalahan messaging.adaptors.http.flow.DecompressionFailureAtRequest ke aplikasi klien.

Resolusi

1. Jika tidak ada kebutuhan untuk payload permintaan terkompresi dalam alur proxy API di Apigee Edge dan di server backend, maka jangan teruskan header Content-Encoding. Jika ada kebutuhan untuk mengompresi payload permintaan, lanjutkan ke langkah 2.
2. Pastikan aplikasi klien selalu mengirimkan hal berikut:
   • Salah satu encoding yang didukung sebagai nilai untuk header Content-Encoding dalam permintaan
   • Payload permintaan dalam format yang didukung ke Apigee Edge cocok dengan format encoding yang ditentukan di header Content-Encoding
3. Dalam contoh yang dibahas di atas, payload permintaan dalam format ZIP, tetapi header permintaan menentukan Content-Encoding: gzip. Anda dapat memperbaiki masalah ini dengan mengirimkan header permintaan sebagai Content-Encoding: gzip dan payload permintaan juga dalam format gzip:

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

Spesifikasi

Apigee Edge merespons dengan kode status 400 Bad Request dengan kode error messaging.adaptors.http.flow.DecompressionFailureAtRequest sesuai dengan spesifikasi RFC berikut:

Jika Anda masih memerlukan bantuan dari Dukungan Apigee, buka Mengumpulkan informasi diagnostik.

Harus mengumpulkan informasi diagnostik

Kumpulkan informasi diagnostik berikut, lalu hubungi Dukungan Apigee Edge:

Jika Anda adalah pengguna Cloud Publik, berikan informasi berikut:

• Nama organisasi
• Nama lingkungan
• Nama Proxy API
• Perintah curl lengkap yang digunakan untuk memunculkan kembali error 400
• File rekaman aktivitas untuk permintaan API

Jika Anda adalah pengguna Private Cloud, berikan informasi berikut:

• Pesan error lengkap yang diamati untuk permintaan yang gagal
• Nama lingkungan
• Paket Proxy API
• File rekaman aktivitas untuk permintaan API

• Log akses NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Tempat: ORG, ENV, dan PORT# diganti dengan nilai sebenarnya.

• Log sistem Message Processor /opt/apigee/var/log/edge-message-processor/logs/system.log