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

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

ลักษณะปัญหา

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

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

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"Body buffer overflow",
      "detail":{
         "errorcode":"protocol.http.TooBigBody"
      }
   }
}

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

ข้อผิดพลาดนี้เกิดขึ้นหากขนาดเพย์โหลดที่ส่งโดยเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ไปยัง Apigee Edge เป็นส่วนหนึ่ง ของการตอบสนอง HTTP มากกว่าขีดจำกัดที่อนุญาตใน Apigee Edge

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

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

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

สาเหตุ: ขนาดเพย์โหลดการตอบกลับเกินขีดจำกัดที่อนุญาต

การวินิจฉัย

1. กำหนดรหัสข้อผิดพลาด แหล่งที่มาของข้อผิดพลาด และขนาดของเพย์โหลดการตอบกลับสำหรับ ข้อผิดพลาดที่พบเมื่อใช้การตรวจสอบ API, เครื่องมือติดตาม หรือบันทึกการเข้าถึง NGINX ตามที่อธิบายไว้ใน ขั้นตอนการวิเคราะห์ทั่วไปจากสถานการณ์ที่ 1
2. หากแหล่งที่มาของข้อผิดพลาดมีค่า target แสดงว่าการตอบสนอง ขนาดเพย์โหลดที่ส่งโดยเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ไปยัง Apigee ใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge
3. ตรวจสอบขนาดเพย์โหลดการตอบกลับตามที่ระบุจากขั้นตอนที่ 1
   • หากขนาดเพย์โหลด > ไฟล์ต้องมีขนาดไม่เกิน 10 MB ดังนี้
   • หากเพย์โหลดมีขนาดไม่เกิน 10 MB ที่อนุญาต ก็เป็นไปได้ว่าการตอบสนอง ระบบจะส่งเพย์โหลดในรูปแบบที่บีบอัด ไปที่ สาเหตุ: ขนาดเพย์โหลดการตอบกลับเกินขีดจำกัดที่อนุญาตหลังจากการยกเลิกการบีบอัด
