كتالوج أخطاء وقت التشغيل

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

الأخطاء في Apigee Edge

عند إرسال طلبات البيانات من واجهة برمجة التطبيقات من خلال Apigee Edge، يمكن أن تُعرِض مكونات Apigee Edge، وهي أجهزة التوجيه ومعالجات الرسائل، أو خوادم الخلفي أخطاء لتطبيقات العميل.

الأخطاء الواردة من Message Processor

إنّ "معالج الرسائل" هو المكوّن الأساسي في Apigee Edge الذي يعالج السياسات ويتفاعل مع خوادم الخلفية. في حال رصد أي مشاكل، مثل:

  • مشاكل في اتصال الشبكة أو تعذُّر تأكيد اتصال بروتوكول أمان طبقة النقل (TLS) أو عدم توفُّر خادم الخلفية أو عدم الاستجابة أثناء الاتصال بخادم الخلفية
  • حالات تعذُّر تنفيذ السياسة
  • عناوين HTTP أو ترميزها أو مسارها أو عدم التزامها بمواصفات HTTP أو تجاوز حدود المنتجات أو غير ذلك:
    • باستخدام طلب HTTP تُرسله تطبيقات العميل

      • أو

    • مع استجابة HTTP المُرسَلة من خادم الخلفية
  • وغير ذلك الكثير

نموذج خطأ من Message Processor

يعرض "معالج الرسائل" دائمًا رمز حالة HTTP متبوعًا برسالة خطأ مع رمز خطأ بتنسيق JSON كما هو موضّح أدناه:

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

HTTP/1.1 414 Request-URI Too Long

تظهر استجابة الخطأ من "معالج الرسائل" بالتنسيق التالي: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

وصف الحقول في ردّ الخطأ:

الحقل الوصف
faultstring يحتوي على رسالة الخطأ التي تصف السبب المحتمَل للخطأ
errorcode رمز الخطأ (يُشار إليه أيضًا باسم رمز الخطأ) المرتبط بالخطأ

كتالوج أخطاء وقت التشغيل

يوفّر هذا الكتالوج عن الأخطاء جميع المعلومات التي تحتاج إلى معرفتها عن رموز أخطاء وقت التشغيل (للأخطاء غير المتعلقة بالسياسة) التي يعرضها مكوّن "معالج رسائل Apigee Edge". ويتضمن التقرير المعلومات التالية لكل رمز خطأ:

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

يتمّ تناول فئات رموز الأخطاء التالية:

استخدِم مربّع البحث أدناه لفلترة الجدول وعرض المعلومات أعلاه لرمز خطأ معيّن. يمكنك البحث عن رمز الحالة أو أي محتوى في أي حقل في الجدول.

رمز الخطأ الوصف إصلاح

flow.*

flow.APITimedOut
  • رمز حالة HTTP:
 504 Gateway Timeout
  • رسالة الخطأ:
 API timed out
  • السبب المحتمَل:

يحدث هذا الخطأ في الحالات التالية:

  • لا يستجيب خادم الخلفية خلال فترة المهلة التي تضبطها السمة api.timeout للخادم الوكيل لواجهة برمجة التطبيقات المحدّد.
  • تستغرق إحدى السياسات وقتًا طويلاً بسبب العمليات المكثفة من الناحية الحسابية أو الحمولة العالية أو الأداء الضعيف.

ملاحظة: يوفّر هذا الدليل الإرشادي تعليمات لتحديد المشاكل في رمز الخطأ messaging.adaptors.http.flow.GatewayTimeout وحلّها، ولكن يمكنك استخدام الدليل الإرشادي نفسه لتحديد المشاكل المتعلّقة برمز الخطأ flow.APITimedOut وحلّها.

دليل إرشادي

flow.SharedFlowNotFound
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 Shared Flow {shared_flow_name} Not Found
  • السبب المحتمَل:

