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

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

المشكلة

يحصل تطبيق العميل على رمز حالة 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 بدون محتوى RFC 7231، الفقرة 6.3.6: 205 إعادة ضبط المحتوى، يُتوقَّع عدم توفُّر محتوى إضافي. يجب أن يرسلها خادم المصدر كجزء من نص حمولة الاستجابة مع رمز الحالة 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. إذا كنت مستخدمًا عامًا في Cloud، وكان بإمكانك إرسال طلب واجهة برمجة التطبيقات نفسه إلى خادم الخلفية مباشرةً من أي من أنظمتك.

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

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

      النموذج رقم 1

      النموذج 1: استجابة خادم الخلفية 204 باستخدام عنوان ترميز المحتوى

      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 مع عنوان طول المحتوى

      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 إعادة ضبط المحتوى، عند إرسال 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 بلا محتوى و RFC 7231، القسم 6.3.6: 205 إعادة ضبط المحتوى.

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

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

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

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

• اسم المؤسسة
• اسم البيئة
• اسم الخادم الوكيل لواجهة برمجة التطبيقات
• إكمال الأمر 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