502 เกตเวย์ไม่ถูกต้อง - DecompressionFailureAtResponse

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ลักษณะปัญหา

แอปพลิเคชันไคลเอ็นต์จะได้รับรหัสสถานะ HTTP 502 Bad Gateway พร้อมรหัสข้อผิดพลาด messaging.adaptors.http.flow.DecompressionFailureAtResponse เป็นการตอบกลับการเรียก API

ข้อความแสดงข้อผิดพลาด

แอปพลิเคชันไคลเอ็นต์จะได้รับโค้ดตอบกลับต่อไปนี้

HTTP/1.1 502 Bad Gateway

นอกจากนี้ คุณอาจเห็นข้อความแสดงข้อผิดพลาดที่คล้ายกับข้อความที่แสดงด้านล่าง

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

สาเหตุที่เป็นไปได้

ข้อผิดพลาดนี้จะเกิดขึ้นในกรณีต่อไปนี้เท่านั้น

• การเข้ารหัสที่ระบุในส่วนหัวการตอบกลับ HTTP (จากเซิร์ฟเวอร์แบ็กเอนด์/เป้าหมาย) Content-Encoding ใช้ได้และ รองรับโดย Apigee Edge

แต่

• รูปแบบเพย์โหลดที่แบ็กเอนด์/เซิร์ฟเวอร์เป้าหมายส่งเป็นส่วนหนึ่งของการตอบกลับ HTTP ไม่ตรงกับ รูปแบบการเข้ารหัสที่ระบุในส่วนหัว Content-Encoding

เนื่องจาก Apigee Edge ถอดรหัสเพย์โหลดโดยใช้การเข้ารหัสที่ระบุไม่สำเร็จ เนื่องจากรูปแบบของเพย์โหลดไม่ได้อยู่ในรูปแบบเดียวกับการเข้ารหัสที่ระบุในส่วนหัว Content-Encoding

ต่อไปนี้คือตัวอย่างค่า Content-Encodingที่รองรับและวิธีที่ Apigee Edge คาดหวังว่าการแสดงเพย์โหลดจะเป็นในกรณีเหล่านั้น

สาเหตุที่เป็นไปได้ของข้อผิดพลาดนี้มีดังนี้

ขั้นตอนการวินิจฉัยที่พบบ่อย

ใช้เครื่องมือ/เทคนิคอย่างใดอย่างหนึ่งต่อไปนี้เพื่อวินิจฉัยข้อผิดพลาดนี้

สาเหตุ: รูปแบบเพย์โหลดการตอบกลับไม่ตรงกับ Content-Encoding

โดยค่าเริ่มต้น Apigee Edge จะคลายการบีบอัดเพย์โหลดเสมอหากส่วนหัวการตอบกลับ Content-Encoding มี การเข้ารหัสที่รองรับที่ถูกต้อง ดังนั้น คาดว่ารูปแบบของเพย์โหลดการตอบกลับ ควรตรงกันกับการเข้ารหัสที่ระบุในส่วนหัวการตอบกลับ Content-Encoding หากข้อมูลไม่ตรงกัน คุณจะได้รับข้อผิดพลาดนี้

การวินิจฉัย

1. ระบุรหัสข้อผิดพลาดและแหล่งที่มาของข้อผิดพลาดสำหรับข้อผิดพลาดที่สังเกตได้โดยใช้ API การตรวจสอบ เครื่องมือติดตาม หรือบันทึกการเข้าถึง NGINX ตามที่อธิบายไว้ใน ขั้นตอนการวินิจฉัยทั่วไป
2. หากรหัสข้อผิดพลาดคือ messaging.adaptors.http.flow.DecompressionFailureAtResponse และแหล่งที่มาของข้อผิดพลาดมีค่าเป็น target แสดงว่า รูปแบบของเพย์โหลดการตอบกลับที่ส่งโดยเซิร์ฟเวอร์แบ็กเอนด์/เป้าหมายไม่ตรงกับ การเข้ารหัสที่รองรับที่ระบุในส่วนหัวการตอบกลับ Content-Encoding

