502 مدخل غير صالح - OverBigBody

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

المشكلة

يتلقّى تطبيق العميل رمز حالة HTTP 502 Bad Gateway مع رمز الخطأ protocol.http.TooBigBody كردّ على طلبات البيانات من واجهة برمجة التطبيقات.

رسالة الخطأ

يتلقّى تطبيق العميل رمز الاستجابة التالي:

HTTP/1.1 502 Bad Gateway

بالإضافة إلى ذلك، قد تظهر لك رسالة الخطأ التالية:

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

الأسباب المحتملة

يحدث هذا الخطأ إذا كان حجم الحمولة التي يرسلها الخادم المستهدف/الخادم الخلفي إلى Apigee Edge كجزء من استجابة HTTP أكبر من الحدّ المسموح به في Apigee Edge.

في ما يلي الأسباب المحتملة لظهور هذا الخطأ:

خطوات التشخيص الشائعة

استخدِم إحدى الأدوات أو التقنيات التالية لتشخيص هذا الخطأ:

السبب: حجم حمولة الرد أكبر من الحدّ المسموح به

التشخيص

1. حدِّد رمز الخطأ ومصدر الخطأ وحجم حمولة الاستجابة للخطأ الذي تم رصده باستخدام "مراقبة واجهة برمجة التطبيقات" أو أداة Trace أو سجلات الوصول إلى NGINX كما هو موضّح في خطوات التشخيص الشائعة في السيناريو رقم 1.
2. إذا كانت قيمة "مصدر الخطأ" هي target، يشير ذلك إلى أنّ حجم حمولة الاستجابة التي أرسلها الخادم المستهدف/الخادم الخلفي إلى Apigee أكبر من الحدّ المسموح به في Apigee Edge.
3. تحقَّق من حجم حمولة الردّ كما هو محدّد في الخطوة 1.
   • إذا كان حجم الحمولة أكبر من الحدّ المسموح به وهو 10 ميغابايت، سيكون هذا هو سبب الخطأ.
   • إذا كان حجم الحمولة يبلغ حوالي 10 ميغابايت، وهو الحدّ المسموح به، فمن المحتمل أن يتم تمرير حمولة الرد بتنسيق مضغوط. انتقِل إلى السبب: يتجاوز حجم حمولة الرد الحدّ المسموح به بعد فك الضغط.
4. تأكَّد من أنّ حجم حمولة الاستجابة أكبر من الحدّ المسموح به وهو 10 ميغابايت من خلال التحقّق من الاستجابة الفعلية باتّباع الخطوات التالية:
   1. إذا لم يكن بإمكانك الوصول إلى الطلب الفعلي المقدَّم إلى الخادم المستهدف أو خادم الخلفية، انتقِل إلى الحل.
   2. إذا كان بإمكانك الوصول إلى الطلب الفعلي المقدَّم إلى الخادم المستهدف أو خادم الخلفية، اتّبِع الخطوات التالية:
      1. إذا كنت مستخدمًا للسحابة الإلكترونية العامة أو الخاصة، يمكنك تقديم طلب مباشرةً إلى خادم الخلفية من خادم الخلفية نفسه أو أي جهاز آخر يُسمح لك من خلاله بتقديم الطلب إلى خادم الخلفية.
      2. إذا كنت مستخدمًا للسحابة الإلكترونية الخاصة، يمكنك أيضًا إرسال الطلب إلى خادم الخلفية من أحد معالجات الرسائل.
      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. حدِّد رمز الخطأ ومصدر الخطأ وحجم حمولة الاستجابة للخطأ الذي تم رصده باستخدام "مراقبة واجهة برمجة التطبيقات" أو "أداة التتبُّع" أو سجلّات الوصول إلى NGINX كما هو موضّح في خطوات التشخيص الشائعة مع السيناريو رقم 2.
2. إذا كانت قيمة مصدر الخطأ هي target، يشير ذلك إلى أنّ حجم حمولة الاستجابة التي أرسلها التطبيق المستهدَف/الخلفية إلى Apigee أكبر من الحدّ المسموح به في Apigee Edge.
3. تحقَّق من حجم حمولة الردّ كما هو محدّد في الخطوة 1.
   • إذا كان حجم الحمولة أكبر من الحدّ المسموح به وهو 10 ميغابايت، سيكون هذا هو سبب الخطأ.
   • إذا كان حجم الحمولة يبلغ حوالي 10 ميغابايت، وهو الحدّ المسموح به، فمن المحتمل أن يتم تمرير حمولة الرد بتنسيق مضغوط. في هذه الحالة، تحقَّق من حجم الرد غير المضغوط.
4. يمكنك التأكّد مما إذا تم إرسال الردّ من الخادم المستهدف أو الخلفية بتنسيق مضغوط وما إذا كان الحجم غير المضغوط أكبر من الحدّ المسموح به باستخدام إحدى الطرق التالية:

   التتبّع

   استخدام أداة "التتبُّع":

   1. إذا كنت قد سجّلت عملية تتبُّع للطلب الذي تعذّر تنفيذه، يُرجى الرجوع إلى الخطوات المفصّلة في عملية التتبُّع و
      1. تحديد قيمة target.received.content.length
      2. تأكَّد مما إذا كان الطلب الوارد من العميل يتضمّن العنوان Content-Encoding: gzip
   2. إذا كانت قيمة target.received.content.length قريبة من الحدّ المسموح به وهو 10 ميغابايت، وكان عنوان الاستجابة 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 ميغابايت.

   سجلّات "معالج الرسائل"

   استخدام سجلّات "معالج الرسائل":

   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 ميغابايت، يتوقف المعالج ويعرض السطر التالي:

      Message is too large. TotalRead 10489856 chunkCount 2571

      يشير ذلك إلى أنّ حجم حمولة الاستجابة أكبر من 10 ميغابايت، وأنّ Apigee تعرض الخطأ عندما يبدأ الحجم في تجاوز الحدّ الأقصى البالغ 10 ميغابايت مع رمز الخطأ 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 ميغابايت.

إذا كنت لا تزال بحاجة إلى أي مساعدة من فريق دعم Apigee، انتقِل إلى المعلومات التشخيصية التي يجب جمعها.

يجب جمع معلومات التشخيص

اجمع معلومات التشخيص التالية، ثم تواصَل مع فريق دعم Apigee Edge:

إذا كنت مستخدمًا لخدمة السحابة الإلكترونية العامة، يُرجى تقديم المعلومات التالية:

• اسم المؤسسة
• اسم البيئة
• اسم خادم وكيل لواجهة برمجة التطبيقات
• أمر curl الكامل المُستخدَم لإعادة إنتاج الخطأ 502
• ملف التتبُّع لطلبات البيانات من واجهة برمجة التطبيقات
• الناتج الكامل للاستجابة من الخادم المستهدف/الخادم الخلفي مع حجم الحمولة

إذا كنت مستخدمًا في Private Cloud، يُرجى تقديم المعلومات التالية:

• رسالة الخطأ الكاملة التي تم رصدها للطلبات التي تعذّر تنفيذها
• اسم المؤسسة
• اسم البيئة
• حزمة خادم وكيل لواجهة برمجة التطبيقات
• ملف التتبُّع لطلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها
• أمر 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