يحدث هذا الخطأ إذا كانت العملية المشتركة المحدّدة:

  • غير موجود

    • أو

  • متوفّرة ولكن لم يتم نشرها
دليل إرشادي

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • رمز حالة HTTP:
 404 Not Found
  • رسالة الخطأ:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • السبب المحتمَل:

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

  1. واجهة برمجة التطبيقات الوكيلة المحدّدة هي:
    1. لم يتم ضبطه لقبول الطلبات على الموقع الإلكتروني الافتراضي المحدّد
    2. لم يتم ضبطه لقبول الطلبات على المسار المحدّد المستخدَم في الطلب
    3. لم يتم نشرها في البيئة المحدّدة التي تحاول فيها إرسال طلبات البيانات من واجهة برمجة التطبيقات
    4. لم يتم نشرها على معالِج بيانات واحد أو أكثر
  2. عدم تحميل البيئة المحدّدة التي تحاول فيها إرسال طلبات واجهة برمجة التطبيقات على وحدة معالجة رسائل واحدة أو أكثر
 دليل إرشادي
يمكن أن يحدث هذا الخطأ أيضًا إذا كان لدى مضيفين افتراضيين متعدّدين الاسم المعرِّف للمضيف ورقم المنفذ نفسهما. دليل إرشادي

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Decompression failure at request
  • السبب المحتمَل:

لا يحدث هذا الخطأ إلا في الحالات التالية:

  • ترميز Content-Encoding المحدد في عنوان طلب HTTP هو ترميز صالح و متوافق مع Apigee Edge.

    • ولكن

  • لا يتطابق تنسيق الحمولة الذي أرسله العميل كجزء من طلب HTTP مع تنسيق الترميز المحدّد في عنوان Content-Encoding.
دليل إرشادي

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Decompression failure at response
  • السبب المحتمَل:

لا يحدث هذا الخطأ إلا في الحالات التالية:

  • الترميز المحدّد في عنوان استجابة HTTP Content-Encoding للخدمة الخلفية/الخادم المستهدَف صالح و متوافق مع Apigee Edge،

    • ولكن

  • لا يتطابق تنسيق الحمولة الذي يرسله الخادم الخلفي/الخادم المستهدَف كجزء من استجابة HTTP مع تنسيق الترميز المحدّد في عنوان Content-Encoding.
دليل إرشادي

messaging.adaptors.http.flow.ErrorResponseCode
  • رمز حالة HTTP:
 500

دليل إرشادي

فيديو

  • رسالة الخطأ:
 يمكن أن تختلف رسالة الخطأ وتنسيقها حسب تنفيذ خادم الخلفية.
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا ردّ خادم الخلفية برمز الحالة 500 إلى Apigee Edge.
  • رمز حالة HTTP:
 503

دليل إرشادي

الفيديو

  • رسالة الخطأ:
 يمكن أن تختلف رسالة الخطأ وتنسيقها حسب تنفيذ خادم الخلفية.
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا استجاب خادم الخلفية برمز الحالة 503 إلى Apigee Edge.
  • رمز حالة HTTP:
 504 دليل إرشادي
  • رسالة الخطأ:
 يمكن أن تختلف رسالة الخطأ وتنسيقها حسب تنفيذ خادم الخلفية.
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا استجاب خادم الخلفية برمز الحالة 504 إلى Apigee Edge.

ملاحظة: لا يتم عرض رمز الخطأ messaging.adaptors.http.flow.ErrorResponseCode كجزء من رسالة الخطأ المُرسَلة إلى تطبيقات العميل. ويرجع ذلك إلى أنّه يتم ضبط رمز الخطأ هذا بواسطة Apigee Edge عندما يتجاوب خادم الخلفية مع ظهور خطأ وأي من رموز الحالة 4XX أو 5XX. يمكنك الاطّلاع على رمز الخطأ هذا في "مراقبة واجهة برمجة التطبيقات" أو سجلّات الوصول إلى NGINX أو قاعدة بيانات الإحصاءات.

