502 Bad Gateway - TooBigHeaders

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

علامت

برنامه سرویس گیرنده کد وضعیت HTTP 502 Bad Gateway با protocol.http.TooBigHeaders کد خطا را دریافت می کند.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. کد خطا ، منبع خطا و اندازه بار پاسخ را برای خطای مشاهده شده با استفاده از مانیتورینگ API، ابزار Trace، یا گزارش های دسترسی NGINX همانطور که در مراحل تشخیص رایج توضیح داده شده است، تعیین کنید.
2. اگر منبع خطا دارای مقدار target باشد، این نشان می‌دهد که پاسخ ارسال شده توسط سرور هدف/بک‌اند به Apigee دارای سرصفحه‌هایی است که اندازه آنها بیشتر از حد مجاز در Apigee Edge است.
3. با استفاده از یکی از روش‌های زیر می‌توانید تأیید کنید که پاسخ از هدف/بک‌اند دارای هدرهایی است که اندازه آنها بیشتر از حد مجاز است:

   پیغام خطا

   برای تأیید اعتبار با استفاده از پیام خطا:

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

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

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

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

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

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

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

   1. اگر کاربر عمومی Cloud/Private Cloud هستید، مستقیماً از سرور باطن یا هر دستگاه دیگری که از آنجا مجاز به ارائه درخواست به سرور باطن هستید، به سرور باطن درخواست دهید.
   2. اگر کاربر Private Cloud هستید، می توانید از یکی از پردازشگرهای پیام نیز درخواست را به سرور پشتیبان ارسال کنید.
   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 فراتر رفته است.

   گزارش های پردازشگر پیام

   برای تأیید اعتبار با استفاده از گزارش‌های پردازشگر پیام:

   اگر کاربر Private Cloud هستید، می‌توانید از گزارش‌های پردازشگر پیام برای تأیید اینکه اندازه سرصفحه‌های پاسخ از حد مجاز در 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. به محض اینکه پردازشگر پیام پاسخی را از سرور باطن/هدف دریافت کرد و متوجه شد که حجم کل هدرها بیشتر از 25 کیلوبایت است، متوقف می شود و خطا را می اندازد:

      response headers size exceeding 25,600

      به این معنی است که حجم کل سرصفحه بیش از 25 کیلوبایت است و Apigee خطا را زمانی که اندازه شروع به تجاوز از حد مجاز 25 کیلوبایت می کند با کد خطا به عنوان protocol.http.TooBigHeaders پرتاب می کند.http.TooBigHeaders

قطعنامه

محدودیت ها

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

1. اگر کاربر Public Cloud هستید، حداکثر محدودیت برای اندازه سرصفحه Request و Response مطابق با اندازه Request/Response Header در Apigee Edge Limits است.
2. اگر کاربر Private Cloud هستید، ممکن است حداکثر حد پیش‌فرض برای اندازه سرصفحه‌های درخواست و پاسخ را تغییر داده باشید (حتی اگر این یک عمل توصیه‌شده نیست). می‌توانید حداکثر محدودیت اندازه سرصفحه پاسخ را با دنبال کردن دستورالعمل‌های نحوه بررسی محدودیت فعلی تعیین کنید.

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

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

1. در دستگاه Message Processor، ویژگی 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 25 کیلوبایت است.

اگر همچنان به کمک پشتیبانی Apigee نیاز دارید، به Must collect information diagnostic بروید.

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

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

اگر کاربر Public Cloud هستید، اطلاعات زیر را ارائه دهید:

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

اگر کاربر Private Cloud هستید، اطلاعات زیر را ارائه دهید:

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