‫۵۰۲ دروازه نادرست - پاسخ ۴۰۵ بدون سرصفحه «اجازه دادن»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

نشانه

برنامه مشتری کد وضعیت HTTP 502 Bad Gateway را با کد خطای protocol.http.Response405WithoutAllowHeader به‌عنوان پاسخ برای تماس‌های API دریافت می‌کند.

پیام خطا

برنامه کارخواه کد پاسخ زیر را دریافت می‌کند:

HTTP/1.1 502 Bad Gateway

علاوه‌براین، ممکن است پیام خطای زیر را مشاهده کنید:

{
   "fault":{
      "faultstring":"Received 405 Response without Allow Header",
      "detail":{
         "errorcode":"protocol.http.Response405WithoutAllowHeader"
      }
   }
}

علل احتمالی

این خطا زمانی رخ می‌دهد که سرور زیرینه با کد وضعیت 405 Method Not Allowed بدون سرایند Allow پاسخ دهد.

طبق مشخصات RFC 7231، بخش ۶.۵.۵: ۴۰۵ روش مجاز نیست، انتظار می‌رود که سرور مبدأ باید فیلد سرایند Allow را در پاسخ 405 حاوی فهرست روش‌های پشتیبانی‌شده فعلی منبع هدف تولید و ارسال کند. اگر این‌طور نباشد، Apigee با 502 Bad Gateway و کد خطای protocol.http.Response405WithoutAllowHeader پاسخ می‌دهد.

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
پاسخ ۴۰۵ بدون سرصفحه «اجازه دادن» از سرور زیرینه سرور زیرینه که درخواست API را پردازش می‌کند با کد وضعیت 405 بدون سرایند Allow پاسخ می‌دهد. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»

مراحل متداول تشخیص خرابی

برای تشخیص این خطا، از یکی از ابزارها/تکنیک‌های زیر استفاده کنید:

پایش میانای برنامه‌سازی کاربردی

برای تشخیص خطا بااستفاده از «پایش API»:

  1. به‌عنوان کاربری با نقش مناسب به سیستم واسط کاربر Edge وارد شوید.
  2. به سازمانی که می‌خواهید مشکل را در آن بررسی کنید بروید.

    فهرست کرکره‌ای سازمان
  3. به صفحه تجزیه‌وتحلیل > پایش API > بررسی پیمایش کنید.
  4. بازه زمانی خاصی را که در آن خطاها را مشاهده کرده‌اید انتخاب کنید.
  5. رسم کد خطا دربرابر زمان.

  6. سلولی را که کد خطا دارد انتخاب کنید protocol.http.Response405WithoutAllowHeader همان‌طور که در زیر نشان داده شده است:

  7. اطلاعات مربوط به کد خطا protocol.http.Response405WithoutAllowHeader به‌صورت زیر نمایش داده می‌شود:

  8. روی مشاهده گزارش‌ها کلیک کنید و یکی از درخواست‌های ناموفق را ازهم باز کنید تا اطلاعات بیشتری ببینید.

  9. از پنجره گزارش‌ها، جزئیات زیر را یادداشت کنید:
    • کد وضعیت: 502
    • منبع خطا: target
    • کد خطا: protocol.http.Response405WithoutAllowHeader.
  10. اگر منبع خطا target باشد و کد خطا protocol.http.Response405WithoutAllowHeader باشد، این نشان می‌دهد که سرور پشتیبان با کد وضعیت 405 Method Not Allowed بدون سرصفحه Allow پاسخ داده است.

ابزار ردیابی

برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:

  1. جلسه ردیابی و یکی از این موارد را فعال کنید
    • منتظر بمانید تا خطای 502 Bad Gateway رخ دهد، یا
    • اگر می‌توانید مشکل را بازتولید کنید، برای بازتولید مشکل، فراخوانی API را انجام دهید - 502 Bad Gateway خطا
  2. مطمئن شوید که نمایش همه FlowInfos فعال باشد:

  3. یکی از درخواست‌های ناموفق را انتخاب کنید و ردیابی را بررسی کنید.
  4. در مراحل مختلف ردیابی پیمایش کنید و مکان وقوع خطا را پیدا کنید.
  5. معمولاً خطا را در جریانی پس‌از مرحله درخواست به سرور هدف ارسال شد پیدا خواهید کرد، همان‌طور که در زیر نشان داده شده است:

  6. مقدار خطا را از ردیابی یادداشت کنید.

    ردیابی نمونه بالا خطا را به‌صورت Received 405 Response without Allow Header نشان می‌دهد. ازآنجایی‌که این خطا پس‌از ارسال درخواست به سرور پشتیبان توسط Apigee ایجاد شده است، نشان می‌دهد که سرور پشتیبان کد وضعیت پاسخ 405 را بدون سرایند Allow ارسال کرده است.

  7. به فاز AX (داده‌های Analytics ضبط‌شده) در ردیابی بروید و روی آن کلیک کنید.
  8. در پانل جزئیات مرحله به بخش خطا / سرایندهای پاسخ پیمایش کنید و مقادیر X-Apigee-fault-code و X-Apigee-fault-source را همان‌طور که در زیر نشان داده شده است تعیین کنید:

  9. مقادیر X-Apigee-fault-code و X-Apigee-fault-source را به‌ترتیب protocol.http.Response405WithoutAllowHeader و target خواهید دید، که نشان می‌دهد این خطا به‌دلیل ارسال کد وضعیت پاسخ 405 توسط زیرینه بدون سرایند Allow ایجاد شده است.
    سرایندهای پاسخ مقدار
    X-Apigee-fault-code protocol.http.Response405WithoutAllowHeader
    X-Apigee-fault-source target

