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

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

المشكلة

يحصل تطبيق العميل على رمز حالة HTTP 502 Bad Gateway مع رمز الخطأ protocol.http.TooBigHeaders كاستجابة لواجهة برمجة التطبيقات الاتصالات.

رسالة الخطأ

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

HTTP/1.1 502 Bad Gateway

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

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

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

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

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

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

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

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

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

التشخيص

1. حدِّد رمز الخطأ ومصدر الخطأ وحجم حمولة الاستجابة تم رصد خطأ باستخدام سجلات مراقبة واجهة برمجة التطبيقات أو أداة التتبع أو NGINX Access كما هو موضح في خطوات التشخيص الشائعة:
2. إذا كانت قيمة المصدر الخطأ هي target، فهذا يشير إلى أنّ تحتوي الاستجابة المرسلة من الخادم الهدف/الخلفية إلى Apigee على عناوين أكبر عن الحد المسموح به في Apigee Edge.
3. يمكنك التحقق من أن الاستجابة من الهدف/الخلفية تحتوي على عناوين كان حجمها أكبر من الحد المسموح به باستخدام إحدى الطرق التالية:

   رسالة الخطأ

   للتحقق باستخدام رسالة الخطأ:

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

   نموذج لرسالة خطأ:

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

   في رسالة الخطأ أعلاه، لاحظ في faultstringأنّه تحتوي الاستجابة على عناوين يتجاوز حجمها الإجمالي الحد المسموح به.

   طلب فعلي

   للتحقّق من الصحة باستخدام الطلب الفعلي:

   إذا كان بإمكانك الوصول إلى الطلب الفعلي الذي تم تقديمه إلى الخادم الهدف/الخلفية، ثم نفِّذ الخطوات التالية:

   1. إذا كنت من مستخدمي السحابة الإلكترونية العامة/السحابة الخاصة، يمكنك تقديم طلب. مباشرةً إلى خادم الخلفية من خادم الخلفية نفسه أو من أي خادم جهازك من حيث يُسمح لك بتقديم الطلب إلى الواجهة الخلفية الخادم.
   2. إذا كنت مستخدمًا خاصًا في Cloud، يمكنك أيضًا تقديم طلب إلى خادم الخلفية من أحد معالجات الرسائل.
   3. فحص الاستجابة الواردة من خادم الخلفية، وعلى وجه التحديد احتساب الحجم الإجمالي للعناوين التي تم تمريرها في الاستجابة والتحقق منها.

   4. إذا وجدتَ أن حجم العناوين في حمولة الاستجابة يتجاوز الحد المسموح به في Apigee Edge، فهذا هو سبب المشكلة.

      نموذج للاستجابة من الخادم الهدف:

      curl -v https://TARGET_SERVER_HOST/test
      

      * 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 /test 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-Length: 0
      < Content-Type: text/plain; charset=utf-8
      < Last-Modified: Tue, 20 Jul 2021 09:23:56 GMT
      < Testheader1: XVlBzgba—-<snipped>---THctcuAx
      < Testheader2: hxKQFDaFpLSj—-<snipped>---FbcXoEFfRsWxP
      < Date: Fri, 23 Jul 2021 09:51:22 GMT
      <
      * Connection #0 to host 10.1.0.10 left intact
      

      في المثال أعلاه، Testheader1 أحجام Testheader2 أعلى، وهذا هو السبب في لهذا الخطأ، لأنه يتجاوز الحد المسموح به في Apigee Edge:

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

   للتحقق من صحة استخدام سجلات معالج الرسائل:

   إذا كنت أحد مستخدمي Private Cloud، يمكنك استخدام سجلات "معالج الرسائل" لتنفيذ ما يلي: التحقق مما إذا كان حجم رؤوس الاستجابة قد تجاوز الحد المسموح به في Apigee Edge.

   1. تحقَّق من سجلات "معالج الرسائل":

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

   2. البحث لمعرفة ما إذا كانت هناك أي أخطاء 502 خلال إجراء معيّن المدة (إذا حدثت المشكلة في الماضي) أو ما إذا كانت هناك أي طلبات لا يزال يتعذّر التحقّق مع 502. يمكنك استخدام سلسلة البحث التالية:

      grep -ri "response headers size exceeding"
      

   3. ستظهر لك سطور من "system.log" مشابهة لما يلي. قد يختلف حجم عناوين الردود في حالتك:

      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest rev:1
      messageid:r23ijb1b-1  NIOThread@1 ERROR HTTP.CLIENT -
      HTTPClient$Context$3.onException() :  ClientChannel[Connected:
      Remote:3.7.1.1:9000 Local:192.168.2.1:56098]@8414 useCount=1
      bytesRead=0 bytesWritten=207 age=640ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response headers size exceeding 25,600
      
      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest
      rev:1 messageid:r23ijb1b-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@31f3ef88, response headers size exceeding 25,600)
      

   4. بمجرد أن يحصل معالج الرسائل على رد من الخلفية/الهدف ووجدت أن الحجم الإجمالي للعناوين أكبر من 25 كيلوبايت، يتوقف ويعرض الخطأ:

      response headers size exceeding 25,600

      يشير ذلك إلى أنّ إجمالي حجم العناوين يتجاوز 25 كيلوبايت وفي Apigee تعرض الخطأ عندما يبدأ الحجم في تجاوز الحد الأقصى الذي يبلغ 25 كيلوبايت عند استخدام رمز خطأ باستخدام عنوان البريد الإلكتروني protocol.http.TooBigHeaders

الدقة

الحدود

تتوقع Apigee عدم إرسال تطبيق العميل وخادم الخلفية أحجام العناوين أكبر من الحد المسموح به كما هو موثَّق لحجم عنوان الطلب/الاستجابة في حدود Apigee Edge:

1. إذا كنت مستخدمًا في Cloud Cloud، فعندئذ يكون الحد الأقصى يتم توثيق حجم عناوين الطلب والاستجابة لحجم عنوان الطلب/الاستجابة في حدود Apigee Edge:
2. إذا كنت مستخدمًا خاصًا على السحابة الإلكترونية من المحتمل أنّك عدّلت الحد الأقصى التلقائي حد حجم عناوين الطلبات والاستجابة (على الرغم من أنه ليس ممارسة موصى بها). يمكنك تحديد الحد الأقصى لحجم عنوان الاستجابة من خلال اتباع الإرشادات في كيفية التحقّق من الحدّ الأقصى الحالي

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

يوضِّح هذا القسم كيفية إثبات أنّ الموقع الإلكتروني HTTPResponse.headers.limit يتضمّن تم تعديلها بقيمة جديدة في معالِجات معالجة الرسائل.

1. ابحث عن الموقع على جهاز "معالج الرسائل". HTTPResponse.headers.limit في دليل /opt/apigee/edge-message-processor/conf والتحقق إلى يمكنك الاطّلاع على القيمة التي تم ضبطها على النحو الموضّح أدناه:

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

2. في ما يلي نموذج النتيجة من الأمر أعلاه:

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

3. في مثال الإخراج أعلاه، لاحِظ أنّ السمة HTTPResponse.headers.limit تم ضبط القيمة 25k في http.properties.

   يشير ذلك إلى أنّ الحدّ الأقصى لحجم حمولة الاستجابة الذي تم ضبطه في Apigee for Private يبلغ حجم السحابة الإلكترونية 25 كيلوبايت.

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

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

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

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

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

إذا كنت مستخدمًا للسحابة الإلكترونية الخاصة، قدِّم المعلومات التالية:

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