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

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

نشانه

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

پیام خطا

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

HTTP/1.1 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"response headers size exceeding 25,600",
      "detail":{
         "errorcode":"protocol.http.TooBigHeaders"
      }
   }
}

علل احتمالی

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

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

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

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

دلیل: اندازه سرایندهای پاسخ از حد مجاز بیشتر است

تشخیص

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

   پیام خطا

   برای راستی‌آزمایی بااستفاده از پیام خطا:

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

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

   "faultstring":"response headers size exceeding 25,600"

   در پیام خطای بالا، در faultstringتوجه کنید که پاسخ دارای سرایندهایی است که اندازه کل آن‌ها از حد مجاز فراتر رفته است.

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

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

   اگر به درخواست واقعی که به سرور هدف/زیرینه ارسال شده است دسترسی دارید، مراحل زیر را انجام دهید:

   1. اگر کاربر «ابر عمومی/ابر خصوصی» هستید، از سرور پشتیبان خود یا هر ماشین دیگری که اجازه دارید از آن به سرور پشتیبان درخواست ارسال کنید، مستقیماً به سرور پشتیبان درخواست ارسال کنید.
   2. اگر کاربر «ابر خصوصی» هستید، می‌توانید درخواست را از یکی از «پردازشگرهای پیام» به سرور زیرینه نیز ارسال کنید.
   3. پاسخ دریافتی از سرور زیرینه را بررسی کنید و به‌طور خاص اندازه کل سرایندهای ارسال‌شده در پاسخ را محاسبه و تأیید کنید.

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

      پاسخ نمونه از سرور مقصد:

      curl -v https://TARGET_SERVER_HOST/test
      

      * About to connect() to 10.1.0.10 port 9000 (#0)
      *   Trying 10.1.0.10...
      * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
      > GET /test HTTP/1.1
      > User-Agent: curl/7.29.0
      > Host: 10.1.0.10:9000
      > Accept: */*
      <
      < HTTP/1.1 200 OK
      < Accept-Ranges: bytes
      < Content-Length: 0
      < Content-Type: text/plain; charset=utf-8
      < Last-Modified: Tue, 20 Jul 2021 09:23:56 GMT
      < Testheader1: XVlBzgba—-<snipped>---THctcuAx
      < Testheader2: hxKQFDaFpLSj—-<snipped>---FbcXoEFfRsWxP
      < Date: Fri, 23 Jul 2021 09:51:22 GMT
      <
      * Connection #0 to host 10.1.0.10 left intact
      

      در مثال بالا، Testheader1 و Testheader2 اندازه‌های بزرگ‌تری دارند که دلیل این خطا است زیرا از حد مجاز در Apigee Edge فراتر رفته است.

   گزارش‌های «پردازشگر پیام»

   برای اعتبارسنجی بااستفاده از گزارش‌های «پردازشگر پیام»:

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

   1. گزارش‌های «پردازشگر پیام» را بررسی کنید:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. جستجو کنید تا ببینید آیا درطول مدت زمان خاصی 502 خطایی وجود دارد (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز درخواست‌هایی با 502 ناموفق هستند. می‌توانید از رشته جستجوی زیر استفاده کنید:

      grep -ri "response headers size exceeding"
      

   3. خطوطی از system.log مشابه با موارد زیر پیدا خواهید کرد. اندازه سرایندهای پاسخ ممکن است در مورد شما متفاوت باشد:

      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest rev:1
      messageid:r23ijb1b-1  NIOThread@1 ERROR HTTP.CLIENT -
      HTTPClient$Context$3.onException() :  ClientChannel[Connected:
      Remote:3.7.1.1:9000 Local:192.168.2.1:56098]@8414 useCount=1
      bytesRead=0 bytesWritten=207 age=640ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response headers size exceeding 25,600
      
      2021-07-23 08:25:12,307 org:myorg env:prod api:bigheadertest
      rev:1 messageid:r23ijb1b-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@31f3ef88, response headers size exceeding 25,600)

   4. به‌محض اینکه «پردازشگر پیام» پاسخ را از سرور پشتیبان/هدف دریافت کند و متوجه شود که اندازه کل سرایندها بیشتر از ۲۵ کیلوبایت است، متوقف می‌شود و این خطا را برمی‌گرداند:

      response headers size exceeding 25,600

      این خطا به این معنی است که اندازه کل سرایند بیشتر از ۲۵ کیلوبایت است و Apigee وقتی اندازه از حد مجاز ۲۵ کیلوبایت فراتر می‌رود با کد خطای protocol.http.TooBigHeaders خطا می‌دهد

وضوح

محدودیت‌ها

‫Apigee انتظار دارد که برنامه مشتری و سرور پشتیبان اندازه‌های سرایند بزرگ‌تر از حد مجاز را که در محدودیت‌های Apigee Edge برای «اندازه سرایند درخواست/پاسخ» مستند شده است ارسال نکنند.

1. اگر کاربر «ابر عمومی» هستید، حداکثر حد مجاز برای اندازه سرصفحه‌های «درخواست و پاسخ» همان‌طور که برای اندازه سرصفحه «درخواست/پاسخ» در محدودیت‌های Apigee Edge مستند شده است.
2. اگر کاربر «ابر خصوصی» هستید، ممکن است حد حداکثر پیش‌فرض برای اندازه سرصفحه‌های «درخواست» و «پاسخ» را تغییر داده باشید (اگرچه این کار توصیه نمی‌شود). با دنبال کردن دستورالعمل‌های نحوه بررسی محدودیت فعلی می‌توانید حداکثر محدودیت اندازه «سرایند پاسخ» را تعیین کنید.

چگونه حد فعلی را بررسی کنیم؟

این بخش توضیح می‌دهد که چگونه درستی‌سنجی کنید دارایی HTTPResponse.headers.limit با مقدار جدیدی در «پردازشگرهای پیام» به‌روز شده است.

1. در ماشین «پردازشگر پیام»، دارایی HTTPResponse.headers.limit را در /opt/apigee/edge-message-processor/conf دایرکتوری جستجو کنید و بررسی کنید چه مقداری تنظیم شده است، همان‌طور که در زیر نشان داده شده است:

   grep -ri "HTTPResponse.headers.limit" /opt/apigee/edge-message-processor/conf
   

2. نتیجه نمونه از فرمان بالا به این صورت است:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.headers.limit=25k

3. در برونداد مثال بالا، توجه کنید که دارایی HTTPResponse.headers.limit با مقدار 25k در http.properties تنظیم شده است.

   این خطا نشان می‌دهد که حد مجاز اندازه «بار پاسخ» پیکربندی‌شده در Apigee برای Private Cloud ۲۵ کیلوبایت است.

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

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

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

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

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

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

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

• گزارش‌های دسترسی 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