4. ตรวจสอบว่าขนาดเพย์โหลดการตอบกลับจริง > ไม่เกิน 10 MB โดยตรวจสอบ คำตอบจริงตามขั้นตอนต่อไปนี้
   1. หากคุณไม่มีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ไปที่ความละเอียด
   2. หากคุณมีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ทำตามขั้นตอนต่อไปนี้
      1. หากคุณเป็นผู้ใช้ระบบคลาวด์สาธารณะ/Private Cloud ให้ส่งคำขอโดยตรงไปยัง เซิร์ฟเวอร์แบ็กเอนด์จากเซิร์ฟเวอร์แบ็กเอนด์เองหรือเครื่องอื่นๆ ที่คุณ ได้รับอนุญาตให้ส่งคำขอไปยังเซิร์ฟเวอร์แบ็กเอนด์
      2. หากคุณเป็นผู้ใช้ Private Cloud คุณยังสามารถส่งคำขอไปยัง เซิร์ฟเวอร์ส่วนหลังจากตัวประมวลผลข้อความ
      3. ยืนยันขนาดของเพย์โหลดที่ส่งผ่านในการตอบกลับโดยตรวจสอบ ส่วนหัวความยาวของเนื้อหา
      4. หากคุณพบว่าเพย์โหลดมีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge นั่นเป็นสาเหตุของ ปัญหา

   ตัวอย่างการตอบกลับจากเซิร์ฟเวอร์แบ็กเอนด์

   curl -v https://BACKENDSERVER-HOSTNAME/testfile
   

   * About to connect() to 10.14.0.10 port 9000 (#0)
   *   Trying 10.14.0.10...
   * Connected to 10.14.0.10 (10.148.0.10) port 9000 (#0)
   > GET /testfile HTTP/1.1
   > User-Agent: curl/7.29.0
   > Host: 10.14.0.10:9000
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Length: 11534336
   < Content-Type: application/octet-stream
   < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
   < Date: Wed, 30 Jun 2021 09:22:41 GMT
   <
   ----snipped----
   <Response Body>

   ในตัวอย่างด้านบน คุณจะเห็นว่า Content-Length: 11534336 (which is ~11 MB) ซึ่งเป็นสาเหตุของข้อผิดพลาดนี้เพราะเกิน ขีดจำกัดที่อนุญาตใน Apigee Edge

ความละเอียด

โปรดดูความละเอียด

สาเหตุ: ขนาดเพย์โหลดการตอบกลับเกินขีดจำกัดที่อนุญาตหลังจาก การยกเลิกการบีบอัด

หากส่งเพย์โหลดการตอบกลับในรูปแบบที่บีบอัดและส่วนหัวการตอบกลับ มีการตั้งค่า Content-Encoding เป็น gzip, Apigee จะขยายการตอบสนอง เพย์โหลด ในระหว่างขั้นตอนการยกเลิกการบีบอัด หาก Apigee พบว่าเพย์โหลดมีขนาดใหญ่กว่า เกินขีดจำกัดที่ อนุญาตใน Apigee Edge และจะหยุดต่อไปอีก การยกเลิกการบีบอัด และตอบกลับทันที ด้วย 502 Bad Gateway และรหัสข้อผิดพลาด protocol.http.TooBigBody

การวินิจฉัย

1. กำหนดรหัสข้อผิดพลาด แหล่งที่มาของข้อผิดพลาด และขนาดเพย์โหลดการตอบกลับสำหรับ ข้อผิดพลาดที่พบเมื่อใช้การตรวจสอบ API, เครื่องมือติดตาม หรือบันทึกการเข้าถึง NGINX ตามที่อธิบายไว้ใน ขั้นตอนการวิเคราะห์ทั่วไปจากสถานการณ์ที่ 2
2. หาก Fault Source มีค่า target ก็จะแสดงค่าว่า ขนาดเพย์โหลดการตอบกลับที่ส่งโดยแอปพลิเคชันเป้าหมาย/แบ็กเอนด์ไปยัง Apigee มีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge
3. ตรวจสอบขนาดเพย์โหลดการตอบกลับตามที่ระบุจากขั้นตอนที่ 1
   • หากขนาดเพย์โหลด > ขนาดที่จำกัดไว้ 10 MB นั้นจึงเป็นสาเหตุของข้อผิดพลาด
   • หากเพย์โหลดขนาดไม่เกิน 10 MB ที่อนุญาต อาจเป็นไปได้ว่าเพย์โหลดการตอบกลับ ในรูปแบบที่บีบอัด ในกรณีนี้ ให้ตรวจสอบขนาดที่ไม่มีการบีบอัดของ เพย์โหลดการตอบกลับ
4. คุณตรวจสอบได้ว่ามีการส่งการตอบสนองจากเป้าหมาย/แบ็กเอนด์ในรูปแบบที่บีบอัดหรือไม่ และ ขนาดที่ไม่ได้บีบอัดมีค่าเกินขีดจำกัดที่อนุญาตโดยใช้ค่าใดค่าหนึ่งต่อไปนี้ วิธีการ:

   Trace

   เมื่อใช้เครื่องมือติดตาม ให้ทำดังนี้

   1. หากคุณได้บันทึกการติดตามสำหรับคำขอที่ล้มเหลว โปรดดูขั้นตอนโดยละเอียดใน Traceและ
      1. ระบุค่า target.received.content.length
      2. ตรวจสอบว่าคำขอจากลูกค้ามี การเข้ารหัสเนื้อหา: gzip ส่วนหัว
   2. หากค่าของ target.received.content.length ประมาณ 10 MB ตามที่ได้รับอนุญาต และส่วนหัวการตอบกลับ Content-Encoding: gzip จากนั้นก็จะ สาเหตุของข้อผิดพลาดนี้

   คำขอจริง

   เมื่อใช้คำขอจริง

   1. หากคุณไม่มีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ไปที่ความละเอียด
   2. หากคุณมีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ทำตามขั้นตอนต่อไปนี้
      1. ตรวจสอบขนาดของเพย์โหลดที่ส่งผ่านในการตอบกลับพร้อมกับ ส่งส่วนหัว Content-Encoding ในการตอบกลับแล้ว
      2. ถ้าคุณพบว่ามีการตั้งค่าส่วนหัวการตอบกลับ Content-Encoding เป็น gzip และเพย์โหลดขนาดที่ไม่ได้บีบอัดมีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge นี่จึงเป็นสาเหตุของ ข้อผิดพลาดนี้

         ตัวอย่างการตอบกลับที่ได้รับจากเซิร์ฟเวอร์แบ็กเอนด์

         curl -v https://BACKENDSERVER-HOSTNAME/testzippedfile.gz
         

         * About to connect() to 10.1.0.10 port 9000 (#0)
         *   Trying 10.1.0.10...
         * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
         > GET /testzippedfile.gz HTTP/1.1
         > User-Agent: curl/7.29.0
         > Host: 10.1.0.10:9000
         > Accept: */*
         >
         < HTTP/1.1 200 OK
         < Accept-Ranges: bytes
         < Content-Encoding: gzip
         < Content-Type: application/x-gzip
         < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
         < Testheader: test
         < Date: Wed, 07 Jul 2021 10:14:16 GMT
         < Transfer-Encoding: chunked
         <
         ----snipped----
         <Response Body>

         ในกรณีข้างต้น ส่วนหัว Content-Encoding: gzip จะถูกส่งและ ไฟล์ testzippedfile.gz ในการตอบกลับมีขนาดไฟล์น้อยกว่า ขนาดสูงสุด แต่ขนาดของไฟล์ testzippedfile ที่ไม่ได้บีบอัดคือ ~15 MB

   บันทึกของผู้ประมวลผลข้อความ

   การใช้บันทึกโปรแกรมประมวลผลข้อความมีดังนี้

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

   2. ตรวจสอบบันทึกสำหรับโปรแกรมประมวลผลข้อความ

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

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

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. คุณจะเห็นเส้นทางจาก system.log ที่คล้ายกับดังที่แสดงด้านล่าง (TotalRead และ chunkCount อาจแตกต่างกันไปในกรณีของคุณ):

      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.SERVICE -
      TrackingInputChannel.checkMessageBodyTooLarge() : Message is too large.
      TotalRead 10489856 chunkCount 2571
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :
      ClientInputChannel(ClientChannel[Connected:
      Remote:10.148.0.10:9000 Local:10.148.0.9:42240]@9155
      useCount=1 bytesRead=0 bytesWritten=182 age=23ms  lastIO=0ms
      isOpen=true).onExceptionRead exception: {}
      com.apigee.errors.http.server.BadGateway: Body buffer overflow
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR
      ADAPTORS.HTTP.FLOW - AbstractResponseListener.onException() :
      AbstractResponseListener.onError(HTTPResponse@77cbd7c4,
      Body buffer overflow)

   5. ในระหว่างขั้นตอนการยกเลิกการบีบอัด ทันทีที่เครื่องมือประมวลผลข้อความระบุ ไบต์ที่อ่านทั้งหมดคือ > ขนาด 10 MB กล้องจะหยุดและพิมพ์บรรทัดต่อไปนี้

      Message is too large. TotalRead 10489856 chunkCount 2571

      แสดงว่าขนาดเพย์โหลดการตอบกลับมากกว่า 10 MB และ Apigee แสดงข้อผิดพลาดเมื่อขนาดเริ่มเกินขีดจำกัด 10 MB โดยมีรหัสข้อผิดพลาดเป็น protocol.http.TooBigBody

ความละเอียด

จำกัดสูงสุด

Apigee คาดว่าแอปพลิเคชันไคลเอ็นต์และเซิร์ฟเวอร์แบ็กเอนด์จะไม่ส่งเพย์โหลดที่มีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตสำหรับ Request/response size ใน ขีดจำกัด Apigee Edge

1. หากคุณเป็นผู้ใช้ระบบคลาวด์สาธารณะ ขีดจำกัดสูงสุดสำหรับคำขอและการตอบกลับ ขนาดเพย์โหลดที่บันทึกไว้สำหรับ Request/response size ใน ขีดจำกัด Apigee Edge
2. หากคุณเป็นผู้ใช้ Private Cloud คุณอาจได้แก้ไขขีดจำกัดสูงสุดเริ่มต้น ขีดจำกัดสำหรับขนาดเพย์โหลดคำขอและการตอบกลับ (แม้ว่าจะไม่ใช่แนวทางปฏิบัติที่แนะนำก็ตาม) คุณกำหนดขีดจำกัดขนาดเพย์โหลดคำขอสูงสุดได้โดยทำตามวิธีการใน วิธีตรวจสอบขีดจำกัดปัจจุบัน

วิธีตรวจสอบขีดจำกัดปัจจุบัน

ส่วนนี้อธิบายวิธียืนยันพร็อพเพอร์ตี้ อัปเดต HTTPResponse.body.buffer.limit ด้วยค่าใหม่ในข้อความแล้ว ผู้ประมวลผลข้อมูล

1. ค้นหาคุณสมบัติในเครื่องประมวลผลข้อความ HTTPResponse.body.buffer.limit ในไดเรกทอรี /opt/apigee/edge-message- processor/conf แล้วตรวจสอบว่าได้ตั้งค่าให้กับค่าใดบ้างดังที่แสดงด้านล่าง

   grep -ri "HTTPResponse.body.buffer.limit" /opt/apigee/edge-message-processor/conf
   

2. ตัวอย่างผลลัพธ์จากคำสั่งด้านบนมีดังนี้

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.body.buffer.limit=10m

3. ในตัวอย่างเอาต์พุตด้านบน จะเห็นว่าพร็อพเพอร์ตี้ มีการตั้งค่า HTTPResponse.body.buffer.limit ด้วยค่า 10m ใน http.properties

   ค่านี้ระบุว่าขีดจำกัดสำหรับขนาดเพย์โหลดคำขอที่กำหนดค่าใน Apigee สำหรับ Private Cloud มีขนาด 10 MB

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

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

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

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

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

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

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

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

  ที่ไหน: ORG, ENV และ PORT# จะถูกแทนที่ด้วย มูลค่าจริง

• บันทึกระบบของผู้ประมวลผลข้อความ /opt/apigee/var/log/edge-message-processor/logs/system.log