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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

المشكلة

يحصل تطبيق العميل على رمز حالة 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.

في ما يلي الأسباب المحتملة للخطأ:

السبب	الوصف	تعليمات تحديد المشاكل وحلّها السارية على
حجم حمولة الاستجابة أكبر من الحد المسموح به	يتجاوز حجم الحمولة الذي يرسله خادم الهدف/الخلفية كجزء من استجابة HTTP إلى Apigee الحد المسموح به في Apigee.	مستخدمو Edge العام والخاص على السحابة الإلكترونية
يتجاوز حجم حمولة الاستجابة الحدّ المسموح به بعد فك الضغط	يتجاوز حجم حمولة البيانات التي تم إرسالها بالتنسيق المضغوط من قِبل الخادم الهدف/الخلفية كجزء من استجابة HTTP إلى Apigee الحد المسموح به عند فك ضغطه بواسطة Apigee.	مستخدمو Edge العام والخاص على السحابة الإلكترونية

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

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

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

التشخيص

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

   الطلب الفعلي

   باستخدام الطلب الفعلي:

   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. إذا كنت من مستخدمي السحابة الإلكترونية الخاصة، يمكنك استخدام سجلات "معالج الرسائل" لتحديد المعلومات الأساسية حول أخطاء 502 في HTTP.

   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. إذا كنت من مستخدمي Public Cloud، يكون الحد الأقصى لحجم حمولة الطلب والاستجابة موثّقًا للسمة Request/response size في حدود Apigee Edge.
2. إذا كنت من المستخدمين الخاصين على السحابة الإلكترونية ، قد يكون تم تعديل الحدّ الأقصى التلقائي لحجم حمولة الطلبات والاستجابة (على الرغم من أنّ ذلك لا ننصح به). يمكنك تحديد الحدّ الأقصى لحجم حمولة الطلب من خلال اتّباع التعليمات الواردة في كيفية التحقّق من الحدّ الحالي.

كيف يمكن التحقّق من الحد الحالي؟

يوضّح هذا القسم كيفية التحقق من أنّه قد تم تعديل الموقع 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:

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

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

إذا كنت مستخدم 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