500 Internal Server Error - EmptyPath

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Sintomo

L'applicazione client riceve un codice di stato HTTP di 500 Internal Server Error con il codice di errore protocol.http.EmptyPath in risposta alle chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 500 Internal Server Error

Potresti inoltre visualizzare il seguente messaggio di errore:

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

Possibili cause

Questo errore si verifica se l'URL della richiesta del server di backend, rappresentato dalla variabile di flusso target.url, contiene un percorso vuoto.

In base alle specifiche RFC 3986, sezione 3: Componenti di sintassi e . RFC 3986, sezione 3.3: Percorso:

1. La sintassi URI include i seguenti componenti:

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

2. Il componente path è obbligatorio e DEVE contenere sempre una barra (/), anche se nel percorso non sono presenti altri caratteri.

Di conseguenza, se l'URL della richiesta del server di backend non presenta la classe path del componente, ovvero non ha nemmeno una barra (/), Apigee Edge risponde con 500 Internal Server Error e codice di errore protocol.http.EmptyPath.

Ad esempio: se target.url ha il valore https://www.mocktarget.apigee.net, questo errore si verifica quando path il componente è vuoto o mancante.

Causa	Descrizione	Le istruzioni di risoluzione dei problemi applicabili a
L'URL del server di backend (target.url) ha un percorso vuoto	L'URL del server di backend rappresentato dalla variabile di flusso target.url ha un percorso vuoto.	Utenti perimetrali di cloud pubblici e privati

Passaggi diagnostici comuni

Utilizza uno dei seguenti strumenti/tecniche per diagnosticare questo errore:

Causa: il percorso dell'URL del server di backend (target.url) è vuoto

Diagnosi

1. Determina il codice di errore e l'origine errore per 500 Internal Server Error utilizzando i log di accesso di API Monitoring, Trace Tool o NGINX, come spiegato in Passaggi di diagnostica comuni.
2. Se il Codice di errore è protocol.http.EmptyPath e Origine errore ha il valore target, questo indica che l'URL del server di backend ha un del tuo percorso di apprendimento.

