431 ช่องส่วนหัวของคําขอใหญ่เกินไป - TooBigHeaders

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

ลักษณะปัญหา

แอปพลิเคชันไคลเอ็นต์ได้รับรหัสสถานะ HTTP 431 Request Header Fields Too Large พร้อมรหัสข้อผิดพลาด protocol.http.TooBigHeaders เป็นการตอบกลับสำหรับการเรียก API

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

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

HTTP/1.1 431 Request Header Fields Too Large

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

{
   "fault":{
      "faultstring":"request headers size exceeding 25,600",
      "detail":{
         "errorcode":"protocol.http.TooBigHeaders"
      }
   }
}

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

ข้อผิดพลาดนี้เกิดขึ้นหากขนาดรวมของส่วนหัวของคำขอทั้งหมดที่แอปพลิเคชันไคลเอ็นต์ส่งไปยัง Apigee Edge ซึ่งเป็นส่วนหนึ่งของคำขอ HTTP มีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge ตาม RFC 6585, section 5: 431 Request Header Fields Too Large

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

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

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

สาเหตุ: ขนาดส่วนหัวของคำขอใหญ่กว่าขีดจำกัดที่อนุญาต

การวินิจฉัย

1. กำหนด Fault Code แหล่งที่มาของข้อผิดพลาด และขนาดความยาวของคำขอ สำหรับ ข้อผิดพลาดที่พบโดยใช้ API Monitoring หรือบันทึกการเข้าถึง NGINX ตามที่อธิบายไว้ใน ขั้นตอนการวินิจฉัยที่พบบ่อย
2. หากแหล่งที่มาของข้อผิดพลาด มีค่าเป็น apigee หรือ MP, Fault Code มีค่าเป็น protocol.http.TooBigHeaders, และความยาวของคำขอ มากกว่า 25 KB แสดงว่า ขนาดคำขอที่แอปพลิเคชันไคลเอ็นต์ส่งไปยัง Apigee มีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge
3. คุณสามารถตรวจสอบว่าขนาดส่วนหัวของคำขอเกินขีดจำกัดที่อนุญาต 25 KB โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้

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

   วิธีตรวจสอบความถูกต้องโดยใช้ข้อความแสดงข้อผิดพลาด

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

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

   "faultstring":"request headers size exceeding 25,600"

   คำขอจริง

   วิธีตรวจสอบความถูกต้องโดยใช้คำขอจริง

   หากคุณมีสิทธิ์เข้าถึงคำขอจริงที่แอปพลิเคชันไคลเอ็นต์ส่ง ให้ทำตามขั้นตอนต่อไปนี้

   1. ตรวจสอบขนาดของส่วนหัวที่ส่งในคำขอ

   2. หากพบว่าขนาดรวมของส่วนหัวมีขนาดใหญ่กว่า ขีดจำกัดที่อนุญาตใน Apigee Edge แสดงว่าส่วนหัวดังกล่าวเป็น สาเหตุของปัญหา

      ตัวอย่างคำขอ:

      curl -v https://HOSTALIAS/test -H "header0: 000000000000000000……..000000<trimmed>" -H "header1: 111111111111111111……..111111<trimmed>" -H "header2: 222222222222222222……..222222<trimmed>"-H "header3: 333333333333333333……..333333<trimmed>"
      

      ในกรณีข้างต้น ขนาดรวมของส่วนหัว header0, header1, header2, และ header3 มีขนาดใหญ่กว่า 25 KB ซึ่งหมายความว่ามี อักขระ ASCII (ไบต์) มากกว่า 25,000 ตัว

      หากคุณใช้ไคลเอ็นต์อื่น ให้ตรวจสอบบันทึกของไคลเอ็นต์และ ลองดูขนาดของบรรทัดคำขอที่ส่งไปยัง Apigee Edge

   บันทึกของ Message Processor

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

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

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

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

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

      grep -ri "exceeding"
      

      grep -ri "RequestHeadersTooLarge"
      

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

      2021-07-27 08:30:28,419  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() :
      Request:GET, uri:/test/, message Id:null,
      exception:com.apigee.errors.http.user.RequestHeadersTooLarge{
      code = protocol.http.TooBigHeaders, message = request headers size
      exceeding 25,600, associated contexts = []}, context:Context@9c5903
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.205.251:8443 Local:192.168.67.23:22188]@25130
      useCount=1 bytesRead=0 bytesWritten=15367 age=667062ms  lastIO=0ms
      isOpen=true)

      ข้อความ message = request headers size exceeding 25,600 ในข้อความแสดงข้อผิดพลาดข้างต้นระบุว่าขนาดรวมของส่วนหัวของคำขอมีขนาดมากกว่า 25 KB ดังนั้น Apigee Edge จะแสดงข้อยกเว้น com.apigee.errors.http.user.RequestHeadersTooLarge และแสดงรหัสสถานะ 431 พร้อม Fault Code protocol.http.TooBigHeaders ไปยังแอปพลิเคชันไคลเอ็นต์

ความละเอียด

จำกัดสูงสุด

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

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

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

ส่วนนี้อธิบายวิธีตรวจสอบว่าพร็อพเพอร์ตี้ HTTPRequest.headers.limit ได้รับการอัปเดตด้วยค่าใหม่ใน Message Processor แล้ว

1. ในเครื่อง Message Processor ให้ค้นหาพร็อพเพอร์ตี้ HTTPRequest.headers.limit ใน /opt/apigee/edge-message-processor/conf ไดเรกทอรี และตรวจสอบว่ามีการตั้งค่าใดไว้ ดังที่แสดงด้านล่าง

   grep -ri "HTTPRequest.headers.limit" /opt/apigee/edge-message-processor/conf
   

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

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.headers.limit=25k

3. ในเอาต์พุตตัวอย่างข้างต้น โปรดทราบว่าพร็อพเพอร์ตี้ HTTPRequest.headers.limit ได้รับการตั้งค่าด้วยค่า 25k ใน http.properties

   ซึ่งแสดงว่าขีดจำกัดสำหรับขนาดส่วนหัวของคำขอที่กำหนดค่าไว้ใน Apigee สำหรับ Private Cloud คือ 25 KB

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

Apigee Edge คาดหวังว่าแอปพลิเคชันไคลเอ็นต์จะไม่ส่งส่วนหัวที่มีขนาดใหญ่เป็นส่วนหนึ่งของ คำขอ ในกรณีที่คำขอมีส่วนหัวที่มีขนาดรวมมากกว่าขีดจำกัดที่ระบุ Apigee จะแสดง 431 Request Header Fields Too Large ตามข้อกำหนด RFC ต่อไปนี้

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

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

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

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

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

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

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

• บันทึกการเข้าถึง 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