500 Interner Serverfehler – Leerer Pfad

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Symptom

Die Clientanwendung ruft den HTTP-Statuscode 500 Internal Server Error mit Fehlercode protocol.http.EmptyPath als Antwort für API-Aufrufe.

Fehlermeldung

Die Clientanwendung ruft den folgenden Antwortcode ab:

HTTP/1.1 500 Internal Server Error

Außerdem wird möglicherweise die folgende Fehlermeldung angezeigt:

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

Mögliche Ursachen

Dieser Fehler tritt auf, wenn die Anfrage-URL des Back-End-Servers, dargestellt durch die Flussvariable <ph type="x-smartling-placeholder"></ph> target.url enthält einen leeren Pfad.

Gemäß den Spezifikationen <ph type="x-smartling-placeholder"></ph> RFC 3986, Abschnitt 3: Syntaxkomponenten und <ph type="x-smartling-placeholder"></ph> RFC 3986, Abschnitt 3.3: Pfad:

1. Die URI-Syntax besteht aus folgenden Komponenten:

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

2. Die Komponente path ist erforderlich und MUSS immer einen Schrägstrich enthalten. (/), auch wenn keine anderen Zeichen im Pfad vorhanden sind.

Wenn also die Anfrage-URL des Back-End-Servers den Parameter path nicht enthält, Komponente, d. h. sie hat keinen Schrägstrich (/), dann ist Apigee Edge antwortet mit 500 Internal Server Error und Fehlercode protocol.http.EmptyPath.

Beispiel: target.url hat den Wert https://www.mocktarget.apigee.net enthält, tritt dieser Fehler path Komponente ist leer oder fehlt.

Ursache	Beschreibung	Anleitungen zur Fehlerbehebung gelten für
Backend-Server-URL (target.url) enthält einen leeren Pfad	Die Backend-Server-URL, die durch die Flussvariable target.url dargestellt wird, hat einen leeren Pfad.	Edge-Nutzer von öffentlichen und privaten Clouds

Allgemeine Diagnoseschritte

Verwenden Sie eines der folgenden Tools oder Techniken, um diesen Fehler zu diagnostizieren:

Ursache: Backend-Server-URL (target.url) hat einen leeren Pfad

Diagnose

1. Ermitteln Sie den Fehlercode und die Fehlerquelle für 500 Internal Server Error mithilfe des API-Monitorings, des Trace-Tools oder der NGINX-Zugriffslogs wie unter Häufige Diagnoseschritte.
2. Wenn der Fehlercode protocol.http.EmptyPath ist und Fehlerquelle target gesetzt ist, zeigt dies an, dass die Back-End-Server-URL ein leeres Pfad.

3. Die Backend-Server-URL wird durch die Flussvariable target.url in Apigee dargestellt. Edge Dieser Fehler tritt normalerweise auf, wenn Sie versuchen, die Backend-Server-URL zu aktualisieren, d. h. target.url dynamisch unter Verwendung einer der Richtlinien (innerhalb Proxy/freigegebener Ablauf) im Ziel-Anfrageablauf, sodass dort ein leerer Pfad vorhanden ist.

   <ph type="x-smartling-placeholder">