messaging.adaptors.http.flow.GatewayTimeout
  • رمز حالة HTTP:
 504 Gateway Timeout
  • رسالة الخطأ:
 Gateway Timeout
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا لم يستجِب خادم الخلفية لمعالج رسائل Apigee Edge خلال فترة انتهاء مهلة I/O التي تم ضبطها في معالج الرسائل.
دليل إرشادي

messaging.adaptors.http.flow.LengthRequired
  • رمز حالة HTTP:
 411 Length Required
  • رسالة الخطأ:
 'Content-Length' is missing
  • السبب المحتمَل:

يحدث هذا الخطأ إذا لم يتم تمرير عنوان Content-Length من خلال تطبيق العميل كجزء من طلبات HTTP POST وPUT المُرسَلة إلى Apigee Edge.

ملاحظة: لا يمكن تسجيل الطلبات التي تؤدي إلى ظهور هذا الخطأ في أداة "التتبّع"، لأنّ "معالج الرسائل" يُجري عملية التحقّق هذه في مرحلة مبكرة جدًا، قبل معالجة الطلب وتنفيذ أي سياسة في "الوكيل لواجهة برمجة التطبيقات".
  • مواصفات HTTP:
 الفقرة 3.3.2 من معيار RFC: طول المحتوى

إصلاح

لمعالجة هذا الخطأ، اتّبِع الخطوات التالية:

  1. تأكَّد من أنّ تطبيق العميل يُرسل دائمًا العنوان Content-Length كجزء من طلبات HTTP POST و PUT المُرسَلة إلى Apigee Edge. على سبيل المثال:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. حتى إذا كنت تُرسل حمولة فارغة مع طلبات POST و PUT، تأكَّد من إرسال العنوان Content-Length: 0. على سبيل المثال:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • رمز حالة HTTP:
 503 Service Unavailable
  • رسالة الخطأ:
 The Service is temporarily unavailable
  • السبب المحتمل:

يحدث هذا الخطأ في أحد السيناريوهات التالية، إذا كنت تستخدم TargetServer في Apigee Edge:

  1. أدّى حلّ نظام أسماء النطاقات غير الصحيح لمضيف خادم الخلفية من خلال خادم التفويض المخصّص إلى ظهور عناوين IP غير صالحة أدّت بدورها إلى أخطاء في الاتصال.
  2. حدثت أخطاء في مهلة الاتصال بسبب:
    1. إنّ تقييد جدار الحماية على خادم الخلفية يمنع Apigee Edge من الاتصال بخادم الخلفية.
    2. مشاكل في الاتصال بالشبكة بين Apigee Edge وخادم الخلفية
  3. المضيف المحدّد في TargetServer غير صحيح أو يحتوي على أحرف غير مرغوب فيها (مثل مسافة).

دليل إرشادي

فيديو
يمكن أن يحدث هذا الخطأ أيضًا إذا تعذّر تنفيذ عمليات التحقّق من الصحة التي تم إعدادها لتتبُّع عمليات التحقّق من صحة الخوادم المستهدَفة.

الدليل الإرشادي

فيديو

messaging.adaptors.http.flow.RequestTimeOut
  • رمز حالة HTTP:
 408 Request Timeout
  • رسالة الخطأ:
 Request timed out
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا لم يتلقّى "معالج الرسائل" في Apigee Edge ملف حمولة الطلب من تطبيق العميل خلال فترة مهلة I/O التي تم ضبطها في عنصر "معالج الرسائل".

إصلاح

