502 بوابة غير صحيحة - ResponseWithBody

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

المشكلة

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

رسالة الخطأ

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"Received 204 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

{
   "fault":{
      "faultstring":"Received 205 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

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

يحدث هذا الخطأ إذا كانت استجابة HTTP من خادم الخلفية إلى Apigee Edge هي 204 No Content أو 205 Reset Content ولكنها تحتوي على نص الاستجابة و/أو واحد أو أكثر من العناوين التالية:

• Content-Length
• Content-Encoding
• Transfer-Encoding

وفقًا للمواصفات RFC 7231، القسم 6.3.5: 204 No Content و RFC 7231، القسم 6.3.6: 205 Reset Content، من المتوقّع ألا يتم إرسال أي محتوى إضافي كجزء من نص حمولة الاستجابة مع رمز الحالة 204 No Content أو 205 Reset Content من قِبل الخادم الأصلي. تشير عناوين الاستجابة ، مثل Content-Length أو Content-Encoding أو Transfer-Encoding، إلى حجم حمولة الاستجابة أو نوعها أو تنسيقها.

لذلك، يعرض Apigee Edge رمز الحالة 502 Bad Gateway مع رمز الخطأ protocol.http.ResponseWithBody للعميل في الظروف التالية:

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

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

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

السبب: نص الاستجابة أو العناوين مع استجابة 204 من خادم الخلفية

التشخيص

1. حدِّد رمز الخطأ ومصدر الخطأ للخطأ الذي تم رصده باستخدام "مراقبة واجهة برمجة التطبيقات" أو أداة التتبُّع أو سجلّات الوصول إلى NGINX كما هو موضّح في الخطوات الشائعة لتشخيص المشكلة.
2. إذا كان رمز الخطأ هو protocol.http.ResponseWithBody وكانت قيمة مصدر الخطأ هي target، يشير ذلك إلى أنّ خادم الخلفية استجاب برمز الحالة 204 No Content أو 205 Reset Content مع نص الاستجابة و/أو أحد العناوين المذكورة في قسم الأسباب المحتملة.

3. للتحقّق مما إذا كان خادم الخلفية قد أرسل بالفعل نص حمولة استجابة و/أو واحدًا أو أكثر من العناوين المذكورة في قسم الأسباب المحتملة، يمكنك اتّباع الخطوات التالية:

   1. إذا كنت مستخدمًا في Public Cloud ، يمكنك إرسال طلب البيانات نفسه من واجهة برمجة التطبيقات إلى خادم الخلفية مباشرةً من أي من أنظمتك.

   2. إذا كنت مستخدمًا في Private Cloud، يمكنك إرسال طلب بيانات من واجهة برمجة التطبيقات نفسه إلى خادم الخلفية مباشرةً من أحد معالِجات الرسائل المرتبطة بالمؤسسة والبيئة المحدّدتَين اللتَين تم رصد الخطأ فيهما.

   3. راجِع الاستجابة التي تم تلقّيها من خادم الخلفية وتأكَّد من أنّها تحتوي على نص حمولة استجابة و/أو واحد أو أكثر من العناوين المذكورة أعلاه. إذا كان الأمر كذلك، يكون هذا هو سبب هذا الخطأ.

      النموذج 1

      النموذج 1: استجابة خادم الخلفية 204 مع عنوان Content-Encoding

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Encoding: gzip
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      في هذا النموذج، استجاب خادم الخلفية برمز الحالة 204 No Content و Content-Encoding: gzip

      النموذج 2

      النموذج 2: استجابة خادم الخلفية 204 مع عنوان Content-Length

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Length: 48
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      في هذا النموذج، استجاب خادم الخلفية برمز الحالة 204 No Content و Content-Length: 48

      النموذج 3

      النموذج 3: استجابة خادم الخلفية 205 مع نص الاستجابة

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 205 Reset Content
      < Date: Sat, 31 Jul 2021 17:14:09 GMT
      < Content-Length: 12
      < Content-Type: text/plain; charset=utf-8
      <
      * Connection #0 to host X.X.X.X left intact
      This is a sample Response
      

      في هذا النموذج، استجاب خادم الخلفية برمز الحالة 205 Reset Content مع نص الاستجابة This is a sample Response.

   4. في جميع الأمثلة أعلاه، أرسل خادم الخلفية 204 No Content أو 205 Reset Content رمز الحالة مع نص الاستجابة و/أو أحد العناوين المذكورة في الأسباب المحتملة.
   5. لذلك، أرسل Apigee Edge رمز الحالة 502 Bad Gateway مع رمز الخطأ protocol.http.ResponseWithBody.

الدقة

تأكَّد من أنّ خادم الخلفية يلتزم دائمًا بالمواصفات RFC 7231، القسم 6.3.6: 205 Reset Content، عند إرسال الاستجابة 204 No Content أو 205 Reset Content إلى Apigee Edge. أي يجب على خادم الخلفية عدم إرسال ما يلي كجزء من استجابة 204 No Content أو 205 Reset Content:

1. نص حمولة الاستجابة
2. وأي من العناوين التالية:
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

المواصفات

يستجيب Apigee Edge برمز الحالة 502 Bad Gateway ورمز الخطأ protocol.http.ResponseWithBody إذا أرسل خادم الخلفية استجابة 204 No Content أو 205 Reset Content ولكنه لم يلتزم بمواصفات RFC التالية:

نقاط أساسية يجب أخذها في الاعتبار

الحلّ المقترَح هو إصلاح خادم الخلفية لإرسال رمز الحالة 204 No Content و 205 Reset Content بدون نص الاستجابة وأي من العناوين - Content-Length و Content-Encoding و Transfer-Encoding والالتزام بالمواصفات RFC 7231، القسم 6.3.5: 204 No Content و RFC 7231، القسم 6.3.6: 205 Reset Content.

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

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

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

إذا كنت مستخدمًا في Public Cloud، قدِّم المعلومات التالية:

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

إذا كنت مستخدمًا في Private Cloud ، قدِّم المعلومات التالية:

• رسالة الخطأ الكاملة التي تظهر للطلبات التي تعذّر تنفيذها
• اسم البيئة
• حزمة خادم وكيل واجهة برمجة التطبيقات
• ملف التتبُّع لطلبات البيانات من واجهة برمجة التطبيقات

• سجلّات الوصول إلى 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