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

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

ลักษณะปัญหา

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

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

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

HTTP/1.1 502 Bad Gateway

นอกจากนี้ คุณอาจเห็นข้อความแสดงข้อผิดพลาดข้อความใดข้อความหนึ่งต่อไปนี้

{
   "fault":{
      "faultstring":"Received 204 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

{
   "fault":{
      "faultstring":"Received 205 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

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

ข้อผิดพลาดนี้เกิดขึ้นหากการตอบกลับ HTTP จากเซิร์ฟเวอร์แบ็กเอนด์ไปยัง Apigee Edge เป็น 204 No Content หรือ 205 Reset Content แต่มีการตอบกลับเนื้อหา และ/หรือส่วนหัวต่อไปนี้อย่างน้อย 1 รายการ

• Content-Length
• Content-Encoding
• Transfer-Encoding

ตามข้อกำหนด RFC 7231, section 6.3.5: 204 No Content และ RFC 7231, section 6.3.6: 205 Reset Content เซิร์ฟเวอร์ต้นทางไม่ควรส่งเนื้อหาเพิ่มเติม เป็นส่วนหนึ่งของเนื้อหาการตอบกลับที่มีรหัสสถานะ 204 No Content หรือ 205 Reset Content ส่วนหัวการตอบกลับ เช่น Content-Length, Content-Encoding หรือ Transfer-Encoding จะระบุขนาด ประเภท หรือรูปแบบของเนื้อหาการตอบกลับ

ดังนั้น Apigee Edge จะแสดงรหัสสถานะ 502 Bad Gateway พร้อมรหัสข้อผิดพลาด protocol.http.ResponseWithBody ไปยังไคลเอ็นต์ในกรณีต่อไปนี้

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

ขั้นตอนการวินิจฉัยทั่วไป

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

สาเหตุ: เนื้อหาการตอบกลับหรือส่วนหัวที่มีการตอบกลับ 204 จากเซิร์ฟเวอร์แบ็กเอนด์

การวินิจฉัย

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

3. หากต้องการตรวจสอบว่าเซิร์ฟเวอร์แบ็กเอนด์ส่งเนื้อหาเพย์โหลดการตอบกลับและ/หรือส่วนหัวอย่างน้อย 1 รายการที่ระบุไว้ใน สาเหตุที่เป็นไปได้ จริงหรือไม่ ให้ทำตามขั้นตอนต่อไปนี้

   1. หากคุณเป็นผู้ใช้ Public Cloud และสามารถส่งคำขอ API เดียวกันไปยัง เซิร์ฟเวอร์แบ็กเอนด์ได้โดยตรงจากระบบใดระบบหนึ่ง

   2. หากคุณเป็นผู้ใช้ Private Cloud คุณสามารถส่งคำขอ API เดียวกันไปยัง เซิร์ฟเวอร์แบ็กเอนด์ได้โดยตรงจาก Message Processor รายการใดรายการหนึ่งที่เชื่อมโยงกับองค์กรและสภาพแวดล้อมที่เฉพาะเจาะจงซึ่งพบข้อผิดพลาด

   3. ตรวจสอบการตอบกลับที่ได้รับจากเซิร์ฟเวอร์แบ็กเอนด์และยืนยันว่ามีการตอบกลับเพย์โหลดเนื้อหาและ/หรือส่วนหัวอย่างน้อย 1 รายการที่กล่าวถึงข้างต้น หากใช่ แสดงว่านี่คือสาเหตุของข้อผิดพลาดนี้

      ตัวอย่างที่ 1

      ตัวอย่างที่ 1: การตอบกลับ 204 ของเซิร์ฟเวอร์แบ็กเอนด์พร้อมส่วนหัว Content-Encoding

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Encoding: gzip
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      ในตัวอย่างนี้ เซิร์ฟเวอร์แบ็กเอนด์ตอบกลับด้วย 204 No Content รหัสสถานะ และ Content-Encoding: gzip

      ตัวอย่างที่ 2

      ตัวอย่างที่ 2: การตอบกลับ 204 ของเซิร์ฟเวอร์แบ็กเอนด์พร้อมส่วนหัว Content-Length

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Length: 48
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      ในตัวอย่างนี้ เซิร์ฟเวอร์แบ็กเอนด์ตอบกลับด้วย 204 No Content รหัสสถานะ และ Content-Length: 48

      ตัวอย่างที่ 3

      ตัวอย่างที่ 3: การตอบกลับ 205 ของเซิร์ฟเวอร์แบ็กเอนด์พร้อมเนื้อหาการตอบกลับ

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 205 Reset Content
      < Date: Sat, 31 Jul 2021 17:14:09 GMT
      < Content-Length: 12
      < Content-Type: text/plain; charset=utf-8
      <
      * Connection #0 to host X.X.X.X left intact
      This is a sample Response
      

      ในตัวอย่างนี้ เซิร์ฟเวอร์แบ็กเอนด์ตอบกลับด้วย 205 Reset Content รหัสสถานะ พร้อมเนื้อหาการตอบกลับ This is a sample Response.

   4. ในตัวอย่างทั้งหมดข้างต้น เซิร์ฟเวอร์แบ็กเอนด์ส่ง 204 No Content หรือ 205 Reset Content รหัสสถานะพร้อมเนื้อหาการตอบกลับและ/หรือส่วนหัวรายการใดรายการหนึ่งที่ระบุไว้ใน สาเหตุที่เป็นไปได้
   5. ดังนั้น Apigee Edge จึงส่ง 502 Bad Gateway รหัสสถานะพร้อมรหัสข้อผิดพลาด protocol.http.ResponseWithBody

ความละเอียด

ตรวจสอบว่าเซิร์ฟเวอร์แบ็กเอนด์ปฏิบัติตามข้อกำหนด RFC 7231, section 6.3.6: 205 Reset Content เสมอเมื่อส่งการตอบกลับ 204 No Content หรือ 205 Reset Content ไปยัง Apigee Edge นั่นคือ เซิร์ฟเวอร์แบ็กเอนด์ ต้องไม่ ส่งข้อมูลต่อไปนี้เป็นส่วนหนึ่งของการตอบกลับ 204 No Content หรือ 205 Reset Content

1. เนื้อหาเพย์โหลดการตอบกลับ
2. และส่วนหัวต่อไปนี้
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

ข้อมูลจำเพาะ

Apigee Edge จะตอบกลับด้วยรหัสสถานะ 502 Bad Gateway และรหัสข้อผิดพลาด protocol.http.ResponseWithBody หากเซิร์ฟเวอร์แบ็กเอนด์ส่งการตอบกลับ 204 No Content หรือ 205 Reset Content แต่ ไม่ปฏิบัติตามข้อกำหนด RFC ต่อไปนี้

ประเด็นสำคัญที่ควรทราบ

วิธีแก้ปัญหาที่แนะนำคือการแก้ไขเซิร์ฟเวอร์แบ็กเอนด์ให้ส่งรหัสสถานะ 204 No Content และ 205 Reset Content โดยไม่มีเนื้อหาการตอบกลับและส่วนหัว Content-Length, Content-Encoding, และ Transfer-Encoding และปฏิบัติตามข้อกำหนด RFC 7231, section 6.3.5: 204 No Content และ RFC 7231, section 6.3.6: 205 Reset Content

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

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

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

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

• ชื่อองค์กร
• ชื่อสภาพแวดล้อม
• ชื่อพร็อกซี 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