تأكَّد من أنّ تطبيق العميل يُرسِل الحمولة المطلوبة خلال فترة مهلة I/O التي تم ضبطها في مكوّن Message Processor في Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • رمز حالة HTTP:
 503 Service Unavailable
  • رسالة الخطأ:
 The Service is temporarily unavailable
  • السبب المحتمَل:

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

  1. أدّى حلّ نظام أسماء النطاقات غير الصحيح لمضيف خادم الخلفية من خلال خادم التفويض المخصّص إلى ظهور عناوين IP غير صالحة أدّت بدورها إلى حدوث أخطاء في الاتصال.
  2. أخطاء انتهت مهلة الاتصال بسبب:
    1. يمنع تقييد جدار الحماية على خادم الخلفية Apigee Edge من الاتصال بخادم الخلفية.
    2. مشاكل في الاتصال بالشبكة بين Apigee Edge وخادم الخلفي
  3. مضيف الخادم الهدف المحدَّد في "نقطة النهاية المستهدَفة" غير صحيح أو يحتوي على أحرف غير مرغوب فيها (مثل المسافة).

الدليل الإرشادي

تعذُّر الوصول إلى نظام أسماء النطاقات:

فيديو

الاتصال بالشبكة:

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

messaging.adaptors.http.flow.SslHandshakeFailed
  • رمز حالة HTTP:
 503 Service Unavailable
  • رسالة الخطأ:
 SSL Handshake failed {error_message}
  • السبب المحتمَل:

يحدث هذا الخطأ أثناء عملية مصافحة طبقة المقابس الآمنة بين "معالج الرسائل" في Apigee Edge وخادم الخلفية في الحالات التالية:

  1. ملف تخزين الثقة الخاص بمعالج الرسائل في Apigee Edge:
    • يحتوي على سلسلة شهادات لا تتطابق مع سلسلة الشهادات الكاملة لخادم الخلفية

      • أو

    • لا يحتوي على سلسلة الشهادات الكاملة لخادم الخلفية
  2. سلسلة الشهادات التي يقدّمها خادم الخلفية:
    • يحتوي على اسم نطاق مؤهَّل بالكامل (FQDN) لا يتطابق مع اسم المضيف الذي تم تحديده في نقطة النهاية المستهدَفة

      • أو

    • تحتوي على سلسلة شهادات غير صحيحة أو غير مكتملة

دليل إرشادي

فيديو

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Unexpected EOF at target
  • السبب المحتمَل:

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

  1. لم يتم ضبط TargetServer بشكل صحيح للسماح باتصالات بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في Apigee Edge.
  2. قد يغلق خادم الخلفية الاتصال بشكل مفاجئ، بينما ينتظر Apigee Edge استجابة من خادم الخلفية.
  3. تم ضبط مهلات الاحتفاظ بالاتصال بشكل غير صحيح على Apigee و خادم الخلفية.
الدليل الإرشادي

messaging.runtime.*

messaging.runtime.RouteFailed
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 Unable to route the message to a TargetEndpoint
  • السبب المحتمَل:

يحدث هذا الخطأ إذا تعذّر على Apigee Edge توجيه الطلب إلى أي من TargetEndpoints للأسباب التالية:

  • ما مِن شرط لقاعدة المسار (<RouteRule>) يتطابق مع الطلب في الخادم الوكيل

    • و

  • لا تتوفّر قاعدة مسار تلقائي محدّدة في ProxyEndpoint (أي <RouteRule> بدون أي شرط)

إصلاح

لحلّ هذا الخطأ، اتّبِع التعليمات التالية:

  1. راجِع قواعد المسار المحدّدة في ProxyEndpoint وعدِّلها للتأكّد من أنّه يتوفّر شرط واحد على الأقل لقاعدة مسار يتطابق مع طلبك.
  2. من الممارسات الجيدة تحديد قاعدة مسار تلقائية بدون شرط عندما يكون لديك عدّة قواعد مسار.
  3. تأكَّد من أنّ قاعدة المسار التلقائية تكون دائمًا محددة في النهاية في قائمة "المسارات المشروطة"، لأنّه يتم تقييم القواعد من أعلى إلى أسفل في ProxyEndpoint.

