درحال مشاهده اسناد 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»:
- بهعنوان کاربری با نقش مناسب به سیستم Apigee Edge UI وارد شوید.
به سازمانی که میخواهید مشکل را در آن بررسی کنید بروید.

- به صفحه تجزیهوتحلیل > پایش API > بررسی پیمایش کنید.
- بازه زمانی خاصی را که در آن خطاها را مشاهده کردهاید انتخاب کنید.
- مطمئن شوید که فیلتر پروکسی روی همه تنظیم شده باشد.
- رسم کد خطا دربرابر زمان.
سلولی را که کد خطای
protocol.http.DuplicateHeaderرا دارد، همانطور که در زیر نشان داده شده است، انتخاب کنید:
اطلاعات مربوط به کد خطا
protocol.http.DuplicateHeaderبهصورت زیر نمایش داده میشود:
- مطمئن شوید که کد وضعیت
502باشد، همانطور که در مثال بالا نشان داده شده است. - روی مشاهده گزارشها کلیک کنید و ردیف درخواست ناموفق را ازهم باز کنید.
از پنجره «گزارشها»، جزئیات زیر را یادداشت کنید:
- کد وضعیت:
502 - منبع خطا:
target - کد خطا:
protocol.http.DuplicateHeader.
- کد وضعیت:
- منبع خطا
targetاست که نشان میدهد پاسخ سرور زیرینه حاوی سرصفحههای تکراری بوده است.
ابزار ردیابی
برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:
- جلسه ردیابی و یکی از این موارد را فعال کنید
- منتظر بمانید تا خطای
502 Bad Gatewayرخ دهد یا - اگر میتوانید مشکل را بازتولید کنید، فراخوانی API را انجام دهید و خطای
502 Bad Gatewayرا بازتولید کنید
- منتظر بمانید تا خطای
مطمئن شوید نمایش همه اطلاعات جریان فعال باشد:

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

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

