500 Dahili Sunucu Hatası - BlankPath

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Belirti

İstemci uygulaması 500 Internal Server Error HTTP durum kodunu alır ve API çağrılarına yanıt olarak protocol.http.EmptyPath hata kodunu ekleyin.

Hata mesajı

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

HTTP/1.1 500 Internal Server Error

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

{
   "fault":{
      "faultstring":"Request path cannot be empty",
      "detail":{
         "errorcode":"protocol.http.EmptyPath"
      }
   }
}

Olası nedenler

Bu hata, arka uç sunucusunun istek URL'si ile akış değişkeni ile temsil edildiğinde ortaya çıkar target.url, boş bir yol içeriyor.

Spesifikasyonlara göre RFC 3986, bölüm 3: Söz Dizimi Bileşenleri ve RFC 3986, bölüm 3.3: Yol:

1. URI söz dizimi aşağıdaki bileşenlere sahiptir:

           foo://example.com:8042/over/there?name=ferret#nose
           \_/   \______________/\_________/ \_________/ \__/
            |            |            |            |       |
         scheme      authority       path        query   fragment
   

2. path bileşeni gereklidir ve her zaman düz eğik çizgi içermesi ZORUNLUDUR (/) gibi bir değer alır.

Bu nedenle, arka uç sunucusunun istek URL'sinde path yoksa bir eğik çizgi (/) bile olmadığı için Apigee'nin Edge, 500 Internal Server Error ve hata koduyla yanıt veriyor protocol.http.EmptyPath.

Örneğin: target.url, https://www.mocktarget.apigee.net ise bu hata path bileşen boş veya eksik.

Sık kullanılan teşhis adımları

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

Neden: Arka uç sunucu URL'si (target.url) boş yol içeriyor

Teşhis

1. API İzleme, İzleme Aracı veya NGINX erişim günlüklerini kullanarak 500 Internal Server Error için Hata Kodunu ve Hata Kaynağını aşağıda açıklandığı şekilde belirleyin Yaygın teşhis adımları.
2. Hata Kodu protocol.http.EmptyPath ise ve Hata Kaynağı target değerine ayarlanırsa bu, arka uç sunucu URL'sinde boş bir yolunu izleyin.

3. Arka uç sunucu URL'si, Apigee'deki target.url akış değişkeniyle temsil edilir. Kenar. Bu hata genellikle arka uç sunucu URL'sini (yani target.url dinamik olarak ( Proxy/paylaşılan akış) seçeneğini boş bir yol içerecek şekilde ayarlayın.

4. target.url akış değişkeninin gerçekten boş bir yola ve değeri için bir kaynak oluşturun:

   Trace

   İzleme aracını kullanma

   Bu hataya ait bir iz yakaladıysanız şu adımları uygulayın: İzleme Aracı'nı kullanma ve:

   1. target.url yolunun boş olup olmadığını doğrulayın.

   2. Cevabınız evet ise, Boş yol içerecek şekilde target.url.

      JavaScript politikasının akış değişkenini güncellediğini gösteren örnek iz target.url:

      
   3. Yukarıdaki örnek izlemede, JavaScript politikasının target.url değerini boş bir yol içerecek şekilde güncelledi.
   4. target.url aşağıdaki bileşenlere sahiptir:
      • şema: https://mocktarget.apigee.net
      • path: boş

   Günlükler

   Günlük sunucunuzdaki günlükleri kullanma

   1. Bu hataya ilişkin iz yoksa (ara sıra ortaya çıkan bir sorun) akış değişkeninin değeriyle ilgili bilgileri günlüğe kaydedip kaydetmediğinizi kontrol edin target.url gibi politikalar kullanarak MessageLogging veya ServiceÇağrı'yı günlük sunucunuza ekleyin.
   2. Elinizde günlükler varsa bunları inceleyin ve:
      1. target.url yolunun boş olup olmadığını doğrulayın ve
      2. Hangi politikanın değiştirildiğini belirleyip belirleyemediğinize bakın: target.url (boş bir yol içerme)

   API proxy'si

   Başarısız olan API proxy'sini inceleme

   Bu hata için iz veya günlükleriniz yoksa başarısız API'yi inceleyin target.url akış değişkenini neyin değiştirdiğini veya güncellediğini belirlemek için proxy geçersiz yol içermelidir. Aşağıdakileri kontrol edin:

   • API proxy'sindeki politika
   • Proxy'den çağrılan tüm paylaşılan akışlar