لمزيد من المعلومات عن تحديد شروط <RouteRule> في ProxyEndpoint، اطّلِع على العناصر التي يمكن التفاعل معها عند النقر.

messaging.runtime.SenseRaiseFault
  • رمز حالة HTTP:
 403 Forbidden
  • رسالة الخطأ:
 Sense Fault
  • السبب المحتمل:
 يحدث هذا الخطأ إذا تم تقديم طلب بيانات من واجهة برمجة التطبيقات من عنوان IP معيّن للعميل تم حظره كجزء من قواعد Apigee Sense.

إصلاح

لمعالجة هذا الخطأ، اتّبِع التعليمات التالية:

  1. تحقَّق من حظر عنوان IP المحدَّد للعميل من خلال التحقّق من القواعد التي تم ضبطها في Apigee Sense. إذا تم حظره، يعني ذلك أنّه يعمل على النحو المطلوب.
  2. إذا لم يتم حظر عنوان IP الخاص بالعميل، ولكنّه لا يزال يظهر لك هذا الخطأ، يُرجى التواصل مع فريق دعم Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 Bad Form Data
  • السبب المحتمَل:

يحدث هذا الخطأ في حال استيفاء جميع الشروط التالية فقط:

  1. يحتوي طلب HTTP الذي يرسله العميل إلى Apigee Edge على ما يلي:
    • Content-Type: application/x-www-form-urlencoded و
    • بيانات النموذج التي تحتوي على علامة النسبة المئوية (%) أو علامة النسبة المئوية (%) متبوعة بأحرف سداسية عشرية غير صالحة وغير مسموح بها وفقًا ل نماذج - القسم 17.13.4.1
  2. يقرأ الخادم الوكيل لواجهة برمجة التطبيقات في Apigee Edge مَعلمات النموذج المحدّدة التي تحتوي على أي أحرف غير مسموح بها باستخدام سياسة PermissionVariables أو سياسة AssignMessage في مسار الطلب.
دليل إرشادي

protocol.http.DuplicateHeader
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Duplicate Header "{header_name}"
  • السبب المحتمل:
 يحدث هذا الخطأ إذا ظهر عنوان HTTP معيّن غير مسموح بأن يكون له نُسخ مكررة في Apigee Edge، ويظهر أكثر من مرة بقيم مختلفة أو بقيم مختلفة كجزء من طلب HTTP المرسَل من تطبيق العميل إلى Apigee Edge.
  • مواصفات HTTP:
 RFC 7230، الفقرة 3.2.2: الترتيب الميداني
الدليل الإرشادي

protocol.http.EmptyHeaderName
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Header name cannot be empty
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان اسم العنوان الذي تم إرساله كجزء من طلب HTTP من تطبيق العميل إلى Apigee Edge فارغًا.
  • مواصفات HTTP:
 RFC 7230، القسم 3.2: حقول العناوين

إصلاح

تأكَّد من أنّ طلب HTTP الذي يرسله تطبيق العميل إلى Apigee Edge يحتوي دائمًا على اسم عنوان صالح وفقًا لفقرة RFC 7230، الفقرة 3.2: حقول العنوان.

protocol.http.HeaderNameWithNonAsciiChar
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Header {header_name} contains non ascii character {character}
  • السبب المحتمل:
 يحدث هذا الخطأ إذا كان اسم العنوان الذي تم إرساله كجزء من طلب HTTP من خلال تطبيق العميل إلى Apigee Edge يحتوي على أحرف غير ASCII.
  • مواصفات HTTP:

RFC 7230، الفقرة 3.2: حقول العناوين وRFC 7230، القسم 3.2.6: مكونات قيمة الحقل

إصلاح

تأكَّد من أنّ طلب HTTP الذي يرسله العميل إلى Apigee Edge لا يحتوي على أحرف غير ASCII في أسماء العناوين وفقًا لـ RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل.

