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

أنت تعرض مستندات 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 رموز الحالة. يمكنك الاطّلاع على رمز الخطأ هذا في "مراقبة واجهة برمجة التطبيقات" (API Monitoring) و"سجلات وصول 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 من خلال تطبيق العميل كجزء من POST وPUT في HTTP الطلبات المرسلة إلى 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. التحويل غير الصحيح لنظام أسماء النطاقات (DNS) لمضيف خادم الخلفية خادم تفويض مخصص يؤدي إلى عناوين 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. متجر الثقة في معالج الرسائل في 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 توجيه الطلب إلى أي من TargetEndpoints (نقاط النهاية المستهدفة) للأسباب التالية:

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

    • و

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

إصلاح

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

  1. راجِع قواعد المسار المحدّدة في ProxyEndpoint وعدِّلها للتأكّد من هناك شرط واحد على الأقل لقاعدة المسار يتوافق مع طلبك.
  2. من الممارسات الجيدة تحديد قاعدة مسار تلقائية بدون شرط عندما يكون لديك قواعد RouteRules متعددة.
  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 النموذج المحدَّد التي تحتوي على أي أحرف غير مسموح بها باستخدام استخراج المتغيّرات أو سياسة 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 على أي أحرف غير مسموح بها. وفقًا لمعيار 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 وحرف 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 بدون العنوان "السماح".
  • مواصفات 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 بدون محتوى 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 الحافة.
  • الحدود القصوى:
 حدود 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}
  • السبب المحتمل:

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

إصلاح

يُرجى التأكُّد من أنّ KeyAlias (العنوان البديل للبريد الإلكتروني) المحدد في TargetEndpoint أو TargetServer هو جزء من ملف تخزين المفاتيح المحدد.

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

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

إصلاح

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