431 İstek Başlığı Alanları Çok Büyük - TooBigHeaders

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Belirti

İstemci uygulaması, API çağrılarına yanıt olarak 431 Request Header Fields Too Large HTTP durum kodunu ve protocol.http.TooBigHeaders hata kodunu alır.

Hata mesajı

İstemci uygulaması aşağıdaki yanıt kodunu alır:

HTTP/1.1 431 Request Header Fields Too Large

Ayrıca aşağıdaki hata mesajını da görebilirsiniz:

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

Olası nedenler

Bu hata, istemci uygulaması tarafından HTTP isteğinin bir parçası olarak Apigee Edge'e gönderilen tüm istek başlıklarının toplam boyutu, RFC 6585, bölüm 5: 431 Request Header Fields Too Large uyarınca Apigee Edge'deki izin verilen sınırı aştığında oluşur.

Bu hatanın olası nedenleri şunlardır:

Sık karşılaşılan teşhis adımları

Bu hatayı teşhis etmek için aşağıdaki araçlardan/tekniklerden birini kullanın:

Neden: İstek başlıklarının boyutu, izin verilen sınırı aşıyor.

Teşhis

1. Ortak teşhis adımları bölümünde açıklandığı gibi, API izleme veya NGINX erişim günlükleri kullanılarak gözlemlenen hata için Hata Kodu, Hata Kaynağı ve İstek Uzunluğu boyutunu belirleyin.
2. Hata Kaynağı değeri apigee veya MP ise, Hata Kodu değeri protocol.http.TooBigHeaders ise ve İstek Uzunluğu 25 KB'tan fazlaysa bu durum, istemci uygulaması tarafından Apigee'ye gönderilen istek boyutunun Apigee Edge'deki izin verilen sınırdan daha büyük olduğunu gösterir.
3. Aşağıdaki yöntemlerden birini kullanarak istek başlıklarının boyutunun izin verilen 25 KB sınırını aştığını doğrulayabilirsiniz:

   Hata mesajı

   Hata mesajını kullanarak doğrulamak için:

   Apigee Edge'den alınan hata mesajının tamamına erişiminiz varsa faultstring bölümüne bakın. faultstring, İstek Başlıklarının toplam boyutunun izin verilen 25 KB sınırını aştığını gösterir.

   Örnek hata mesajı:

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

   Gerçek istek

   Gerçek isteği kullanarak doğrulamak için:

   İstemci uygulaması tarafından yapılan gerçek isteğe erişiminiz varsa aşağıdaki adımları uygulayın:

   1. İstekte iletilen başlıkların boyutunu doğrulayın.

   2. Başlıkların toplam boyutunun Apigee Edge'de izin verilen sınırı aştığını görürseniz sorunun nedeni budur.

      Örnek istek:

      curl -v https://HOSTALIAS/test -H "header0: 000000000000000000……..000000<trimmed>" -H "header1: 111111111111111111……..111111<trimmed>" -H "header2: 222222222222222222……..222222<trimmed>"-H "header3: 333333333333333333……..333333<trimmed>"
      

      Yukarıdaki örnekte, header0, header1, header2 ve header3 üstbilgilerinin toplam boyutu 25 KB'tan fazla. Yani 25.000'den fazla ASCII karakteri (bayt) içeriyor.

      Başka bir istemci kullanıyorsanız istemci günlüklerini inceleyebilir ve Apigee Edge'e gönderilen istek satırının boyutunu bulmaya çalışabilirsiniz.

   Mesaj işleyici günlükleri

   Mesaj İşleyici günlüklerini kullanarak doğrulamak için:

   Özel Cloud kullanıcısıysanız İstek Başlıkları boyutunun Apigee Edge'deki izin verilen sınırı aşıp aşmadığını doğrulamak için Mesaj İşleyici günlüklerini kullanabilirsiniz.

   1. Mesaj İşleyici günlüklerini kontrol edin:

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

   2. Belirli bir süre boyunca (sorun geçmişte yaşandıysa) 431 hataları olup olmadığını veya 431 ile hâlâ başarısız olan istekler olup olmadığını kontrol edin. Aşağıdaki arama dizelerini kullanabilirsiniz.

      grep -ri "exceeding"
      

      grep -ri "RequestHeadersTooLarge"
      

   3. system.log ile ilgili aşağıdaki gibi satırlar görürsünüz:

      2021-07-27 08:30:28,419  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() :
      Request:GET, uri:/test/, message Id:null,
      exception:com.apigee.errors.http.user.RequestHeadersTooLarge{
      code = protocol.http.TooBigHeaders, message = request headers size
      exceeding 25,600, associated contexts = []}, context:Context@9c5903
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.205.251:8443 Local:192.168.67.23:22188]@25130
      useCount=1 bytesRead=0 bytesWritten=15367 age=667062ms  lastIO=0ms
      isOpen=true)

      Yukarıdaki hata mesajında yer alan message = request headers size exceeding 25,600 metni, toplam istek üstbilgileri boyutunun 25 KB'tan fazla olduğunu gösterir. Bu nedenle, Apigee Edge com.apigee.errors.http.user.RequestHeadersTooLarge istisnasını oluşturur ve protocol.http.TooBigHeaders hata koduyla 431 durum kodunu istemci uygulamalarına döndürür.