protocol.http.HeaderWithInvalidChar
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Header {header_name} contains invalid character {character}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان اسم العنوان الذي تم إرساله كجزء من طلب HTTP من خلال تطبيق العميل إلى Apigee Edge يحتوي على أحرف غير صالحة، مثل علامة التساوي (=)، والفاصلة (,)، والفاصلة المنقوطة (؛)، وعلامة التبويب، وCRLF، وحرف Newline.
  • مواصفات HTTP:

RFC 7230، القسم 3.2: حقول الرأس و RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل

إصلاح

تأكَّد من أنّ طلب HTTP الذي يرسله تطبيق العميل إلى Apigee Edge لا يحتوي على أي أحرف غير صالحة في أسماء العناوين وفقًا لـ RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل.

protocol.http.InvalidPath
  • رمز حالة HTTP:
 400 Bad Request
  • رسالة الخطأ:
 Invalid path {path}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان المسار في عنوان URL لطلب HTTP المُرسَل من تطبيق العميل إلى Apigee Edge يحتوي على أحرف غير مسموح بها وفقًا للمواصفات RFC 3986، الفقرة 3.3: المسار.
  • مواصفات HTTP:

RFC 3986، القسم 3: مكونات البنية و RFC 3986، القسم 3.3: المسار

إصلاح

تأكَّد من أنّ المسار في عنوان URL لطلب HTTP الذي يرسله تطبيق العميل إلى Apigee Edge لا يحتوي على أي أحرف غير مسموح بها وفقًا للفقرة 3.3 من RFC 3986: المسار.

protocol.http.TooBigBody
  • رمز حالة HTTP:
 413 Request Entity Too Large
  • رسالة الخطأ:
 Body buffer overflow
  • السبب المحتمل:
 يحدث هذا الخطأ إذا كان حجم الحمولة الذي أرسله تطبيق العميل كجزء من طلب HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
دليل إرشادي

protocol.http.TooBigHeaders
  • رمز حالة HTTP:
 431 Request Header Fields Too Large
  • رسالة الخطأ:
 request headers size exceeding {limit}
  • السبب المحتمَل:
 إجمالي حجم جميع رؤوس الطلبات التي أرسلها تطبيق العميل كجزء من طلب HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.
  • مواصفات HTTP:
 RFC 6585، القسم 5: 431 Request Header Fields Too Large
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
دليل إرشادي

protocol.http.TooBigLine
  • رمز حالة HTTP:
 414 Request-URI Too Long
  • رسالة الخطأ:
 request line size exceeding {limit}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان حجم سطر الطلب الذي أرسله تطبيق العميل كجزء من طلب HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
دليل إرشادي

protocol.http.UnsupportedEncoding
  • رمز حالة HTTP:
 415 Unsupported Media
  • رسالة الخطأ:
 Unsupported Encoding "{encoding}"
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان رأس Content-Encoding الذي أرسله العميل كجزء من استجابة HTTP يحتوي على تنسيق ترميز/بيانات أساسية غير متوافقة مع Apigee Edge.
  • مواصفات HTTP:
 RFC 7231، القسم 6.5.13: 415 Unsupported Media Type
الدليل الإرشادي

protocol.http.* - Caused by target

protocol.http.BadPath
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 Invalid request path
  • السبب المحتمل:
 يحدث هذا الخطأ إذا كان عنوان URL للطلب المرسَل إلى خادم الخلفية، والذي يمثّله المتغيّر target.url في عملية الربط، يحتوي على مسار يبدأ بعلامة استفهام (?) بدلاً من الشرطة المائلة للأمام (/)، ما يعني أنّه غير صالح.
  • مواصفات HTTP:

RFC 3986، الفقرة 3: مكوّنات البنية و RFC 3986، الفقرة 3.3: المسار
الدليل الإرشادي