- مقادیر X-Apigee-fault-code و X-Apigee-fault-source
را بهصورت
protocol.http.DuplicateHeaderوtargetخواهید دید که نشان میدهد این خطا بهدلیل ارسال سرایندهای تکراری توسط سرور زیرینه برای سرایند پاسخExpiresایجاد شده است.سرایندهای پاسخ مقدار X-Apigee-fault-code protocol.http.DuplicateHeaderX-Apigee-fault-source target بررسی کنید که آیا از زنجیره پروکسی استفاده میکنید یا خیر؛ یعنی آیا سرور مقصد یا نقطه پایانی مقصد درحال فراخوانی پروکسی دیگری در Apigee است یا خیر.
برای تعیین این موضوع، به مرحله سرور درخواست ارسالشده به هدف برگردید. روی نمایش Curl کلیک کنید.
پنجره Curl for Request Sent to Target Server (فرمان Curl برای درخواست ارسالشده به سرور هدف) باز میشود که از آن میتوانید نام مستعار میزبان سرور هدف را تعیین کنید.
- اگر نام مستعار میزبان سرور هدف به نام مستعار میزبان مجازی اشاره کند، آنگاه زنجیره پروکسی است. در این مورد، باید همه مراحل بالا را برای پراکسی زنجیرهای تکرار کنید تا
مشخص کنید چه چیزی واقعاً باعث خطای
502 Bad Gatewayشده است. - اگر نام مستعار میزبان سرور هدف به سرور زیرینه شما اشاره میکند، این یعنی سرور زیرینه شما سرصفحههای تکراری را در پاسخ به Apigee ارسال میکند.
NGINX
برای تشخیص خطا بااستفاده از گزارشهای دسترسی NGINX:
- اگر کاربر «ابر خصوصی» هستید، میتوانید از گزارشهای دسترسی NGINX برای
تعیین اطلاعات کلیدی درباره خطاهای
502HTTP استفاده کنید. گزارشهای دسترسی NGINX را بررسی کنید:
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_logمکان: ORG، ENV، و PORT# با مقادیر واقعی جایگزین میشوند.
- جستجو کنید تا ببینید آیا درطول مدت مشخصی
502خطا وجود دارد یا نه (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز درخواستهایی با502ناموفق هستند یا نه. اگر خطاهای
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.DuplicateHeaderX-Apigee-fault-source target
علت: سرایند تکراری در پاسخ
تشخیص
- کد خطا و منبع خطا را برای خطای مشاهدهشده بااستفاده از API «پایش» یا گزارشهای دسترسی NGINX که در مراحل تشخیص خرابی متداول توضیح داده شده است تعیین کنید.
- اگر منبع خطا مقدار
targetرا داشته باشد، این نشان میدهد که پاسخ ارسالشده توسط سرور هدف حاوی سرصفحههای تکراری است. میتوانید سرصفحه واقعی را که بیشاز یکبار بهعنوان بخشی از پاسخ ارسال میشود بااستفاده از یکی از روشهای زیر تعیین کنید:
پیام خطا
استفاده از پیام خطا:
اگر به پیام خطای کامل دریافتی از Apigee Edge دسترسی دارید، به
faultstringمراجعه کنید.faultstringحاوی نام سرایندی است که بیشاز یکبار ارسال شده است.پیام خطای نمونه:
"faultstring":"Duplicate Header \"Expires\""
- در پیام خطای بالا، میتوانید ببینید که سرایند
Expiresبیشاز یکبار ارسال شده است، همانطور که درfaultstringدیده میشود.
درخواست واقعی
استفاده از درخواست واقعی:
- اگر به درخواست واقعی که به سرور هدف ارسال شده است دسترسی ندارید،
فرمان
curlمربوطه را از استفاده از ابزار «پیگیری» مرحله ۱۰.الف و مرحله ۱۰.ب دریافت کنید. اگر به درخواست واقعی که به برنامه سرور هدف ارسال شده است دسترسی دارید، مراحل زیر را انجام دهید:
تماسی با سرور هدف برقرار کنید.
درخواست نمونه برای سرور هدف استفادهشده در این مثال:
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
فهرست سرایندهای مشاهدهشده در پاسخ را درستیسنجی کنید.
نمونه پاسخ از سرور هدف که در این مثال استفاده شده است:
* ...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ناموفق است.اگر سرایندی که نامش در
faultstringآمده است بیشاز یک بار در پاسخ سرور زیرینه ظاهر شود، آنگاه این دلیل این خطا است. در مورد بالا، سرایندExpiresبیشاز یکبار ارسال شده است.
وضوح
رفع تکراری بودن
گزینه ۱ [گزینه توصیهشده]: سرور زیرینه را اصلاح کنید تا سرصفحههای تکراری را اضافه نکند
- دلیل ارسال سربرگ تکراری توسط سرور زیرینه خاص را تجزیهوتحلیل کنید
Expiresو بررسی کنید که آیا پراکسیهای API میتوانند آن را بپذیرند یا نه. در اکثر موارد، طبق مشخصات HTTP RFC7230، این کار مطلوب نیست. - اگر مطلوب نیست، برنامه سرور هدف را اصلاح کنید تا سربرگهای تکراری ارسال نکند.
در مثال بالا، متوجه شدیم که سرایند
Expiresدو بار با مقدار یکسان ارسال شده است که مطلوب نیست. با اطمینان از اینکه سرور مقصد سرایندExpiresرا فقط یکبار ارسال میکند، میتوانید مشکل را برطرف کنید. - اگر مطلوب است و میخواهید سرصفحههای تکراری را مجاز کنید، به گزینه شماره ۲ بااستفاده از دارایی CwC بروید.
CwC
گزینه شماره ۲: استفاده از دارایی CwC
Apigee دارایی CwC را ارائه میدهد
HTTPHeader.<HeaderName> که به برنامههای کارخواه و سرورهای
هدف اجازه میدهد سربرگهای تکراری را به پراکسیهای API در Apigee Edge ارسال کنند.
| دارایی CwC | مقادیر |
|---|---|
HTTPHeader.<HeaderName> |
allowDuplicates,multivalued |
برای مثال، دارایی زیر را میتوان در «پردازشگرهای پیام» تنظیم کرد تا
مقادیر تکراری و چندگانه برای سرایند Expires مجاز شود.
HTTPHeader.Expires=allowDuplicates, multiValued
- اگر کاربر «ابر خصوصی» هستید، میتوانید دارایی را پیکربندی کنید تا از ایجاد خطای
502 Bad Gatewayتوسط Apigee Edge جلوگیری کنید، حتی اگر درخواست حاوی سرایندهای تکراری باشد. برای این کار، از راهنمای گامبهگام پیکربندی «پردازشگرهای پیام» برای استفاده از سرایندهای تکراری استفاده کنید. - اگر کاربر «ابر عمومی» هستید، برای پیکربندی این دارایی برای سازمانتان با پشتیبانی 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