NGINX

برای تشخیص خطا بااستفاده از گزارش‌های دسترسی NGINX:

  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید از گزارش‌های دسترسی NGINX برای تعیین اطلاعات کلیدی درباره خطاهای HTTP 502 استفاده کنید.
  2. گزارش‌های دسترسی NGINX را بررسی کنید:

    /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log

    کجا: ORG، ORG، و PORT# با مقادیر واقعی جایگزین می‌شوند.

  3. جستجو کنید تا ببینید آیا درطول مدت مشخصی (اگر مشکل در گذشته رخ داده است) خطای 502 با کد خطای protocol.http.Response405WithoutAllowHeader وجود دارد یا نه، یا اینکه آیا درخواست‌هایی هنوز با 502 ناموفق هستند یا نه.
  4. اگر خطاهای 502 را پیدا کردید که با X-Apigee-fault-code مطابقت دارد مقدار protocol.http.Response405WithoutAllowHeader را تعیین کنید، سپس مقدار X-Apigee-fault-source را تعیین کنید.

    نمونه خطای ۵۰۲ از گزارش دسترسی NGINX:

    ورودی نمونه بالا از گزارش دسترسی NGINX مقادیر زیر را برای X-Apigee- fault-code و X-Apigee-fault-source: دارد:

    سرایندهای پاسخ مقدار
    X-Apigee-fault-code protocol.http.Response405WithoutAllowHeader
    X-Apigee-fault-source target

علت: پاسخ ۴۰۵ بدون سرصفحه «اجازه دادن» از سرور زیرینه

تشخیص

  1. کد خطا و منبع خطا را برای 502 Bad Gateway بااستفاده از «پایش میانای برنامه‌سازی کاربردی»، «ابزار ردیابی»، یا گزارش‌های دسترسی NGINX همان‌طور که در مراحل تشخیص متداول توضیح داده شده است تعیین کنید.
  2. اگر کد خطا protocol.http.Response405WithoutAllowHeader باشد و «منبع خطا» مقدار target را داشته باشد، این نشان می‌دهد که سرور زیرینه با کد وضعیت 405 بدون سرایند Allow پاسخ داده است. بنابراین، ‫Apigee با 502 Bad Gateway و کد خطا protocol.http.Response405WithoutAllowHeader پاسخ می‌دهد.

وضوح

برای حل مشکل، از یکی از روش‌های زیر استفاده کنید:

سرور زیرینه

گزینه ۱: «سرور پشتیبان» را اصلاح کنید تا کد وضعیت ۴۰۵ را با سرصفحه «اجازه دادن» ارسال کند:

  1. مطمئن شوید که سرور زیرینه همیشه از مشخصات RFC 7231، بخش ۶.۵.۵: ۴۰۵ روش مجاز نیست پیروی می‌کند و با کد وضعیت 405 ارسال می‌کند و فهرست روش‌های مجاز را به‌عنوان بخشی از سرایند Allow همان‌طور که در زیر نشان داده شده است اضافه می‌کند:

    Allow: HTTP_METHODS
  2. برای مثال، اگر سرور زیرین شما روش‌های GET، POST، و HEAD را مجاز می‌کند، باید مطمئن شوید که سرایند Allow حاوی آن‌ها به‌صورت زیر باشد:
    Allow: GET, POST, HEAD

مدیریت خطا

گزینه ۲: از «مدیریت خطا» برای ارسال کد وضعیت ۴۰۵ با سرایند «اجازه دادن» از پراکسی API خود استفاده کنید:

اگر سرور زیرینه کد وضعیت 405 را بدون سرصفحه Allow برگرداند، می‌توانید از مدیریت خطا برای پاسخ دادن با کد وضعیت 405 و سرصفحه Allow از پراکسی API خود به این صورت استفاده کنید:

  1. سیاستی مانند سیاست AssignMessage یا سیاست RaiseFault ایجاد کنید و کد وضعیت را روی 405 با سرایند Allow و پیام سفارشی تنظیم کنید.

    خط‌مشی نمونه AssignMessage برای ارسال ۴۰۵ با سرایند Allow:

    <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
        <DisplayName>AM-405WithAllowHeader</DisplayName>
        <Set>
            <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
            <StatusCode>405</StatusCode>
            <ReasonPhrase>Method Not Allowed</ReasonPhrase>
        </Set>
        <Add>
            <Headers>
                <Header name="Allow">GET, POST, HEAD</Header>
            </Headers>
        </Add>
        <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
        <AssignTo createNew="false" transport="http" type="request"/>
    </AssignMessage>
  2. FaultRule را در TargetEndpoint ایجاد کنید که خط‌مشی را پس‌از دریافت خطای 502 با کد خطای protocol.http.Response405WithoutAllowHeader فرا می‌خواند.

    پیکربندی نمونه TargetEndpoint که FaultRule را نشان می‌دهد:

    <TargetEndpoint name="default">
    ...
        <FaultRules>
           <FaultRule name="405WithoutAllowHeader">
                <Step>
                    <Name>AM-405WithAllowHeader</Name>
                </Step>
                <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
            </FaultRule>
        </FaultRules>
  3. این تغییرات را در نسخه جدیدی از پراکسی API خود ذخیره کنید و نسخه را مستقر کنید.
  4. تماس‌های API را برقرار کنید و تأیید کنید که کد وضعیت 405 را با سرصفحه Allow دریافت می‌کنید.

پیکربندی دارایی

گزینه شماره ۳: دارایی را در «پردازشگر پیام» پیکربندی کنید تا از بازگرداندن خطای ۵۰۲ توسط Apigee Edge جلوگیری شود

  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید دارایی HTTP.ignore.allow_header.for.405 را به true به‌روز کنید تا از ایجاد خطای 502 توسط Apigee Edge جلوگیری کنید، حتی اگر سرور پشتیبان با کد وضعیت 405 بدون سرایند Allow پاسخ دهد. برای این کار، از راهنمای گام‌به‌گام زیر استفاده کنید: پیکربندی سرایند اجازه نادیده گرفتن برای دارایی 405 در «پردازشگرهای پیام».
  2. اگر کاربر «ابر عمومی» هستید، لطفاً با پشتیبانی Apigee Edge تماس بگیرید

مشخصات

‫Apigee انتظار دارد پاسخ 405 Method Not Allowed از سرور زیرینه همراه با سرصفحه Allow طبق مشخصات زیر دریافت کند:

مشخصات
RFC 7231، بخش 6.5.5: 405 Method Not Allowed (روش مجاز نیست)
‫RFC 7231، بخش 7.4.1: مجاز

نکات کلیدی قابل‌توجه

راه‌حل پیشنهادی این است که سرور زیرینه را اصلاح کنید تا کد وضعیت 405 را با سرصفحه Allow ارسال کند و از مشخصات RFC 7231، بخش 6.5.5: 405 Method Not Allowed (روش مجاز نیست) پیروی کند.

اگر هنوز به کمک «پشتیبانی Apigee» نیاز دارید، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

باید اطلاعات تشخیص خرابی را جمع‌آوری کند

اگر مشکل حتی پس‌از دنبال کردن دستورالعمل‌های بالا برطرف نشد، اطلاعات تشخیصی زیر را جمع‌آوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید.

اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:

  • نام سازمان
  • نام محیط
  • نام پراکسی میانای برنامه‌سازی کاربردی
  • فرمان کامل curl برای بازتولید 502 Bad Gateway با کد خطای protocol.http.Response405WithoutAllowHeader استفاده شد
  • فایل ردیابی برای درخواست‌های API

اگر کاربر «ابر خصوصی» هستید، اطلاعات زیر را ارائه دهید:

  • پیام خطای کامل مشاهده‌شده برای درخواست‌های ناموفق
  • نام محیط
  • دسته پراکسی میانای برنامه‌سازی کاربردی
  • فایل ردیابی برای درخواست‌های API
  • گزارش‌های دسترسی NGINX

    /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log

    کجا: ORG، ORG، و PORT# با مقادیر واقعی جایگزین می‌شوند.

  • گزارش‌های سیستم «پردازشگر پیام»
    /opt/apigee/var/log/edge-message-processor/logs/system.log

مرجع‌ها

مدیریت خطا در Apigee