5. veya target.url akış değişkenini dikkatli bir şekilde günceller ve güncelleme nedenini belirler target.url işaretini kaldırın.

   target.url akış değişkenini güncelleyen birkaç örnek politikayı aşağıda bulabilirsiniz hatasına neden olan boş bir yol içermesini önler.

   Örnek 1

   1. örnek: target.url değişkenini güncelleyen JavaScript Politikası

   var url = "https://mocktarget.apigee.net"
   context.setVariable("target.url", url);

   Yukarıdaki örnekte target.url akış değişkeninin güncellendiğine dikkat edin başka bir değişkende bulunan https://mocktarget.apigee.net değeriyle url.

   target.url aşağıdaki bileşenlere sahiptir:

   • şema: https://mocktarget.apigee.net
   • path: boş

   Yol boş olduğu için Apigee Edge, 500 Internal Server Error hatasını hata kodu protocol.http.EmptyPath.

   Örnek 2

   2. Örnek: target.url değişkenini güncelleyen JavaScript Politikası

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   Yukarıdaki örnekte target.url akış değişkeninin bir değişkende bulunan https://mocktarget.apigee.net değerini birleştirme url ve değişkenin değeri path olan değer request.header.Path. kaynağından alındı

   Asıl istek veya izleme işlemine erişiminiz varsa gerçek değeri doğrulayabilirsiniz request.header.Path işlevine aktarıldı.

   Kullanıcı tarafından gönderilen örnek istek:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token>
   

   Bu örnekte, başlık yolu isteğin bir parçası olarak gönderilmemektedir. Dolayısıyla, JavaScript politikasındaki değişken yolunun yüzdesi: null.

   Bu durumda:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + null
   • target.url = https://mocktarget.apigee.netnull

   target.url aşağıdaki bileşenlere sahiptir:

   • şema: https://mocktarget.apigee.netnull
   • path: boş

   Örnek 3

   3. Örnek: target.url değişkeninin atanmış ileti dizisine benzer şekilde başka bir değişken

   <AssignMessage async="false" continueOnError="false" enabled="true" name=">AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   target.url aşağıdaki bileşenlere sahiptir:

   • şema: https://mocktarget.apigee.net
   • path: boş

   Yukarıdaki örneklerin tümünde, arka uç sunucu URL'sindeki yol target.url boş olduğu için Apigee Edge protocol.http.EmptyPath hata koduyla 500 Internal Server Error.

Çözünürlük

Spesifikasyona göre RFC 3986, bölüm 2: Söz Dizimi Bileşenleri'nde path bileşeni zorunludur ve path kapsamında başka karakterler de yer alacak. Aşağıdaki adımları uygulayarak şu sorunu düzeltin:

1. Akış değişkeniyle temsil edilen arka uç sunucu URL'sinin target.url daima boş olmayan bir yol içerir.
   1. Bazı durumlarda, yolda bir kaynak adınız olmayabilir. Bu durumda, en azından düz eğik çizgi (/) içermelidir.
   2. Akış değişkeninin değerini belirlemek için başka değişkenler kullanırsanız target.url, ardından diğer değişkenlerin boş bir yol olmadığından emin olun.
   3. Akış değişkeninin değerini belirlemek için herhangi bir dize işlemi gerçekleştirirseniz target.url, ardından dizenin sonucunun işlemlerinin boş bir yolu yoktur.
2. Teşhis bölümünde açıklanan örneklerde bu sorunu aşağıdaki şekilde düzeltebilirsiniz: aşağıda açıklanmıştır:

   Örnek 1

   1. örnek: target.url değişkenini güncelleyen JavaScript Politikası

   Bu sorunu düzeltmek için url değişkenine eğik çizgi (/) ekleyin. sorunu içerir:

   var url = "https://mocktarget.apigee.net/"
   context.setVariable("target.url", url);

   Örnek 2

   2. Örnek: target.url değişkenini güncelleyen JavaScript Politikası

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   Şu belgenin bir parçası olarak geçerli bir yol ilettiğinizden emin olun: /iloveapis bu sorunu aşağıda gösterildiği gibi düzeltmek için Path başlığını isteyin:

   Örnek istek:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /iloveapis"
   

   Örnek 3

   3. Örnek: target.url değişkeninin atanmış ileti dizisine benzer başka bir değişken

   AttributionMessage politikasının <Value> öğesine geçerli bir yol ekleyin. Örneğin, Örneğin, URL'nin yol olarak /json MockTarget API'si. Yani <Value> öğesini Aşağıda gösterildiği gibi https://mocktarget.apigee.net/json:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/json</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

Spesifikasyon

Apigee Edge, şuna göre arka uç sunucu URL'sinin boş bir yolunun olmamasını bekler: şu spesifikasyonlara dikkat edin:

Hâlâ Apigee Destek Ekibi'nden yardım almak istiyorsanız şu sayfaya gidin: Teşhis bilgileri toplanmalıdır.

Teşhis bilgileri toplanmalıdır

Yukarıdaki talimatları uygulamanıza rağmen sorun devam ederse aşağıdaki ve Apigee Edge Destek Ekibi ile iletişime geçin.

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

• Kuruluş adı
• Ortam adı
• API Proxy adı
• 500 Internal Server Error öğesini protocol.http.EmptyPath hata koduyla yeniden oluşturmak için kullanılan curl komutunu tamamlayın
• API istekleri için izleme dosyası

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

• Başarısız istekler için tam hata mesajı gözlemlendi
• 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

  Yer: ORG, ENV ve PORT# şununla değiştirilir: gerçek değerler.

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

Referanslar