Çalışma zamanı hata kataloğu

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

Apigee Edge'deki hatalar

API istekleri Apigee Edge üzerinden yapıldığında Apigee Edge bileşenleri Yönlendiriciler ve Mesaj İşleyiciler ya da arka uç sunucular istemci uygulamalarına hata döndürebilir.

Mesaj işleyiciden gelen hatalar

İleti İşleyen, Apigee Edge'in politikaları işleyen ve arka uç sunucularla etkileşime geçen temel bileşenidir. Aşağıdaki gibi sorunlar tespit ederse hata döndürebilir:

  • Ağ bağlantısı sorunları, TLS el sıkışma hataları, arka uç sunucusunun kullanılamaması, arka uç sunucusuyla iletişim sırasında yanıt verilmemesi
  • Politikanın uygulanması sırasındaki hatalar
  • Geçersiz HTTP üst bilgileri, kodlama, yol, HTTP spesifikasyonlarına uyulmaması, ürün sınırlarının aşılması vb.:
    • İstemci uygulamaları tarafından gönderilen HTTP isteğiyle

      • VEYA

    • Arka uç sunucusu tarafından gönderilen HTTP yanıtıyla
  • Ve daha fazlası

Mesaj işleyiciden örnek hata

Mesaj İşleyen her zaman bir HTTP durum kodu, ardından JSON biçiminde bir hata kodu ve hata mesajı döndürür.

İstemci uygulaması aşağıdaki örnekteki gibi bir yanıt kodu alır: 

HTTP/1.1 414 Request-URI Too Long

İleti İşleyici'den gelen bir hata yanıtı aşağıdaki biçimde görünür: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Hata yanıtındaki alanların açıklaması:

Alan Açıklama
faultstring Hatanın olası nedenini açıklayan hata mesajını içerir
errorcode Hatayla ilişkili hata kodu (arıza kodu olarak da bilinir)

Çalışma zamanı hatası kataloğu

Bu hata kataloğunda, Apigee Edge Mesaj İşlemci bileşeni tarafından döndürülen çalışma zamanı hata kodları (politika dışı hatalar için) hakkında bilmeniz gereken tüm bilgiler yer alır. Her bir hata kodu için aşağıdaki bilgileri içerir:

  • HTTP durum kodu
  • Hata mesajı
  • Hatanın olası nedenleri
  • İlişkili tüm HTTP spesifikasyonları ve/veya ürün sınırları
  • Hatanın nedenini teşhis etme talimatları ve hatayı kendiniz çözmek için uygulayabileceğiniz etkili çözümler (varsa) içeren rehberler ve videolar
  • Hatayı kendiniz çözmek için uygulayabileceğiniz düzeltme

Aşağıdaki hata kodu kategorileri ele alınmıştır:

Belirli bir hata koduyla ilgili yukarıdaki bilgileri görüntülemek için tabloyu filtrelemek üzere aşağıdaki Arama kutusunu kullanın. Tablodaki herhangi bir alanda durum kodunu veya herhangi bir içeriği arayabilirsiniz.

Hata kodu Açıklama Düzelt

flow.*

flow.APITimedOut
  • HTTP durum kodu:
 504 Gateway Timeout
  • Hata mesajı:
 API timed out
  • Olası neden:

Bu hata aşağıdaki durumlarda oluşur:

  • Arka uç sunucu, belirli bir API Proxy için mülk tarafından yapılandırılan zaman aşımı süresi içinde yanıt vermez. api.timeout
  • Yoğun işlem gerektiren işlemler, yüksek yük veya düşük performans nedeniyle politikanın uygulanması uzun sürüyor.

Not: Bu başucu kitabı, messaging.adaptors.http.flow.GatewayTimeout hata kodunun sorunlarını gidermeyle ilgili talimatlar sağlar. Ancak flow.APITimedOut hata kodunun sorunlarını gidermek için de aynı başucu kitabını kullanabilirsiniz.

BAŞUCU KİTABI

flow.SharedFlowNotFound
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Shared Flow {shared_flow_name} Not Found
  • Olası neden:

Bu hata, belirli bir paylaşılan akış:

  • Mevcut değil

    • VEYA

  • Var ancak dağıtılmadı