4. Stellen Sie fest, ob die Flussvariable target.url tatsächlich einen leeren Pfad hat und der Wert Quelle für seinen Wert mithilfe eines der folgenden Schritte:

   Trace

   Trace-Tool verwenden

   Wenn Sie einen Trace für diesen Fehler erfasst haben, verwenden Sie die Schritte wie unter Mit dem Trace-Tool und:

   1. Prüfen Sie, ob target.url einen leeren Pfad hat.

   2. Falls ja, sehen Sie nach, durch welche Richtlinie der Wert target.url, um einen leeren Pfad zu enthalten.

      Beispiel-Trace, das die JavaScript-Richtlinie zeigt, die Flussvariable aktualisiert hat target.url:.

      
   3. Beachten Sie im obigen Beispiel-Trace, dass die JavaScript-Richtlinie geändert oder hat den Wert von target.url aktualisiert, sodass er einen leeren Pfad enthält.
   4. target.url hat die folgenden Komponenten: <ph type="x-smartling-placeholder">
      </ph>
      • scheme: https://mocktarget.apigee.net
      • path:leer

   Logs

   Logs auf Ihrem Logserver verwenden

   1. Wenn Sie keine Ablaufverfolgung für diesen Fehler haben (ein vorübergehendes Problem), gehen Sie folgendermaßen vor: prüfen, ob Sie die Informationen zum Wert einer Flussvariablen protokolliert haben target.url, unter Verwendung von Richtlinien wie <ph type="x-smartling-placeholder"></ph> MessageLogging oder <ph type="x-smartling-placeholder"></ph> ServiceCallout mit Ihrem Logserver verbinden.
   2. Wenn Sie die Logs haben, prüfen Sie sie und gehen Sie so vor: <ph type="x-smartling-placeholder">
      </ph>
      1. Prüfen Sie, ob target.url einen leeren Pfad hat.
      2. Prüfen Sie, ob Sie feststellen können, welche Richtlinie target.url geändert hat einen leeren Pfad enthalten

   API-Proxy

   Fehlerhaften API-Proxy prüfen

   Wenn Sie weder ein Trace noch Protokolle für diesen Fehler haben, prüfen Sie die fehlerhafte API Proxy, um zu bestimmen, was die Flussvariable target.url geändert oder aktualisiert hat enthält einen ungültigen Pfad. Dann machen Sie Folgendes:

   • Richtlinie im API-Proxy
   • Alle freigegebenen Abläufe, die vom Proxy aufgerufen werden

5. Sehen Sie sich die Richtlinie an, z. B. „AssignMessage“ oder „JavaScript“, die oder aktualisiert die Flussvariable target.url sorgfältig und ermittelt den Grund für die Aktualisierung target.url, um einen leeren Pfad zu haben.

   Hier sind einige Beispielrichtlinien, die die Flussvariable target.url aktualisieren fälschlicherweise einen leeren Pfad enthalten, der zu diesem Fehler führt.

   Beispiel 1

   Beispiel 1: JavaScript-Richtlinie zur Aktualisierung der Variable „target.url“

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

   Beachten Sie im obigen Beispiel, dass die Flussvariable target.url aktualisiert wird wobei der Wert https://mocktarget.apigee.net in einer anderen Variablen enthalten ist url

   target.url hat die folgenden Komponenten:

   • scheme: https://mocktarget.apigee.net
   • path:leer

   Da der Pfad leer ist, gibt Apigee Edge 500 Internal Server Error mit Fehlercode protocol.http.EmptyPath.

   Beispiel 2

   Beispiel 2: JavaScript-Richtlinie zur Aktualisierung der Variable „target.url“

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

   Beachten Sie im obigen Beispiel, dass die Flussvariable target.url durch Wert https://mocktarget.apigee.net in einer Variablen verketten url und den Wert einer weiteren Variablen path, deren Der Wert wird aus request.header.Path. abgerufen

   Wenn Sie Zugriff auf die eigentliche Anfrage oder den Trace haben, können Sie den tatsächlichen Wert an request.header.Path übergeben.

   Beispielanfrage des Nutzers:

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

   In diesem Beispiel wird der Header-Pfad nicht als Teil der Anfrage gesendet. Daher ist der Wert des Variablenpfads in der JavaScript-Richtlinie lautet null.

   Das bedeutet:

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

   target.url hat die folgenden Komponenten:

   • scheme: https://mocktarget.apigee.netnull
   • path:leer

   Beispiel 3

   Beispiel 3: AssignMessage-Richtlinie aktualisiert target.url-Variable über andere Variable

   <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 hat die folgenden Komponenten:

   • scheme: https://mocktarget.apigee.net
   • path:leer

   In allen obigen Beispielen ist der Pfad in der Back-End-Server-URL, also target.url ist leer, daher gibt Apigee Edge Folgendes zurück: 500 Internal Server Error mit Fehlercode protocol.http.EmptyPath.

