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

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

ลักษณะปัญหา

แอปพลิเคชันไคลเอ็นต์จะได้รับรหัสสถานะ 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. ยืนยันขนาด Payload ของการตอบกลับตามที่กำหนดจากขั้นตอนที่ 1
   • หากขนาดเพย์โหลด > ขีดจำกัดที่อนุญาต 10 MB แสดงว่านั่นคือสาเหตุของข้อผิดพลาด
   • หากขนาดเพย์โหลดมีขนาดประมาณ 10 MB ตามขีดจำกัดที่อนุญาต แสดงว่าอาจมีการส่งเพย์โหลดการตอบกลับในรูปแบบที่บีบอัด ไปที่ สาเหตุ: เพย์โหลดการตอบกลับมีขนาดเกินขีดจำกัดที่อนุญาตหลังจากคลายการบีบอัด
4. ตรวจสอบว่าขนาดเพย์โหลดการตอบกลับมีขนาด > 10 MB ตามขีดจำกัดที่อนุญาตจริงโดยทำตามขั้นตอนต่อไปนี้เพื่อตรวจสอบการตอบกลับจริง
   1. หากคุณไม่มีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ไปที่การแก้ปัญหา
   2. หากคุณมีสิทธิ์เข้าถึงคำขอจริงที่ส่งไปยังเซิร์ฟเวอร์เป้าหมาย/แบ็กเอนด์ ให้ทำตามขั้นตอนต่อไปนี้
      1. หากคุณเป็นผู้ใช้ระบบคลาวด์สาธารณะ/ระบบคลาวด์ส่วนตัว ให้ส่งคำขอไปยัง เซิร์ฟเวอร์แบ็กเอนด์โดยตรงจากเซิร์ฟเวอร์แบ็กเอนด์เองหรือเครื่องอื่นๆ ที่คุณ ได้รับอนุญาตให้ส่งคำขอไปยังเซิร์ฟเวอร์แบ็กเอนด์
      2. หากเป็นผู้ใช้ Private Cloud คุณยังส่งคำขอไปยังเซิร์ฟเวอร์แบ็กเอนด์จากตัวประมวลผลข้อความตัวใดตัวหนึ่งได้ด้วย
      3. ตรวจสอบขนาดของเพย์โหลดที่ส่งในการตอบกลับโดยดูที่ ส่วนหัว Content-Length
      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. ยืนยันขนาด Payload ของการตอบกลับตามที่กำหนดจากขั้นตอนที่ 1
   • หากขนาดเพย์โหลด > ขีดจำกัดที่อนุญาต 10 MB แสดงว่านั่นคือสาเหตุของข้อผิดพลาด
   • หากขนาดเพย์โหลดเป็นไปตามขีดจำกัดที่อนุญาตประมาณ 10 MB แสดงว่าเพย์โหลดการตอบกลับอาจ ส่งในรูปแบบที่บีบอัด ในกรณีนี้ ให้ตรวจสอบขนาดที่ไม่ได้บีบอัดของเพย์โหลดการตอบกลับที่บีบอัด แล้ว
4. คุณสามารถตรวจสอบว่าการตอบกลับจากเป้าหมาย/แบ็กเอนด์ถูกส่งในรูปแบบที่บีบอัดหรือไม่ และ ขนาดที่ไม่ได้บีบอัดมีขนาดใหญ่กว่าขีดจำกัดที่อนุญาตหรือไม่ โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

   Trace

   การใช้เครื่องมือติดตาม:

   1. หากคุณบันทึกการติดตามสำหรับคำขอที่ไม่สำเร็จ โปรดดูขั้นตอนโดยละเอียดใน Trace และ
      1. กำหนดค่าของ target.received.content.length
      2. ตรวจสอบว่าคำขอจากไคลเอ็นต์มีส่วนหัว Content-Encoding: 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

   บันทึกของ Message Processor

   การใช้บันทึกของ Message Processor

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

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

      /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. ในระหว่างกระบวนการคลายการบีบอัด ทันทีที่ Message Processor ระบุว่าไบต์ที่อ่านทั้งหมดมีค่ามากกว่า 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. ในเครื่อง Message Processor ให้ค้นหาพร็อพเพอร์ตี้ 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# จะแทนที่ด้วย ค่าจริง

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