BAŞUCU KİTABI

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • HTTP durum kodu:
 404 Not Found
  • Hata mesajı:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Olası neden:

Bu hata aşağıdaki senaryolardan birinde ortaya çıkar:

  1. Söz konusu API proxy'si:
    1. Belirli bir Sanal Ana Makinede istekleri kabul edecek şekilde Yapılandırılmadı
    2. İstekte kullanılan belirli yoldaki istekleri kabul edecek şekilde yapılandırılmamış
    3. API istekleri yapmaya çalıştığınız belirli ortamda DAĞITILMAZ
    4. Bir veya daha fazla Mesaj İşleyicisine DAĞITILMADI
  2. API isteklerini göndermeye çalıştığınız belirli ortam, bir veya daha fazla Mesaj İşleyiciye yüklenmemiş
 BAŞUCU KİTABI
Bu hata, birden fazla sanal ana makine aynı ana makine takma adına ve bağlantı noktası numarasına sahip olduğunda da oluşabilir. BAŞUCU KİTABI

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Decompression failure at request
  • Olası neden:

Bu hata yalnızca aşağıdaki durumlarda oluşur:

  • HTTP istek başlığında belirtilen kodlama Content-Encoding geçerlidir ve Apigee Edge tarafından desteklenir.

    • ANCAK

  • İstemci tarafından HTTP isteği kapsamında gönderilen yük biçimi, Content-Encoding başlığında belirtilen kodlama biçimiyle eşleşmiyor
BAŞUCU KİTABI

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Decompression failure at response
  • Olası neden:

Bu hata yalnızca aşağıdaki durumlarda ortaya çıkar:

  • Arka uç/hedef sunucunun HTTP yanıt başlığında Content-Encoding belirtilen kodlama geçerlidir ve Apigee Edge tarafından desteklenir.

    • ANCAK

  • Arka uç/hedef sunucu tarafından HTTP yanıtının bir parçası olarak gönderilen yığın biçimi, Content-Encoding üstbilgisinde belirtilen kodlama biçimiyle eşleşmiyor
BAŞUCU KİTABI

messaging.adaptors.http.flow.ErrorResponseCode
  • HTTP durum kodu:
 500

BAŞUCU KİTABI

VİDEO

  • Hata mesajı:
 Hata mesajı ve biçimi, arka uç sunucu uygulamasına bağlı olarak değişebilir.
  • Olası neden:
 Bu hata, arka uç sunucusu Apigee Edge'e 500 durum koduyla yanıt verirse oluşur.
  • HTTP durum kodu:
 503

BAŞUCU KİTABI

VİDEO

  • Hata mesajı:
 Hata mesajı ve biçimi, arka uç sunucu uygulamasına bağlı olarak değişebilir.
  • Olası neden:
 Bu hata, arka uç sunucusu Apigee Edge'e 503 durum koduyla yanıt verirse meydana gelir.
  • HTTP durum kodu:
 504 BAŞUCU KİTABI
  • Hata mesajı:
 Hata mesajı ve biçimi, arka uç sunucu uygulamasına bağlı olarak değişebilir.
  • Olası neden:
 Bu hata, arka uç sunucusu Apigee Edge'e 504 durum koduyla yanıt verirse meydana gelir.

Not: İstemci uygulamalarına gönderilen hata mesajının bir parçası olarak messaging.adaptors.http.flow.ErrorResponseCode hata kodu döndürülmez. Bunun nedeni, arka uç sunucusu bir hatayla veya 4XX ya da 5XX durum kodlarından herhangi biriyle yanıt verdiğinde bu hata kodunun Apigee Edge tarafından ayarlanmasıdır. Bu hata kodunu API İzleme, NGINX erişim günlüklerinde veya analiz veritabanında görüntüleyebilirsiniz.

messaging.adaptors.http.flow.GatewayTimeout
  • HTTP durum kodu:
 504 Gateway Timeout
  • Hata mesajı:
 Gateway Timeout
  • Olası neden:
 Bu hata, arka uç sunucusu, İleti İşleyicide yapılandırılmış G/Ç zaman aşımı süresi içinde Apigee Edge İleti İşleyici'ye yanıt vermezse oluşur.
PLAYBOOK

messaging.adaptors.http.flow.LengthRequired
  • HTTP durum kodu:
 411 Length Required
  • Hata mesajı:
 'Content-Length' is missing
  • Olası neden:

Bu hata, Content-Length üstbilgisi, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP POST ve PUT isteklerinin bir parçası olarak iletilmezse ortaya çıkar.

Not: Mesaj İşleyici bu doğrulamayı isteği işlemeden ve API Proxy'de herhangi bir politikayı yürütmeden çok önce, çok erken bir aşamada gerçekleştirdiği için bu hatayla başarısız olan istekler, izleme aracında yakalanamaz.
  • HTTP Spesifikasyonu:
 RFC Bölüm 3.3.2: Content-Length

Düzelt

Bu hatayı gidermek için aşağıdaki adımları uygulayın:

  1. İstemci uygulamasının, Apigee Edge'e gönderilen HTTP POST ve PUT isteklerinin bir parçası olarak her zaman Content-Length başlığını ilettiğinden emin olun. Örneğin:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. POST ve PUT istekleriyle boş bir yük iletiyor olsanız bile Content-Length: 0 başlığının iletildiğinden emin olun. Örneğin:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 The Service is temporarily unavailable
  • Olası neden:

Apigee Edge'de TargetServer kullanıyorsanız bu hata aşağıdaki senaryolardan birinde ortaya çıkar:

  1. Özel yetkilendirme sunucusu tarafından arka uç sunucu ana makinesinin yanlış DNS çözümlemesi, bağlantı hatalarına yol açan kötü IP adreslerine neden oldu.
  2. Aşağıdaki nedenlerle bağlantı zaman aşımı hataları var:
    1. Arka uç sunucusundaki güvenlik duvarı kısıtlaması, Apigee Edge'in arka uç sunucusuna bağlanmasını engelliyor.
    2. Apigee Edge ile arka uç sunucu arasında ağ bağlantısı sorunları
  3. TargetServer'da belirtilen ana makine yanlıştır veya istenmeyen karakterler (ör. boşluk) içerir.

BAŞUCU KİTABI

VİDEO
Bu hata, hedef sunucuların durum denetimini izlemek için yapılandırılan durum denetimleri başarısız olduğunda da ortaya çıkabilir.

BAŞUCU KİTABI

VİDEO

messaging.adaptors.http.flow.RequestTimeOut
  • HTTP durum kodu:
 408 Request Timeout
  • Hata mesajı:
 Request timed out
  • Olası neden:
 Bu hata, Apigee Edge Mesaj İşleyicisi Mesaj İşleyici bileşeninde yapılandırılan G/Ç zaman aşımı süresi boyunca istemci uygulamadan istek yükü almazsa ortaya çıkar.

Düzelt

İstemci uygulamasının, istek yükünü Apigee Edge'in Mesaj İşleyici bileşeninde yapılandırılan G/Ç zaman aşımı süresi içinde gönderdiğinden emin olun.

messaging.adaptors.http.flow.ServiceUnavailable
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 The Service is temporarily unavailable
  • Olası neden:

Bu hata aşağıdaki senaryolardan birinde ortaya çıkar:

  1. Özel yetkilendirme sunucusunun arka uç sunucu ana makinesini yanlış DNS çözümlemesi, hatalı IP adreslerine yol açarak bağlantı hatalarına neden oldu.
  2. Aşağıdakiler nedeniyle bağlantı zaman aşımı hataları:
    1. Arka uç sunucusunda güvenlik duvarı kısıtlaması, Apigee Edge'in arka uç sunucusuna bağlanmasını engeller.
    2. Apigee Edge ile arka uç sunucu arasında ağ bağlantısı sorunları.
  3. Hedef uç noktada belirtilen hedef sunucu ana makinesi yanlıştır veya istenmeyen karakterler (ör. boşluk) içerir.

BAŞUCU KİTABI

DNS hatası:

VİDEO

Ağ bağlantısı:

VİDEO
Mesaj İşleyici, istek yükünü arka uç sunucusuna göndermeye devam ederken arka uç sunucusu bağlantıyı erkenden kapatırsa da bu hata oluşabilir. BAŞUCU KİTABI

messaging.adaptors.http.flow.SslHandshakeFailed
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 SSL Handshake failed {error_message}
  • Olası neden:

Bu hata, aşağıdaki durumlarda Apigee Edge'in Mesaj İşlemcisi ile arka uç sunucu arasında SSL el sıkışma işlemi sırasında ortaya çıkar:

  1. Apigee Edge'in Mesaj İşlemcisinin güven mağazası:
    • Arka uç sunucusunun tam sertifika zinciriyle eşleşmeyen bir sertifika zinciri içeriyor

      • VEYA

    • Arka uç sunucunun tam sertifika zincirini içermiyor
  2. Arka uç sunucusu tarafından sunulan sertifika zinciri:
    • Hedef uç noktada belirtilen ana makine adıyla eşleşmeyen bir tam nitelikli alan adı (FQDN) içeriyor

      • VEYA

    • Yanlış/eksik sertifika zinciri içeriyor

BAŞUCU KİTABI

VİDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Unexpected EOF at target
  • Olası neden:

Bu hata, aşağıdaki senaryolardan birinde ortaya çıkar:

  1. TargetServer, Apigee Edge'de TLS/SSL bağlantılarını destekleyecek şekilde düzgün yapılandırılmamış.
  2. Apigee Edge, arka uç sunucudan yanıt beklerken arka uç sunucusu bağlantıyı aniden kapatabilir.
  3. Apigee ve arka uç sunucusunda yanlış yapılandırılmış canlı zaman aşımlarını koruyun.
PLAYBOOK

messaging.runtime.*

messaging.runtime.RouteFailed
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Unable to route the message to a TargetEndpoint
  • Olası neden:

Bu hata, Apigee Edge'in isteği TargetEndpoint'lerden herhangi birine yönlendiremediği durumlarda ortaya çıkar. Bunun nedeni:

  • Proxy'deki istekle eşleşen bir yol kuralı (<RouteRule>) koşulu yok

    • VE

  • ProxyEndpoint'te varsayılan bir yönlendirme kuralı tanımlanmamış (ör. <RouteRule> koşulu olmadan)

Düzelt

Bu hatayı gidermek için aşağıdaki talimatları uygulayın:

  1. ProxyEndpoint'inizde tanımlanan rota kurallarını inceleyin ve isteğinizle eşleşen en az bir rota kuralı koşulu bulunduğundan emin olmak için değiştirin.
  2. Birden fazla RouteRule'unuz varsa koşul içermeyen bir varsayılan yol kuralı tanımlamak iyi bir uygulamadır.
  3. Kurallar ProxyEndpoint'te yukarıdan aşağıya doğru değerlendirildiği için varsayılan rota kuralının her zaman koşullu rotalar listesinde en son tanımlandığından emin olun.

ProxyEndpoint'te <RouteRule> koşullarını tanımlama hakkında daha fazla bilgi edinmek için Koşullu Hedefler başlıklı makaleyi inceleyin.

messaging.runtime.SenseRaiseFault
  • HTTP durum kodu:
 403 Forbidden
  • Hata mesajı:
 Sense Fault
  • Olası neden:
 Bu hata, Apigee Sense kuralları kapsamında engellenen belirli bir istemci IP adresinden API isteği gönderilirse ortaya çıkar.

Düzelt

Bu hatayı gidermek için aşağıdaki talimatları uygulayın:

  1. Apigee Sense'te yapılandırılmış kuralları kontrol ederek belirli bir istemci IP adresini engellediğinizi doğrulayın. Engellenmişse bu, tasarlandığı şekilde çalıştığı anlamına gelir.
  2. Belirli istemci IP adresi engellenmemişse ancak bu hatayı almaya devam ediyorsanız Apigee Edge Destek Ekibi ile iletişime geçin.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Bad Form Data
  • Olası neden:

Bu hata yalnızca aşağıdaki koşulların tümü karşılanırsa ortaya çıkar:

  1. İstemci tarafından Apigee Edge'e gönderilen HTTP isteği şunları içerir:
    • Content-Type: application/x-www-form-urlencoded, ve
    • Yüzde işareti (%) veya yüzde işareti (%) ve ardından, Formlar - Bölüm 17.13.4.1 uyarınca izin verilmeyen geçersiz onaltılık karakterlerin bulunduğu form verileri.
  2. Apigee Edge'deki API proxy'si, istek akışında ExtractVariables veya Ataması politikasını kullanarak izin verilmeyen karakterleri içeren belirli form parametrelerini okur.