3. คุณสามารถระบุความไม่ตรงกันเป็นส่วนหนึ่งของการตอบกลับ HTTP โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

   ข้อความแสดงข้อผิดพลาด

   วิธียืนยันโดยใช้ข้อความแสดงข้อผิดพลาด

   1. หากคุณมีสิทธิ์เข้าถึงข้อความแสดงข้อผิดพลาดทั้งหมดที่ได้รับจาก Apigee Edge ให้ ดูfaultstring

      ตัวอย่างข้อความแสดงข้อผิดพลาด:

      "faultstring":"Decompression failure at response"

   2. ในข้อความแสดงข้อผิดพลาดข้างต้น จะแสดง "Decompression failure at response" ซึ่งหมายความว่าการตอบกลับ ไม่สามารถคลายการบีบอัดโดยใช้การเข้ารหัสที่ระบุในส่วนหัว Content-Encoding

   Trace

   วิธีตรวจสอบโดยใช้การติดตาม

   1. กำหนด Content-Type และ error.cause โดยใช้การติดตาม ตามที่อธิบายไว้ในขั้นตอนการวินิจฉัยทั่วไป

   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

   บันทึกของ Message Processor

   วิธีตรวจสอบความถูกต้องโดยใช้บันทึกของ Message Processor

   หากเป็นผู้ใช้ Private Cloud คุณจะใช้บันทึกของ Message Processor เพื่อระบุข้อมูลสำคัญเกี่ยวกับข้อผิดพลาดของ HTTP 502 ได้

   1. ตรวจสอบบันทึกของ Message Processor

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

   2. ค้นหาเพื่อดูว่ามี502ข้อผิดพลาดในระยะเวลาที่เฉพาะเจาะจงหรือไม่ (หากปัญหาเกิดขึ้นในอดีต) หรือมีคำตอบที่ยังคงล้มเหลวด้วย 502หรือไม่ คุณอาจใช้สตริงการค้นหาต่อไปนี้

      grep -ri "ZipException"
      

   3. คุณจะเห็นบรรทัดจาก system.log ที่คล้ายกับบรรทัดต่อไปนี้

      สถานการณ์ที่ 1

      สถานการณ์ที่ 1: เมื่อการตอบกลับของ API มีส่วนหัว 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 ไปยังแอปพลิเคชันไคลเอ็นต์

      สถานการณ์ที่ 2

      สถานการณ์ #2: เมื่อการตอบกลับของ API มีส่วนหัว 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 ในข้อความแสดงข้อผิดพลาดข้างต้นบ่งชี้ว่าไม่ได้ส่งเพย์โหลดการตอบกลับใน รูปแบบ Deflate และไม่ตรงกับการเข้ารหัสที่ระบุใน ส่วนหัว Content-Encoding ของ Deflate ดังนั้น Apigee Edge จึงทิ้งข้อยกเว้นและแสดงรหัสสถานะ 502 พร้อม รหัสข้อผิดพลาด messaging.adaptors.http.flow.DecompressionFailureAtResponse ไปยังแอปพลิเคชันไคลเอ็นต์

ความละเอียด

1. หากไม่จำเป็นต้องใช้เพย์โหลดการตอบกลับที่บีบอัดในโฟลว์พร็อกซี API ใน Apigee Edge และในเซิร์ฟเวอร์แบ็กเอนด์ ให้อย่าส่งส่วนหัว Content-Encoding หากจำเป็นต้องบีบอัดเพย์โหลดการตอบกลับ ให้ไปที่ขั้นตอนที่ 2
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 ตามข้อกำหนด RFC ต่อไปนี้

หากยังต้องการความช่วยเหลือจากทีมสนับสนุนของ Apigee โปรดไปที่ ต้องรวบรวมข้อมูลการวินิจฉัย

ต้องรวบรวมข้อมูลการวินิจฉัย

รวบรวมข้อมูลการวินิจฉัยต่อไปนี้ แล้วติดต่อทีมสนับสนุน Apigee Edge

หากคุณเป็นผู้ใช้ระบบคลาวด์สาธารณะ โปรดระบุข้อมูลต่อไปนี้

• ชื่อองค์กร
• ชื่อสภาพแวดล้อม
• ชื่อพร็อกซี API
• คำสั่ง curl ที่สมบูรณ์ซึ่งใช้ในการสร้างข้อผิดพลาด 502 ซ้ำ
• ไฟล์การติดตามสำหรับการตอบกลับจาก API

หากคุณเป็นผู้ใช้ Private Cloud โปรดระบุข้อมูลต่อไปนี้

• ข้อความแสดงข้อผิดพลาดทั้งหมดที่พบสำหรับการตอบกลับที่ไม่สำเร็จ
• ชื่อสภาพแวดล้อม
• แพ็กเกจพร็อกซี API
• ไฟล์การติดตามสำหรับการตอบกลับจาก API

• บันทึกการเข้าถึง NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  โดยที่ ORG, ENV และ PORT# จะแทนที่ด้วย ค่าจริง

• บันทึกของระบบ Message Processor /opt/apigee/var/log/edge-message-processor/logs/system.log