‫۵۰۲ دروازه نادرست - DuplicateHeader

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

نشانه

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

پیام خطا

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"Duplicate Header \"Expires\"",
      "detail":{
         "errorcode":"protocol.http.DuplicateHeader"
      }
   }
}

علل احتمالی

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

طبق RFC 7230، بخش 3.2.2: ترتیب فیلد، فرستنده نباید چندین فیلد سرایند با نام فیلد یکسان در پیام تولید کند، مگر اینکه کل مقدار فیلد برای آن فیلد سرایند به‌عنوان فهرست جداشده با کاما تعریف شده باشد، [یعنی ‫#(values)] یا فیلد سرایند یک استثنای شناخته‌شده است. اگر Apigee Edge متوجه شود که سرایند یکسانی که اجازه ندارد چندین بار ارسال شود، بیش‌از یک‌بار در پاسخ HTTP ارسال‌شده توسط سرور هدف/پشتیبان ارسال شده است، در این‌صورت با 502 Bad Gateway و کد خطای protocol.http.DuplicateHeader پاسخ می‌دهد

در اینجا دلایل احتمالی این خطا آورده شده است:

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

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

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

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

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

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

  3. به صفحه تجزیه‌وتحلیل > پایش API > بررسی پیمایش کنید.
  4. بازه زمانی خاصی را که در آن خطاها را مشاهده کرده‌اید انتخاب کنید.
  5. مطمئن شوید که فیلتر پروکسی روی همه تنظیم شده باشد.
  6. رسم کد خطا دربرابر زمان.
  7. سلولی را که کد خطای protocol.http.DuplicateHeader را دارد، همان‌طور که در زیر نشان داده شده است، انتخاب کنید:

    (مشاهده تصویر بزرگ‌تر)

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

    (مشاهده تصویر بزرگ‌تر)

  9. مطمئن شوید که کد وضعیت 502 باشد، همان‌طور که در مثال بالا نشان داده شده است.
  10. روی مشاهده گزارش‌ها کلیک کنید و ردیف درخواست ناموفق را ازهم باز کنید.
  11. از پنجره «گزارش‌ها»، جزئیات زیر را یادداشت کنید:

    • کد وضعیت: 502
    • منبع خطا: target
    • کد خطا: protocol.http.DuplicateHeader.
  12. منبع خطا target است که نشان می‌دهد پاسخ سرور زیرینه حاوی سرصفحه‌های تکراری بوده است.

ابزار ردیابی

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

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

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

    (مشاهده تصویر بزرگ‌تر)

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

    ردیابی نمونه بالا خطا را به‌صورت Duplicate Header "Expires" نشان می‌دهد. ازآنجایی‌که این خطا پس‌از ارسال درخواست به سرور پشتیبان توسط Apigee ایجاد می‌شود، نشان می‌دهد که سرور پشتیبان سرایند Expires را بیش‌از یک‌بار ارسال کرده است.

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

    (مشاهده تصویر بزرگ‌تر)

  9. مقادیر X-Apigee-fault-code و X-Apigee-fault-source را به‌صورت protocol.http.DuplicateHeader و target خواهید دید که نشان می‌دهد این خطا به‌دلیل ارسال سرایندهای تکراری توسط سرور زیرینه برای سرایند پاسخ Expires ایجاد شده است.
    سرایندهای پاسخ مقدار
    X-Apigee-fault-code protocol.http.DuplicateHeader
    X-Apigee-fault-source target
  10. بررسی کنید که آیا از زنجیره پروکسی استفاده می‌کنید یا خیر؛ یعنی آیا سرور مقصد یا نقطه پایانی مقصد درحال فراخوانی پروکسی دیگری در Apigee است یا خیر.

    1. برای تعیین این موضوع، به مرحله سرور درخواست ارسال‌شده به هدف برگردید. روی نمایش Curl کلیک کنید.

    2. پنجره Curl for Request Sent to Target Server (فرمان Curl برای درخواست ارسال‌شده به سرور هدف) باز می‌شود که از آن می‌توانید نام مستعار میزبان سرور هدف را تعیین کنید.

    3. اگر نام مستعار میزبان سرور هدف به نام مستعار میزبان مجازی اشاره کند، آنگاه زنجیره پروکسی است. در این مورد، باید همه مراحل بالا را برای پراکسی زنجیره‌ای تکرار کنید تا مشخص کنید چه چیزی واقعاً باعث خطای 502 Bad Gateway شده است.
    4. اگر نام مستعار میزبان سرور هدف به سرور زیرینه شما اشاره می‌کند، این یعنی سرور زیرینه شما سرصفحه‌های تکراری را در پاسخ به Apigee ارسال می‌کند.

NGINX

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

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

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

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

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

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

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

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

علت: سرایند تکراری در پاسخ

تشخیص

  1. کد خطا و منبع خطا را برای خطای مشاهده‌شده بااستفاده از API «پایش» یا گزارش‌های دسترسی NGINX که در مراحل تشخیص خرابی متداول توضیح داده شده است تعیین کنید.
  2. اگر منبع خطا مقدار target را داشته باشد، این نشان می‌دهد که پاسخ ارسال‌شده توسط سرور هدف حاوی سرصفحه‌های تکراری است.
  3. می‌توانید سرصفحه واقعی را که بیش‌از یک‌بار به‌عنوان بخشی از پاسخ ارسال می‌شود بااستفاده از یکی از روش‌های زیر تعیین کنید:

    پیام خطا

    استفاده از پیام خطا:

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

      پیام خطای نمونه:

      "faultstring":"Duplicate Header \"Expires\""
    2. در پیام خطای بالا، می‌توانید ببینید که سرایند Expires بیش‌از یک‌بار ارسال شده است، همان‌طور که در faultstring دیده می‌شود.

    درخواست واقعی

    استفاده از درخواست واقعی:

    1. اگر به درخواست واقعی که به سرور هدف ارسال شده است دسترسی ندارید، فرمان curl مربوطه را از استفاده از ابزار «پیگیری» مرحله ۱۰.الف و مرحله ۱۰.ب دریافت کنید.
    2. اگر به درخواست واقعی که به برنامه سرور هدف ارسال شده است دسترسی دارید، مراحل زیر را انجام دهید:

      1. تماسی با سرور هدف برقرار کنید.

        درخواست نمونه برای سرور هدف استفاده‌شده در این مثال:

        curl -X GET "https://BACKEND_SERVER_HOST/response-headers?Expires=Mon%2C%2021%20June%202021%2007%3A28%3A00%20GMT&Expires=Mon%2C%2021%20June%202021%2007%3A28%3A00%20GMT" -v
        
      2. فهرست سرایندهای مشاهده‌شده در پاسخ را درستی‌سنجی کنید.

        نمونه پاسخ از سرور هدف که در این مثال استفاده شده است:

        * ...Trimmed...
        > GET /response-headers?Expires=Mon%2C%2021%20June%202021%2007%3A28%3A00%20GMT&Expires=Mon%2C%2021%20June%202021%2007%3A28%3A00%20GMT HTTP/2
        > Host: BACKEND_SERVER_HOST
        > User-Agent: curl/7.64.1
        > Accept: */*
        >
        * Connection state changed (MAX_CONCURRENT_STREAMS == 128)!
        < HTTP/2 200
        < date: Fri, 02 Jul 2021 05:29:07 GMT
        < content-type: application/json
        < content-length: 166
        < server: gunicorn/19.9.0
        < Expires: Mon, 21 June 2021 07:28:00 GMT
        < Expires: Mon, 21 June 2021 07:28:00 GMT
        < access-control-allow-origin: *
        < access-control-allow-credentials: true
        <
        ----<Response BODY>------
        * Connection #0 to host httpbin.org left intact
        * Closing connection 0

        در درخواست مثال بالا، سرصفحه Expires بیش‌از یک‌بار ارسال شده است. بنابراین، این درخواست با خطای 502 Bad Gateway و کد خطای protocol.http.DuplicateHeader ناموفق است.

      3. اگر سرایندی که نامش در faultstring آمده است بیش‌از یک بار در پاسخ سرور زیرینه ظاهر شود، آنگاه این دلیل این خطا است. در مورد بالا، سرایند Expires بیش‌از یک‌بار ارسال شده است.

وضوح

رفع تکراری بودن

گزینه ۱ [گزینه توصیه‌شده]: سرور زیرینه را اصلاح کنید تا سرصفحه‌های تکراری را اضافه نکند

  1. دلیل ارسال سربرگ تکراری توسط سرور زیرینه خاص را تجزیه‌وتحلیل کنید Expires و بررسی کنید که آیا پراکسی‌های API می‌توانند آن را بپذیرند یا نه. در اکثر موارد، طبق مشخصات HTTP RFC7230، این کار مطلوب نیست.
  2. اگر مطلوب نیست، برنامه سرور هدف را اصلاح کنید تا سربرگ‌های تکراری ارسال نکند. در مثال بالا، متوجه شدیم که سرایند Expires دو بار با مقدار یکسان ارسال شده است که مطلوب نیست. با اطمینان از اینکه سرور مقصد سرایند Expires را فقط یک‌بار ارسال می‌کند، می‌توانید مشکل را برطرف کنید.
  3. اگر مطلوب است و می‌خواهید سرصفحه‌های تکراری را مجاز کنید، به گزینه شماره ۲ بااستفاده از دارایی CwC بروید.

CwC

گزینه شماره ۲: استفاده از دارایی CwC

‫Apigee دارایی CwC را ارائه می‌دهد HTTPHeader.<HeaderName> که به برنامه‌های کارخواه و سرورهای هدف اجازه می‌دهد سربرگ‌های تکراری را به پراکسی‌های API در Apigee Edge ارسال کنند.

دارایی CwC مقادیر
HTTPHeader.<HeaderName> allowDuplicates,multivalued

برای مثال، دارایی زیر را می‌توان در «پردازشگرهای پیام» تنظیم کرد تا مقادیر تکراری و چندگانه برای سرایند Expires مجاز شود.

HTTPHeader.Expires=allowDuplicates, multiValued
  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید دارایی را پیکربندی کنید تا از ایجاد خطای 502 Bad Gateway توسط Apigee Edge جلوگیری کنید، حتی اگر درخواست حاوی سرایندهای تکراری باشد. برای این کار، از راهنمای گام‌به‌گام پیکربندی «پردازشگرهای پیام» برای استفاده از سرایندهای تکراری استفاده کنید.
  2. اگر کاربر «ابر عمومی» هستید، برای پیکربندی این دارایی برای سازمانتان با پشتیبانی Apigee Edge تماس بگیرید.

مشخصات

‫Apigee با پاسخ خطای 502 Bad Gateway پاسخ می‌دهد زیرا انتظار دارد که سرور زیرینه طبق مشخصات RFC زیر عمل کند:

مشخصات
‫RFC 7230، بخش ۳.۲.۲: ترتیب فیلد
RFC 7230، بخش ۳.۲: فیلدهای سرایند

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

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

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

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

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

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

  • پیام خطای کامل مشاهده‌شده برای درخواست‌های ناموفق
  • نام محیط
  • دسته پراکسی میانای برنامه‌سازی کاربردی
  • فایل ردیابی برای درخواست‌های API
  • گزارش‌های دسترسی 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