BAŞUCU KİTABI

protocol.http.DuplicateHeader
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Duplicate Header "{header_name}"
  • Olası neden:
 Bu hata, Apigee Edge'de yinelemesine izin verilmeyen belirli bir HTTP üstbilgisinin, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteğinin bir parçası olarak aynı veya farklı değerlerle birden fazla kez görünmesi durumunda ortaya çıkar.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2.2: Alan Sırası
PLAYBOOK

protocol.http.EmptyHeaderName
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header name cannot be empty
  • Olası neden:
 Bu hata, istemci uygulamasının Apigee Edge'e HTTP isteği kapsamında gönderdiği üstbilgi adı boşsa meydana gelir.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2: Üstbilgi Alanları

Düzelt

İstemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteğinin, RFC 7230, bölüm 3.2: Üst Bilgi Alanları uyarınca her zaman geçerli bir üst bilgi adı içerdiğinden emin olun.

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header {header_name} contains non ascii character {character}
  • Olası neden:
 Bu hata, istemci uygulamasının Apigee Edge'e HTTP isteği kapsamında gönderdiği üstbilgi adı ASCII dışı karakterler içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üst Bilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

İstemcinin Apigee Edge'e gönderdiği HTTP isteğinin, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri uyarınca üst bilgi adlarında ASCII dışı karakterler içermediğinden emin olun.

protocol.http.HeaderWithInvalidChar
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Header {header_name} contains invalid character {character}
  • Olası neden:
 Bu hata, istemci uygulamasının Apigee Edge'e HTTP isteği kapsamında gönderdiği üstbilgi adı eşittir (=), virgül (,), noktalı virgül (;), sekme, CRLF ve satır sonu karakteri gibi geçersiz karakterler içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üst Bilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

İstemci uygulamasının Apigee Edge'e gönderdiği HTTP isteğinin, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri uyarınca üst bilgi adlarında geçersiz karakterler içermediğinden emin olun.

protocol.http.InvalidPath
  • HTTP durum kodu:
 400 Bad Request
  • Hata mesajı:
 Invalid path {path}
  • Olası neden:
 Bu hata, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP istek URL'sindeki yol, RFC 3986, bölüm 3.3: Yol spesifikasyonuna göre izin verilmeyen karakterler içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz dizimi bileşenleri ve RFC 3986, bölüm 3.3: Yol

Düzelt

İstemci uygulaması tarafından Apigee Edge'e gönderilen HTTP istek URL'sindeki yolun, RFC 3986, bölüm 3.3: Yol uyarınca izin verilmeyen karakterler içermediğinden emin olun.

protocol.http.TooBigBody
  • HTTP durum kodu:
 413 Request Entity Too Large
  • Hata mesajı:
 Body buffer overflow
  • Olası neden:
 Bu hata, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteği kapsamındaki yük boyutu Apigee Edge'de izin verilen sınırdan büyükse ortaya çıkar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigHeaders
  • HTTP durum kodu:
 431 Request Header Fields Too Large
  • Hata mesajı:
 request headers size exceeding {limit}
  • Olası neden:
 İstemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteğinin bir parçası olarak gönderilen tüm istek başlıklarının toplam boyutu, Apigee Edge'de izin verilen sınırdan daha büyüktür.
  • HTTP Spesifikasyonu:
 RFC 6585, bölüm 5: 431 İstek Üstbilgisi Alanları Çok Büyük
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigLine
  • HTTP durum kodu:
 414 Request-URI Too Long
  • Hata mesajı:
 request line size exceeding {limit}
  • Olası neden:
 Bu hata, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteği kapsamındaki istek satırının boyutu Apigee Edge'de izin verilen sınırdan büyükse ortaya çıkar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.UnsupportedEncoding
  • HTTP durum kodu:
 415 Unsupported Media
  • Hata mesajı:
 Unsupported Encoding "{encoding}"
  • Olası neden:
 Bu hata, istemci tarafından HTTP yanıtının bir parçası olarak gönderilen Content-Encoding üstbilgisi, Apigee Edge tarafından desteklenmeyen bir kodlama/yük biçimi içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.5.13: 415 Desteklenmeyen Ortam Türü
