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

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

أخطاء في Apigee Edge

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

أخطاء من معالج الرسائل

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

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

      • أو

    • مع استجابة HTTP التي أرسلها خادم الخلفية
  • وأسئلة أخرى كثيرة

نموذج خطأ من معالج الرسائل

يعرض "معالج الرسائل" دائمًا رمز حالة 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
  • السبب المحتمل:

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

  • الترميز المحدّد في عنوان طلب HTTP Content-Encoding صالح و متوافق مع 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 خلال فترة مهلة وحدات الإدخال والإخراج التي تم ضبطها على "معالج الرسائل".
كتاب إرشادي

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 حمولة الطلب من تطبيق العميل لفترة مهلة وحدات الإدخال والإخراج التي تم ضبطها على مكوّن "معالج الرسائل".

إصلاح

تأكَّد من أنّ تطبيق العميل يرسل حمولة الطلب خلال فترة مهلة وحدات الإدخال والإخراج التي تم ضبطها على مكوّن "معالج الرسائل" في 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}
  • السبب المحتمل:

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

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

      • أو

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

      • أو

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

كتاب إرشادي

فيديو

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

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

  1. لم يتم إعداد TargetServer بشكل صحيح لإتاحة اتصالات بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة في 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 توجيه الطلب إلى أي من نقاط النهاية المستهدفة للأسباب التالية:

  • ما من شرط لقاعدة مسار (<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 و
    • بيانات النموذج التي تتضمّن علامة النسبة المئوية (%) أو علامة النسبة المئوية (%) متبوعة بأحرف سداسية عشرية غير صالحة غير مسموح بها وفقًا لنماذج Google - الفقرة 17.13.4.1.
  2. يقرأ الخادم الوكيل لواجهة برمجة التطبيقات في Apigee Edge معلَمات النموذج المحدّدة التي تحتوي على أي أحرف غير مسموح بها باستخدام استخراجVariables أو سياسة 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 وحرف جديد.
  • مواصفات 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، القسم 3.3: المسار.

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 حقول عنوان الطلب كبيرة جدًا
  • الحدود القصوى المسموح بها:
 حدود 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 نوع الوسائط غير متوافق
كتاب إرشادي

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 وحرف جديد.
  • مواصفات 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)، ومشاكل نظام أسماء النطاقات (DNS)، ومدى توفّر خادم الخلفية، وما إلى ذلك.

ملاحظة: يقدّم رمز الحالة في رسالة الخطأ (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 Reserve

إصلاح

بما أنّ رمز الحالة 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 غير مسموح بها و RFC 7231، الفقرة 7.4.1: السماح
كتاب إرشادي

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 No Content و 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 نوع الوسائط غير متوافق
كتاب إرشادي

security.util.*

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

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

إصلاح

تأكَّد من أنّ الاسم المستعار للمفتاح المحدَّد في TargetEndpoint أو TargetServer متوفّر وأنّه جزء من ملف تخزين المفاتيح المحدّد.

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

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

إصلاح

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