502 Hatalı Ağ Geçidi - Yanıt ileGövde

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

Belirti

İstemci uygulaması, API çağrılarına yanıt olarak hata kodu protocol.http.ResponseWithBody ile birlikte 502 Bad Gateway HTTP durum kodunu alır.

Hata mesajı

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

HTTP/1.1 502 Bad Gateway

Ayrıca, aşağıdaki hata mesajlarından birini de görebilirsiniz:

{
   "fault":{
      "faultstring":"Received 204 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

{
   "fault":{
      "faultstring":"Received 205 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

Olası nedenler

Bu hata, arka uç sunucusundan Apigee Edge'e gelen HTTP yanıtı 204 No Content veya 205 Reset Content ise ancak yanıt gövdesini ve/veya aşağıdaki üst bilgilerden birini ya da daha fazlasını içeriyorsa oluşur:

• Content-Length
• Content-Encoding
• Transfer-Encoding

RFC 7231, bölüm 6.3.5: 204 No Content ve RFC 7231, bölüm 6.3.6: 205 Reset Content spesifikasyonlarına göre, kaynak sunucu tarafından durum kodu 204 No Content veya 205 Reset Content ile yanıt yükü gövdesinin bir parçası olarak ek içerik gönderilmemesi beklenir. Content-Length, Content-Encoding veya Transfer-Encoding gibi yanıt üstbilgileri, yanıt yükünün boyutunu, türünü ya da biçimini gösterir.

Bu nedenle, Apigee Edge aşağıdaki durumlarda istemciye 502 Bad Gateway durum koduyla birlikte protocol.http.ResponseWithBody hata kodunu döndürür:

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:

Nedeni: Arka uç sunucusundan 204 yanıtı içeren yanıt gövdesi veya üstbilgiler

Teşhis

1. Genel teşhis adımlarında açıklandığı gibi API izleme, izleme aracı veya NGINX erişim günlükleri kullanılarak gözlemlenen hatanın Hata Kodunu ve Hata Kaynağını belirleyin.
2. Hata Kodu protocol.http.ResponseWithBody ise ve Hata Kaynağı değeri target ise bu, arka uç sunucusunun yanıt gövdesi ve/veya Olası nedenler bölümünde belirtilen başlıklardan biriyle birlikte 204 No Content veya 205 Reset Content durum koduyla yanıt verdiği anlamına gelir.

3. Arka uç sunucusunun gerçekten bir yanıt yükü gövdesi ve/veya Olası nedenler bölümünde belirtilen üstbilgilerden birini ya da daha fazlasını gönderip göndermediğini doğrulamak için aşağıdaki adımları uygulayabilirsiniz:

   1. Herkese açık bulut kullanıcısıysanız ve aynı API isteğini sistemlerinizin herhangi birinden doğrudan arka uç sunucusuna gönderebiliyorsanız.

   2. Özel bulut kullanıcısıysanız aynı API isteğini doğrudan hatanın gözlemlendiği belirli kuruluş ve ortamla ilişkili Mesaj İşleyicilerden birinden arka uç sunucusuna gönderebilirsiniz.

   3. Arka uç sunucusundan alınan yanıtı inceleyin ve yanıtın bir yanıt yükü gövdesi ve/veya yukarıda belirtilen başlıklardan birini veya daha fazlasını içerdiğini doğrulayın. Evetse bu hatanın nedeni budur.

      1. örnek

      1. örnek: İçerik kodlama üstbilgisiyle 204 arka uç sunucusu yanıtı

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Encoding: gzip
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      Bu örnekte, arka uç sunucusu 204 No Content durum kodu ve Content-Encoding: gzip ile yanıt verdi.

      2. örnek

      2. örnek: İçerik uzunluğu üstbilgisiyle 204 arka uç sunucu yanıtı

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Length: 48
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      Bu örnekte, arka uç sunucusu 204 No Content durum kodu ve Content-Length: 48 ile yanıt verdi.

      3. örnek

      3. örnek: Yanıt gövdesiyle birlikte arka uç sunucusu yanıtı 205

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 205 Reset Content
      < Date: Sat, 31 Jul 2021 17:14:09 GMT
      < Content-Length: 12
      < Content-Type: text/plain; charset=utf-8
      <
      * Connection #0 to host X.X.X.X left intact
      This is a sample Response
      

      Bu örnekte, arka uç sunucusu yanıt gövdesiyle birlikte 205 Reset Content durum koduyla yanıt verdi. This is a sample Response.

   4. Yukarıdaki örneklerin hepsinde arka uç sunucusu, yanıt gövdesiyle birlikte 204 No Content veya 205 Reset Content durum kodu ve/veya Olası nedenler bölümünde belirtilen başlıklardan birini gönderdi.
   5. Bu nedenle, Apigee Edge, 502 Bad Gateway durum kodunu protocol.http.ResponseWithBody hata koduyla birlikte gönderdi.

Çözünürlük

Arka uç sunucusunun, Apigee Edge'e 204 No Content veya 205 Reset Content yanıtı gönderirken her zaman RFC 7231, bölüm 6.3.6: 205 Reset Content şartnamesine uyduğundan emin olun. Yani arka uç sunucusu, 204 No Content veya 205 Reset Content yanıtının bir parçası olarak aşağıdakileri GÖNDERMEMELİDİR:

1. Yanıt yükü gövdesi
2. Ayrıca aşağıdaki başlıklardan herhangi biri:
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

Spesifikasyon

Arka uç sunucu 204 No Content veya 205 Reset Content yanıtı gönderirse ancak aşağıdaki RFC spesifikasyonlarına uymazsa Apigee Edge, 502 Bad Gateway durum kodu ve protocol.http.ResponseWithBody hata koduyla yanıt verir:

Dikkat edilmesi gereken önemli noktalar

Önerilen çözüm, arka uç sunucusunu düzeltip yanıt gövdesi ve 204 No Content, 205 Reset Content, Content-Length, Content-Encoding ve Transfer-Encoding başlıklarından herhangi biri olmadan 204 No Content ve 205 Reset Content durum kodunu gönderecek şekilde ayarlamaktır. Ayrıca, RFC 7231, bölüm 6.3.5: 204 No Content ve RFC 7231, bölüm 6.3.6: 205 Reset Content spesifikasyonlarına uymak gerekir.

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ı
• 502 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ı
• Ortam adı
• API proxy paketi
• API istekleri için izleme dosyası

• 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