Auflösung

Gemäß Spezifikation <ph type="x-smartling-placeholder"></ph> RFC 3986, Abschnitt 2: Syntaxkomponenten, ist die path-Komponente erforderlich und MUSS immer einen Schrägstrich (/) enthalten, auch wenn kein andere Zeichen als Teil des path. Führen Sie die folgenden Schritte aus, um dieses Problem beheben:

1. Achten Sie darauf, dass die Back-End-Server-URL, dargestellt durch die Flussvariable target.url hat immer einen nicht leeren Pfad.
   1. In einigen Fällen enthält der Pfad möglicherweise keinen Ressourcennamen. Prüfen Sie dann, ob der Pfad korrekt ist. mindestens einen Schrägstrich (/) enthält.
   2. Wenn Sie andere Variablen verwenden, um den Wert der Flussvariablen zu bestimmen target.url. Achten Sie dann darauf, dass der Pfad für andere Variablen nicht leer ist.
   3. Wenn Sie Zeichenfolgenvorgänge ausführen, um den Wert der Flussvariablen zu bestimmen target.url. Prüfen Sie dann, ob das Ergebnis oder Ergebnis des Strings hat keinen leeren Pfad.
2. In den Beispielen, die im Abschnitt Diagnose behandelt werden, können Sie dieses Problem folgendermaßen beheben: wie im Folgenden beschrieben:

   Beispiel 1

   Beispiel 1: JavaScript-Richtlinie zur Aktualisierung der Variable „target.url“

   Fügen Sie der Variablen url einen Schrägstrich (/) hinzu, um dieses Problem zu beheben wie unten dargestellt:

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

   Beispiel 2

   Beispiel 2: JavaScript-Richtlinie zur Aktualisierung der Variable „target.url“

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

   Sie müssen einen gültigen Pfad übergeben, z. B. /iloveapis als Teil des Anfrageheader Path, um dieses Problem zu beheben (siehe unten):

   Beispielanfrage:

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

   Beispiel 3

   Beispiel 3: AssignMessage-Richtlinie aktualisiert die Variable target.url über andere Variable

   Fügen Sie im <Value>-Element derAssignMessage-Richtlinie einen gültigen Pfad hinzu. Für können Sie z. B. /json als Pfad für MockTarget API verwenden. Ändern Sie also das Element <Value> in https://mocktarget.apigee.net/json, wie unten gezeigt:

   <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>
   

Spezifikation

Apigee Edge erwartet, dass die Back-End-Server-URL keinen leeren Pfad hat, wie pro die folgenden Spezifikationen:

Spezifikation
<ph type="x-smartling-placeholder"></ph> RFC 3986, Abschnitt 3: Syntaxkomponenten
<ph type="x-smartling-placeholder"></ph> RFC 3986, Abschnitt 3.3: Pfad

Wenn Sie weitere Unterstützung vom Apigee-Support benötigen, gehen Sie zu Diagnoseinformationen müssen erfasst werden.

Diagnoseinformationen müssen erfasst werden

Wenn das Problem trotz Befolgung der obigen Anleitung weiterhin besteht, stellen Sie Folgendes zusammen: Diagnoseinformationen und wenden Sie sich dann an den Apigee Edge-Support.

Wenn Sie ein Public Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Name der Organisation
• Name der Umgebung
• API-Proxy-Name
• Vollständiger curl-Befehl zum Reproduzieren von 500 Internal Server Error mit dem Fehlercode protocol.http.EmptyPath
• Ablaufverfolgungsdatei für API-Anfragen

Wenn Sie ein Private Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Vollständige Fehlermeldung für fehlgeschlagene Anfragen
• Name der Umgebung
• API-Proxy-Bundle
• Ablaufverfolgungsdatei für API-Anfragen

• NGINX-Zugriffslogs:

  /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Wo:ORG, ENV und PORT# werden ersetzt durch tatsächliche Werte.

• Systemprotokolle des Message Processor /opt/apigee/var/log/edge-message- processor/logs/system.log

Verweise

Flussvariablen – Ziel