BAŞUCU KİTABI

protocol.http.* - Caused by target

protocol.http.BadPath
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Invalid request path
  • Olası neden:
 Bu hata, target.url akış değişkeniyle temsil edilen arka uç sunucusunun istek URL'si, düz eğik çizgi (/) yerine soru işareti (?) ile başlayan bir yol içeriyorsa ve bu, geçersiz anlamına gelir.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz dizimi bileşenleri ve RFC 3986, bölüm 3.3: Yol
BAŞUCU KİTABI

protocol.http.DuplicateHeader
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Duplicate Header "{header_name}"
  • Olası neden:
 Bu hata, Apigee Edge'de yinelenen olmasına izin verilmeyen belirli HTTP üstbilgisi, arka uç sunucusu tarafından Apigee Edge'e gönderilen HTTP yanıtının bir parçası olarak aynı veya farklı değerlerle birden fazla kez göründüğünde ortaya çıkar.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2.2: Alan Sırası
BAŞUCU KİTABI

protocol.http.EmptyHeaderName
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header name cannot be empty
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından Apigee Edge'e gönderilen HTTP yanıtının bir parçası olarak üst bilgi adı boşsa meydana gelir.
  • HTTP Spesifikasyonu:
 RFC 7230, bölüm 3.2: Üst Bilgi Alanları

Düzelt

Arka uç sunucusunun Apigee Edge'e gönderdiği HTTP yanıtının, RFC 7230, bölüm 3.2: Üst Bilgi Alanları uyarınca her zaman geçerli bir üst bilgi adı içerdiğinden emin olun.

protocol.http.EmptyPath
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 Request path cannot be empty
  • Olası neden:
 Bu hata, target.url akış değişkeni ile temsil edilen arka uç sunucusunun HTTP istek URL'si boş bir yol içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:

RFC 3986, bölüm 3: Söz dizimi bileşenleri ve RFC 3986, bölüm 3.3: Yol
BAŞUCU KİTABI

protocol.http.HeaderNameWithNonAsciiChar
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header {header_name} contains non ascii character {character}
  • Olası neden:
 Bu hata, Apigee Edge'e gönderilen HTTP yanıtının bir parçası olarak arka uç sunucusu tarafından gönderilen başlık adı ASCII dışı karakterler içeriyorsa ortaya çıkar.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üstbilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

Apigee Edge'e gönderilen arka uç sunucusunun HTTP yanıtının, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri uyarınca başlık adlarında ASCII olmayan karakterler içermediğinden emin olun.

protocol.http.HeaderWithInvalidChar
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Header {header_name} contains invalid character {character}
  • Olası neden:
 Bu hata, HTTP yanıtının bir parçası olarak arka uç sunucusu tarafından gönderilen başlık adı eşittir (=), virgül (,), noktalı virgül (;), sekme, CRLF ve satır sonu karakteri gibi geçersiz karakterler içeriyorsa meydana gelir.
  • HTTP Spesifikasyonu:

RFC 7230, bölüm 3.2: Üst Bilgi Alanları ve RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri

Düzelt

Arka uç sunucunun Apigee Edge'e gönderdiği HTTP yanıtının, RFC 7230, bölüm 3.2.6: Alan Değeri Bileşenleri uyarınca üst bilgi adlarında geçersiz karakterler içermediğinden emin olun.

protocol.http.ProxyTunnelCreationFailed
  • HTTP durum kodu:
 503 Service Unavailable
  • Hata mesajı:
 Proxy refused to create tunnel with response status {status code}
  • Olası neden:

Bu hata; güvenlik duvarı, EKL (Erişim Kontrol Listesi), DNS sorunları, arka uç sunucusunun kullanılabilirliği vb. nedenlerle proxy sunucu tarafından Apigee Edge ile arka uç sunucu arasında tünel oluşturulurken meydana gelir.

Not: Hata mesajındaki durum kodu (faultstring), sorunun genel nedenini belirtir.
BAŞUCU KİTABI

protocol.http.Response306Reserved
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Response Status code 306 is reserved, so can't be used.
  • Olası neden:

Bu hata, arka uç sunucusu Apigee Edge'e 306 durum koduyla yanıt verirse oluşur.