protocol.http.DuplicateHeader
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Duplicate Header "{header_name}"
  • السبب المحتمل:
 يحدث هذا الخطأ إذا كان رأس HTTP المحدّد الذي لا يُسمح بظهور نُسخ منه في Apigee Edge يظهر أكثر من مرّة بقيم متطابقة أو مختلفة كجزء من استجابة HTTP التي يرسلها خادم الخلفية إلى Apigee Edge.
  • مواصفات HTTP:
 RFC 7230، القسم 3.2.2: ترتيب الحقول
دليل إرشادي

protocol.http.EmptyHeaderName
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Header name cannot be empty
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان اسم الرأس الذي أرسله خادم الخلفية كجزء من استجابة HTTP إلى Apigee Edge فارغًا.
  • مواصفات HTTP:
 RFC 7230، القسم 3.2: حقول الرأس

إصلاح

تأكَّد من أنّ استجابة HTTP المُرسَلة من خادم الخلفية إلى Apigee Edge تحتوي دائمًا على اسم عنوان صالح وفقًا لمعيار RFC 7230، القسم 3.2: حقول العناوين.

protocol.http.EmptyPath
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 Request path cannot be empty
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان عنوان URL لطلب HTTP الخاص بخادم الخلفية، والذي يمثّله متغيّر التدفق target.url، يحتوي على مسار فارغ.
  • مواصفات HTTP:

RFC 3986، الفقرة 3: مكوّنات البنية و RFC 3986، الفقرة 3.3: المسار
دليل إرشادي

protocol.http.HeaderNameWithNonAsciiChar
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Header {header_name} contains non ascii character {character}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان اسم العنوان الذي يرسله خادم الخلفية كجزء من استجابة HTTP إلى Apigee Edge يحتوي على أحرف غير ASCII.
  • مواصفات HTTP:

RFC 7230، القسم 3.2: حقول الرأس و RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل

إصلاح

تأكَّد من أنّ استجابة HTTP التي تم إرسالها إلى Apigee Edge لخادم الخلفية لا تحتوي على أحرف غير ASCII في أسماء العناوين وفقًا لمعيار RFC 7230، القسم 3.2.6: مكونات قيمة الحقل.

protocol.http.HeaderWithInvalidChar
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Header {header_name} contains invalid character {character}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان اسم الرأس الذي يرسله خادم الخلفية كجزء من استجابة HTTP يحتوي على أحرف غير صالحة، مثل علامة التساوي (=)، والفاصلة (,)، والفاصلة المنقوطة (؛)، وعلامة التبويب، وعلامة CRLF، وحرف Newline.
  • مواصفات HTTP:

RFC 7230، القسم 3.2: حقول الرأس و RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل

إصلاح

تأكَّد من أنّ استجابة HTTP لخادم الخلفية المُرسَلة إلى Apigee Edge لا تحتوي على أي أحرف غير صالحة في أسماء الرؤوس وفقًا لـ RFC 7230، القسم 3.2.6: مكوّنات قيمة الحقل.

protocol.http.ProxyTunnelCreationFailed
  • رمز حالة HTTP:
 503 Service Unavailable
  • رسالة الخطأ:
 Proxy refused to create tunnel with response status {status code}
  • السبب المحتمل:

يحدث هذا الخطأ أثناء إنشاء النفق بين Apigee Edge وخادم الخلفي بواسطة الخادم الوكيل بسبب مشاكل في جدار الحماية وقائمة التحكّم بالوصول (ACL) ونظام أسماء النطاقات وتوفّر خادم الخلفية وما إلى ذلك.

ملاحظة: يقدّم رمز الحالة في رسالة الخطأ (faultstring) السبب الأساسي للمشكلة.
دليل إرشادي

protocol.http.Response306Reserved
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Response Status code 306 is reserved, so can't be used.
  • السبب المحتمَل:

يحدث هذا الخطأ إذا ردّ خادم الخلفية برمز الحالة 306 إلى Apigee Edge.