Çözünürlük

Sınırlar

Apigee, istemci uygulamasının ve arka uç sunucusunun, Apigee Edge Sınırları'nda İstek/Yanıt Başlığı Boyut Sınırı için belgelendiği gibi izin verilen sınırı aşan boyutlarda İstek/Yanıt Başlıkları göndermemesini bekler.

1. Herkese açık bulut kullanıcısıysanız İstek ve Yanıt Başlıkları boyutu için maksimum sınır, Apigee Edge Sınırları'nda İstek/Yanıt Başlığı boyutu için belirtilen sınırdır.
2. Özel bulut kullanıcısıysanız İstek ve Yanıt Başlıkları boyutu için varsayılan maksimum sınırı değiştirmiş olabilirsiniz (önerilen bir uygulama olmasa da). Geçerli sınırı kontrol etme başlıklı makaledeki talimatları uygulayarak maksimum istek başlığı boyutu sınırını belirleyebilirsiniz.

Mevcut sınır nasıl kontrol edilir?

Bu bölümde, tesisin HTTPRequest.headers.limit Mesaj İşleyiciler'de yeni bir değerle güncellendiğinin nasıl doğrulanacağı açıklanmaktadır.

1. Mesaj İşleyici makinesinde, HTTPRequest.headers.limit özelliğini /opt/apigee/edge-message-processor/conf dizininde arayın ve aşağıdaki gibi hangi değerin ayarlandığını kontrol edin:

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

2. Yukarıdaki komutun örnek sonucu aşağıdaki gibidir:

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

3. Yukarıdaki örnek çıktıda, HTTPRequest.headers.limit özelliğinin http.properties içinde 25k değeriyle ayarlandığını unutmayın.

   Bu, Apigee'de Private Cloud için yapılandırılan istek başlığı boyutu sınırının 25 KB olduğunu gösterir.

Spesifikasyon

Apigee Edge, istemci uygulamasının istek kapsamında büyük boyutlu başlıklar göndermemesini bekler. İstek, belirtilen sınırdan daha büyük bir toplam boyuta sahip başlıklar içeriyorsa Apigee, aşağıdaki RFC spesifikasyonlarına göre 431 Request Header Fields Too Large hatasını verir:

Apigee Destek Ekibi'nden hâlâ yardıma ihtiyacınız varsa Toplanması gereken teşhis bilgileri başlıklı makaleyi inceleyin.

Teşhis bilgilerini toplamalıdır

Aşağıdaki teşhis bilgilerini toplayın ve ardından Apigee Edge Destek Ekibi ile iletişime geçin:

Herkese açık bulut kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Kuruluş adı
• Ortam adı
• API proxy'si adı
• 431 hatasını yeniden oluşturmak için kullanılan curl komutunun tamamı
• API istekleri için izleme dosyası

Private Cloud kullanıcısıysanız aşağıdaki bilgileri sağlayın:

• Başarısız olan istekler için gözlemlenen hata mesajının tamamı
• Kuruluş adı
• Ortam adı
• API proxy paketi
• Başarısız olan API isteklerinin izleme dosyası
• 431 hatasını yeniden oluşturmak için kullanılan curl komutunun tamamı

• NGINX erişim günlükleri /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Nerede: ORG, ENV ve PORT# gerçek değerlerle değiştirilir.

• Mesaj İşleyici sistem günlükleri /opt/apigee/var/log/edge-message-processor/logs/system.log