3. L'URL del server di backend è rappresentato dalla variabile di flusso target.url in Apigee perimetrali. Questo errore in genere si verifica se provi ad aggiornare l'URL del server di backend, ovvero target.url in modo dinamico usando uno qualsiasi dei criteri (all'interno proxy/flusso condiviso) nel flusso di richiesta di destinazione, in modo che abbia un percorso vuoto.

4. Determina se la variabile di flusso target.url ha un percorso vuoto e utilizzando uno dei seguenti passaggi:

   Trace

   Utilizzo dello strumento Trace

   Se hai acquisito una traccia per questo errore, segui la procedura descritta in Utilizzo dello strumento Trace e:

   1. Verifica se target.url ha un percorso vuoto.

   2. In caso affermativo, scopri quale criterio ha modificato o aggiornato il valore target.url contenente un percorso vuoto.

      Traccia di esempio che mostra che il criterio JavaScript ha aggiornato la variabile di flusso target.url:

      
   3. Nella traccia di esempio precedente, nota che il criterio JavaScript è stato modificato o ha aggiornato il valore di target.url in modo che contenga un percorso vuoto.
   4. Tieni presente che target.url include i seguenti componenti:
      • schema: https://mocktarget.apigee.net
      • path: vuoto

   Log

   Utilizzo dei log nel server di log

   1. Se non riesci a trovare alcuna traccia per questo errore (problema intermittente), controlla verifica di aver registrato le informazioni sul valore della variabile di flusso target.url, utilizzando criteri come MessageLogging o ServiceCallout al server di log.
   2. Se disponi dei log, esaminali e:
      1. Verifica se target.url ha un percorso vuoto e
      2. Verifica se riesci a determinare quale criterio ha modificato target.url a contenere un percorso vuoto

   proxy API

   Revisione del proxy API che presenta errori

   Se non disponi di traccia o log per questo errore, esamina l'API con errori proxy per determinare cosa ha modificato o aggiornato la variabile di flusso target.url per contenere un percorso non valido. Controlla quanto segue:

   • Il criterio all'interno del proxy API
   • Eventuali flussi condivisi richiamati dal proxy

5. Esamina il criterio specifico (ad esempio, AssignMessage o JavaScript) che modifica o aggiorna attentamente la variabile di flusso target.url e determina la causa dell'aggiornamento target.url per avere un percorso vuoto.

   Ecco alcuni esempi di criteri che aggiornano la variabile di flusso target.url non è sufficiente contenere un percorso vuoto che porta a questo errore.

   Esempio 1

   Esempio 1: aggiornamento del criterio JavaScript di target.url variabile

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

   Nell'esempio precedente, nota che la variabile di flusso target.url viene aggiornata con il valore https://mocktarget.apigee.net contenuto in un'altra variabile url.

   Tieni presente che target.url include i seguenti componenti:

   • schema: https://mocktarget.apigee.net
   • path: vuoto

   Poiché il percorso è vuoto, Apigee Edge restituisce 500 Internal Server Error con codice di errore protocol.http.EmptyPath.

   Esempio 2

   Esempio 2: aggiornamento del criterio JavaScript di target.url variabile

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

   Nell'esempio precedente, la variabile di flusso target.url viene aggiornata mediante concatenando il valore https://mocktarget.apigee.net contenuto in una variabile url e il valore di un'altra variabile path, la cui valore recuperato da request.header.Path.

   Se hai accesso alla traccia o alla richiesta effettiva, puoi verificare il valore effettivo passato a request.header.Path.

   Esempio di richiesta effettuata dall'utente:

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

   In questo esempio, il percorso dell'intestazione non viene inviato come parte della richiesta. Di conseguenza, il valore del percorso della variabile nel criterio JavaScript è null.

   Pertanto:

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

   Tieni presente che target.url include i seguenti componenti:

   • schema: https://mocktarget.apigee.netnull
   • path: vuoto

   Esempio 3

   Esempio 3: criterio di Assegna Messaggi che aggiorna la variabile di target.url tramite un'altra variabile

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

   Tieni presente che target.url include i seguenti componenti:

   • schema: https://mocktarget.apigee.net
   • path: vuoto

   In tutti gli esempi precedenti, il percorso dell'URL del server di backend, ovvero target.url è vuoto, pertanto Apigee Edge restituisce 500 Internal Server Error con codice di errore protocol.http.EmptyPath.

Risoluzione

In base alle specifiche RFC 3986, sezione 2: componenti di sintassi, il componente path è obbligatorio e DEVE contenere sempre una barra (/), anche se non sono presenti altri caratteri come parte di path. Per eseguire questa operazione, procedi nel seguente modo: risolvi questo problema:

1. Assicurati che l'URL del server di backend, rappresentato dalla variabile di flusso target.url ha sempre un percorso non vuoto.
   1. In alcuni casi, potresti non avere un nome risorsa nel percorso, quindi assicurati che il percorso contenga almeno una barra (/).
   2. Se utilizzi altre variabili per determinare il valore della variabile di flusso target.url, poi assicurati che il percorso di altre variabili non sia vuoto.
   3. Se esegui operazioni con le stringhe per determinare il valore della variabile di flusso target.url, quindi assicurati che il risultato della stringa non ha un percorso vuoto.
2. Negli esempi discussi in Diagnostica, puoi risolvere questo problema come di seguito spiegate di seguito:

   Esempio 1

   Esempio 1: aggiornamento del criterio JavaScript di target.url variabile

   Aggiungi una barra (/) alla variabile url per risolvere questo problema come mostrato di seguito:

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

   Esempio 2

   Esempio 2: aggiornamento del criterio JavaScript di target.url variabile

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

   Assicurati di trasmettere un percorso valido, ad esempio /iloveapis, nell'ambito di intestazione della richiesta Path per risolvere il problema, come mostrato di seguito:

   Esempio di richiesta:

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

   Esempio 3

   Esempio 3: criterioAssignMessage che aggiorna la variabile target.url tramite un'altra variabile

   Aggiungi un percorso valido nell'elemento <Value> del criterioAssignMessage. Per Ad esempio, puoi avere /json come percorso API MockTarget. Vale a dire, modifica l'elemento <Value> in https://mocktarget.apigee.net/json come mostrato di seguito:

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

Specifica

Apigee Edge si aspetta che l'URL del server di backend non abbia un percorso vuoto come le seguenti specifiche:

Specifica
RFC 3986, sezione 3: componenti di sintassi
RFC 3986, sezione 3.3: Percorso

Se hai ancora bisogno di aiuto dall'assistenza Apigee, vai a Devi raccogliere dati diagnostici.

È necessario raccogliere dati diagnostici

Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, raccogli i seguenti dati informazioni diagnostiche e contattare l'assistenza Apigee Edge.

Se sei un utente del cloud pubblico, fornisci le seguenti informazioni:

• Nome organizzazione
• Nome ambiente
• Nome proxy API
• Completa il comando curl utilizzato per riprodurre l'errore 500 Internal Server Error con il codice di errore protocol.http.EmptyPath
• File di traccia per le richieste API

Se sei un utente di Private Cloud, fornisci le seguenti informazioni:

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome ambiente
• Bundle proxy API
• File di traccia per le richieste API

• Log di accesso NGINX:

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

  Dove: ORG, ENV e PORT# vengono sostituiti con valori effettivi.

• Log di sistema del processore di messaggi /opt/apigee/var/log/edge-message- processor/logs/system.log

Riferimenti

Variabili di flusso - Target