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

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

المشكلة

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

رسالة الخطأ

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"response line size exceeding 2,048",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

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

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

قبل أن نلقي نظرة على الأسباب المحتملة لهذا الخطأ، دعونا نفهم معنى Response-Line وكيفية التحقّق من حجمه.

التعرّف على Response-Line

تتألف استجابة HTTP النموذجية من ثلاثة أجزاء:

1. Status-Line (يُشار إليها باسم Response-Line في Apigee)
2. ( مجموعة من عناوين HTTP )
3. [ Body ]

يتألف سطر الاستجابة من ثلاثة أجزاء: إصدار البروتوكول يليه رمز حالة رقمي وعبارة نصية مرتبطة كما هو موضّح أدناه:

Response-Line   = <HTTP-Version> <Status-Code> <Reason-Phrase>

عندما يرسل تطبيق الخادم المستهدف/الخلفي استجابة HTTP، يمثّل السطر الأول الذي يتم إرساله سطر الاستجابة كما هو موضّح أعلاه. يلي ذلك العناوين ونص الاستجابة/الحِمل.تعرض لقطة الشاشة النموذجية التالية طلب curl نموذجيًا، وجزء الطلب وجزء الاستجابة (بالإضافة إلى سطر الاستجابة).

فهم حجم "سطر الرد"

1. في النموذج الذي تمت مناقشته أعلاه، يكون سطر البداية (السطر الأول) في الرد، والذي يُشار إليه أيضًا باسم Response-Line، على النحو التالي:

   HTTP/1.1 200 OK

   يبلغ حجم Response-Line هذا ~15 bytes لأنّه يحتوي على 15 ASCII characters. بما أنّ هذا الإجراء يندرج ضمن الحدّ المسموح به في Apigee Edge، يتم إرسال الردّ إلى العميل بدون أي أخطاء من Apigee Edge.

2. وبالمثل، إذا نظرت إلى faultstring في رسالة الخطأ الموضّحة أعلاه، ستجد أنّها تحتوي على "response line size exceeding 2,048". يشير ذلك إلى أنّ Response-Line في استجابة HTTP التي أرسلها الخادم المستهدف/خادم الخلفية تجاوزت 2,048 بايت.

فهم Response-Line الكبير

وفقًا لتعريف Status-Line (المشار إليه هنا باسم Response-Line) وطلبات واستجابات HTTP النموذجية، سيكون الحجم أصغر بكثير من الحدّ التلقائي المحدّد البالغ 2 كيلوبايت في Apigee Edge، لذلك قد لا نصل إلى الحدّ. في ما يلي بعض السيناريوهات المحتملة التي قد تتجاوز فيها هذا الحدّ:

1. الخادم المستهدف/الخلفي ليس نظام HTTP. قد تكون الاستجابة غير متوافقة مع HTTP.
2. يواجه الخادم المستهدف/الخادم الخلفي مشاكل ويرسل Response-Line طويلاً كجزء من استجابة HTTP.

يمكنك الاطّلاع على مزيد من المعلومات حول هذا الموضوع في مقالة Getting error protocol.http.TooBigLine, "response line size exceeding 2,048.

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

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

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

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

التشخيص

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

3. يمكنك التأكّد من أنّ حجم سطر الردّ قد تجاوز الحدّ المسموح به البالغ 2 كيلوبايت باستخدام إحدى الطريقتَين التاليتَين:

   رسالة الخطأ

   لإثبات صحة المعلومات باستخدام رسالة الخطأ، اتّبِع الخطوات التالية:

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

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

   "faultstring":"response line size exceeding 2,048"

   يشير الرمز faultstring أعلاه إلى أنّ حجم سطر الردّ تجاوز الحدّ المسموح به وهو 2 كيلوبايت.

   الطلب الفعلي

   لإثبات صحة الرمز باستخدام الطلب الفعلي، اتّبِع الخطوات التالية:

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

   1. التحقّق من حجم Response-Line
   2. إذا تبيّن لك أنّ حجم معرّف الموارد المنتظم (URI) يتجاوز الحدّ المسموح به في Apigee Edge، فهذا هو سبب المشكلة.

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

      curl -v http://HOSTALIAS/test
      

      *   Trying 3.2.1.4...
      * TCP_NODELAY set
      * Connected to <hostalias> (3.2.1.4) port 80 (#0)
      > GET /test HTTP/1.1
      > Host: HOSTALIAS
      > User-Agent: curl/7.64.1
      > Accept: */*
      >
      < HTTP/1.1 200 1111…<trimmed>...11111111
      < Date: Mon, 26 Jul 2021 07:07:18 GMT
      < Content-Type: application/json
      < Content-Length: 269
      < Connection: keep-alive
      < Server: gunicorn/19.9.0
      < Access-Control-Allow-Origin: *
      < Access-Control-Allow-Credentials: true
      <
      {
      <Response Body>
      }
      * Connection #0 to host <hostalias> left intact
      * Closing connection 0

      في الحالة أعلاه، يكون سطر الردّ HTTP/1.1 200 1111…<trimmed>...11111111 أكبر من 2 كيلوبايت، أي أنّه يتضمّن أكثر من 2000 حرف ASCII.

      إذا كنت تستخدم برنامجًا آخر، يمكنك مراجعة سجلّات البرنامج ومحاولة معرفة حجم سطر الرد الذي يتم إرساله إلى Apigee Edge.

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

   لإثبات صحة البيانات باستخدام سجلّات "معالج الرسائل"، اتّبِع الخطوات التالية:

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

   1. حدِّد معرّف الرسالة للطلب الذي تعذّر تنفيذه باستخدام "رصد واجهة برمجة التطبيقات" أو أداة "التتبُّع" أو سجلّات الوصول إلى NGINX كما هو موضّح في خطوات التشخيص الشائعة.

   2. ابحث عن معرّف الرسالة في سجلّ "معالج الرسائل" (Message Processor) باتّباع الخطوات التالية:

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

   3. ستجد سطورًا من system.log مشابهة لما يلي:

      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1 messageid:r-5110240-1
      NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context$3.onException() :
      ClientChannel[Connected: Remote:3.2.1.2:80 Local:192.168.205.251:44398]@20592
      useCount=1 bytesRead=0 bytesWritten=201 age=144ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response line size exceeding 2,048
      at <snipped>
      
      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1
      messageid:r-5110240-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@6a5d6c33, response line size exceeding 2,048)

      يشير النص message = response line size exceeding 2,048 في رسالة الخطأ أعلاه إلى أنّ حجم سطر الرد يتجاوز 2 كيلوبايت. لذلك، يعرض Apigee Edge الاستثناء ويعرض رمز الحالة 502 مع رمز الخطأ protocol.http.TooBigline لتطبيقات العميل.

الدقة

الحدود

تتوقّع Apigee ألا يرسل تطبيق العميل وخادم الخلفية أسطر طلب/ردّ تتجاوز أحجامها الحدّ المسموح به كما هو موضّح في الحدّ الأقصى لسطر الطلب/الردّ في حدود Apigee Edge.

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

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

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

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

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

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

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

3. في مثال الناتج أعلاه، لاحظ أنّه تم ضبط السمة HTTPResponse.line.limit بالقيمة 2k في http.properties.

   يشير ذلك إلى أنّ الحدّ الأقصى لحجم Response-Line الذي تم ضبطه في Apigee for Private Cloud هو 2 كيلوبايت.

إذا كنت لا تزال بحاجة إلى أي مساعدة من فريق دعم 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