306 durum kodu, HTTP spesifikasyonunun önceki bir sürümünde tanımlanmıştır. Mevcut HTTP spesifikasyonuna göre bu kod ayrılmıştır ve kullanılmamalıdır.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.3.5: 306 Ayrılmış

Düzelt

306 durum kodu ayrılmış olduğundan, arka uç sunucunuzun Apigee Edge'e yanıt gönderirken bu durum kodunu kullanmadığından emin olun.

protocol.http.Response405WithoutAllowHeader
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Received 405 Response without Allow Header
  • Olası neden:
 Arka uç sunucusu, "İzin ver" başlığı olmadan 405 Method Not Allowed durum koduyla yanıt verir.
  • HTTP Spesifikasyonu:

RFC 7231, bölüm 6.5.5: 405 Yönteme İzin Verilmiyor ve RFC 7231, bölüm 7.4.1: İzin Ver
BAŞUCU KİTABI

protocol.http.ResponseWithBody
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Received {status_code} Response with message body
  • Olası neden:

Bu hata, arka uç sunucusundan Apigee Edge'e gönderilen HTTP yanıtı 204 No Content ya da 205 Reset Content olmasına rağmen yanıt gövdesini ve/veya aşağıdaki üstbilgilerden birini veya birkaçını içeriyorsa ortaya çıkar:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • HTTP Spesifikasyonu:

RFC 7231, bölüm 6.3.5: 204 İçerik Yok ve RFC 7231, bölüm 6.3.6: 205 İçeriği Sıfırla
BAŞUCU KİTABI

protocol.http.TooBigBody
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 Body buffer overflow
  • Olası neden:
 Bu hata, istemci uygulaması tarafından Apigee Edge'e gönderilen HTTP isteği kapsamındaki yük boyutu Apigee Edge'de izin verilen sınırdan büyükse ortaya çıkar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigHeaders
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 response headers size exceeding {limit}
  • Olası neden:
 Bu hata, Apigee Edge'e gönderilen HTTP yanıtının bir parçası olarak arka uç sunucusu tarafından gönderilen tüm yanıt başlıklarının toplam boyutu Apigee Edge'de izin verilen sınırdan büyükse ortaya çıkar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.TooBigLine
  • HTTP durum kodu:
 502 Bad Gateway
  • Hata mesajı:
 response line size exceeding {limit}
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından Apigee Edge'e gönderilen HTTP yanıtının bir parçası olarak gönderilen yanıt satırının boyutu Apigee Edge'de izin verilen sınırdan daha büyükse ortaya çıkar.
  • Sınırlar:
 Apigee Edge Sınırları
BAŞUCU KİTABI

protocol.http.UnsupportedEncoding
  • HTTP durum kodu:
 415 Unsupported Media
  • Hata mesajı:
 Unsupported Encoding "{encoding}"
  • Olası neden:
 Bu hata, arka uç sunucusu tarafından HTTP yanıtının bir parçası olarak gönderilen Content-Encoding üst bilgisi, Apigee Edge tarafından desteklenmeyen kodlama/yük biçimini içeriyorsa meydana gelir.
  • HTTP Spesifikasyonu:
 RFC 7231, bölüm 6.5.13: 415 Desteklenmeyen Ortam Türü
BAŞUCU KİTABI

security.util.*

security.util.KeyAliasNotFound
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Olası neden:

Bu hata, TargetEndpoint veya TargetServer'da belirtilen KeyAlias, belirli bir anahtar deposunda bulunamadığında ortaya çıkar.

Düzelt

TargetEndpoint veya TargetServer'da belirtilen KeyAlias'ın var olduğundan ve belirli bir Keystore'nun parçası olduğundan emin olun.

security.util.TrustStoreWithNoCertificates
  • HTTP durum kodu:
 500 Internal Server Error
  • Hata mesajı:
 TrustStore {truststore_name} has no certificates
  • Olası neden:

Bu hata, TargetEndpoint veya TargetServer'da başvurulan belirli Truststore'da sertifika yoksa oluşur.

Düzelt

Arka uç sunucusunun sertifikasını doğrulamak ve Truststore'u bir TargetEndpoint veya TargetServer'da kullanmak istiyorsanız Truststore'un arka uç sunucusunun geçerli sertifikalarını içerdiğinden emin olun.