تم تحديد رمز الحالة 306 في إصدار سابق من مواصفات HTTP. وفقًا لمواصفات HTTP الحالية، هذا الرمز محجوز ولا يجب استخدامه.
  • مواصفات HTTP:
 RFC 7231، القسم 6.3.5: 306 محجوز

إصلاح

بما أنّ رمز الحالة 306 محجوز، تأكَّد من أنّ خادم الخلفية لا يستخدم رمز الحالة هذا أثناء إرسال ردّ إلى Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Received 405 Response without Allow Header
  • السبب المحتمل:
 يستجيب خادم الخلفية برمز الحالة 405 Method Not Allowed بدون العنوان "Allow".
  • مواصفات HTTP:

RFC 7231، القسم 6.5.5: 405 Method Not Allowed و RFC 7231، القسم 7.4.1: Allow
دليل إرشادي

protocol.http.ResponseWithBody
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Received {status_code} Response with message body
  • السبب المحتمل:

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

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • مواصفات HTTP:

RFC 7231، القسم 6.3.5: 204 لا يتوفّر محتوى و RFC 7231، القسم 6.3.6: 205 إعادة ضبط المحتوى
دليل إرشادي

protocol.http.TooBigBody
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 Body buffer overflow
  • السبب المحتمل:
 يحدث هذا الخطأ إذا كان حجم الحمولة الذي أرسله تطبيق العميل كجزء من طلب HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
دليل إرشادي

protocol.http.TooBigHeaders
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 response headers size exceeding {limit}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان إجمالي حجم جميع رؤوس الاستجابة المُرسَلة من قِبل خادم الخلفية كجزء من استجابة HTTP إلى Apigee Edge أكبر من الحدّ المسموح به في Apigee Edge.
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
الدليل الإرشادي

protocol.http.TooBigLine
  • رمز حالة HTTP:
 502 Bad Gateway
  • رسالة الخطأ:
 response line size exceeding {limit}
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان حجم سطر الاستجابة الذي يرسله خادم الخلفية كهدية من استجابة HTTP إلى Apigee Edge أكبر من الحد المسموح به في Apigee Edge.
  • الحدود القصوى المسموح بها:
 حدود Apigee Edge
دليل إرشادي

protocol.http.UnsupportedEncoding
  • رمز حالة HTTP:
 415 Unsupported Media
  • رسالة الخطأ:
 Unsupported Encoding "{encoding}"
  • السبب المحتمَل:
 يحدث هذا الخطأ إذا كان رأس Content-Encoding الذي يرسله خادم الخلفية كجزء من استجابة HTTP يحتوي على تنسيق ترميز/حمولة غير متوافق مع Apigee Edge.
  • مواصفات HTTP:
 RFC 7231، القسم 6.5.13: 415 Unsupported Media Type
دليل إرشادي

security.util.*

security.util.KeyAliasNotFound
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • السبب المحتمَل:

يحدث هذا الخطأ إذا لم يتم العثور على KeyAlias المحدّد المُشار إليه في TargetEndpoint أو TargetServer في "متجر المفاتيح" المحدّد.

إصلاح

تأكَّد من توفّر Keyalias المحدَّدة في TargetEndpoint أو TargetServer وجزءًا من ملف تخزين المفاتيح المحدَّد.

security.util.TrustStoreWithNoCertificates
  • رمز حالة HTTP:
 500 Internal Server Error
  • رسالة الخطأ:
 TrustStore {truststore_name} has no certificates
  • السبب المحتمَل:

يحدث هذا الخطأ إذا كان مخبّر الثقة المحدّد المُشار إليه في TargetEndpoint أو TargetServer لا يحتوي على أيّ شهادات.

إصلاح

إذا أردت التحقق من صحة شهادة خادم الخلفية وأردت استخدام Truststore في TargetEndpoint أو TargetServer، تأكَّد من أنّ Truststore تحتوي على الشهادات الصالحة لخادم الخلفية.