500 Errore interno del server - BadPath

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Sintomo

L'applicazione client riceve un codice di stato HTTP 500 Internal Server Error con il codice di errore protocol.http.BadPath come risposta per le chiamate API.

Messaggio di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 500 Internal Server Error

Inoltre, potresti visualizzare il seguente messaggio di errore:

{
   "fault":{
      "faultstring":"Invalid request path",
      "detail":{
         "errorcode":"protocol.http.BadPath"
      }
   }
}

Possibili cause

Questo errore si verifica se l'URL della richiesta del server di backend, rappresentato dalla variabile di flusso target.url, contiene un path che inizia con un punto interrogativo (?) anziché una barra (/), che non è valida.

In base alle specifiche RFC 3986, sezione 3: componenti di sintassi e RFC 3986, sezione 3.3: percorso:

1. La sintassi URI ha i seguenti componenti:

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

2. Il componente path è obbligatorio, DEVE iniziare con una barra (/) e avere sempre una barra.

Di conseguenza, se l'URL della richiesta del server di backend ha un componente path che inizia con un punto interrogativo (?) anziché una barra (/), Apigee Edge risponde con 500 Internal Server Error e il codice di errore protocol.http.BadPath.

Ad esempio, se target.url ha il valore https://www.mocktarget.apigee.net?json, si verifica questo errore quando path risulta non valido, dal momento che inizia con un punto interrogativo (?) anziché una barra (/).

Causa	Descrizione	Istruzioni per la risoluzione dei problemi applicabili a
L'URL del server di backend (target.url) ha un percorso non valido	Il componente del percorso nell'URL del server di backend rappresentato dalla variabile di flusso target.url inizia con un punto interrogativo (?) anziché una barra (/).	Utenti di cloud pubblico e privato perimetrale

Passaggi di diagnosi più comuni

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

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

Diagnostica

1. Determina il codice di errore e l'origine dell'errore per 500 Internal Server Error utilizzando il monitoraggio delle API, lo strumento Trace o i log degli accessi NGINX, come spiegato nella sezione Passaggi comuni della diagnostica.
2. Se il codice di errore è protocol.http.BadPath e l'origine dell'errore ha il valore target, significa che l'URL del server di backend ha un percorso non valido.

3. L'URL del server di backend è rappresentato dalla variabile di flusso target.url in Apigee Edge. Questo errore si verifica in genere se provi ad aggiornare l'URL del server di backend (target.url) in modo dinamico utilizzando uno dei criteri (all'interno del proxy o del flusso condiviso) nel flusso di richieste di destinazione, in modo che abbia un percorso non valido.

4. Determina se la variabile di flusso target.url ha effettivamente un percorso non valido e l'origine del relativo valore utilizzando uno dei seguenti metodi:

   Traccia

   Utilizzare lo strumento Trace

   Se hai acquisito una traccia per questo errore, segui i passaggi descritti in Utilizzare lo strumento Trace e

   1. Verifica che target.url abbia un percorso non valido, ossia che inizi con un punto interrogativo (?) anziché una barra (/).

   2. In caso affermativo, scopri il criterio che ha modificato o aggiornato il valore di target.url affinché contenga un percorso non valido.

      La traccia di esempio che mostra il criterio JavaScript ha aggiornato la variabile di flusso target.url

      
   3. Nella traccia di esempio precedente, nota che il criterio JavaScript ha modificato o aggiornato il valore di target.url in modo che contenga un percorso non valido.
   4. Tieni presente che target.url include i seguenti componenti:
      • schema: https
      • autorità: mocktarget.apigee.net
      • percorso: ?json

      Il percorso inizia con un punto interrogativo (?) anziché una barra (/), quindi non è valido.

   Log

   Utilizzo dei log nel server di log

   1. Se non disponi di una traccia per questo errore (un problema intermittente), controlla se hai registrato le informazioni sul valore della variabile di flusso target.url, utilizzando criteri come MessageLogging o ServiceCallout nel server di log.
   2. Se disponi dei log, esaminali e
      1. Verifica che il percorso di target.url non sia valido.
      2. Verifica se riesci a determinare le informazioni su quale criterio è stato modificato target.url in modo che contenga un percorso non valido

   proxy API

   Revisione del proxy API con errori

   Se non disponi di una traccia o di log per questo errore, esamina il proxy API con errori per determinare che cosa ha modificato o aggiornato la variabile di flusso target.url in modo che contenga un percorso non valido. Controlla quanto segue:

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

5. Esamina attentamente il criterio specifico (ad esempio: AssignMessage o JavaScript) che modifica o aggiorna la variabile di flusso target.url e determina la causa dell'aggiornamento di target.url affinché abbia un percorso non valido.

   Di seguito sono riportati alcuni criteri di esempio che aggiornano erroneamente la variabile di flusso target.url in modo da contenere un percorso non valido che genera questo errore.

   Esempio 1

   Esempio 1: criterio JavaScript che aggiorna la variabile target.url

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

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

   Tieni presente che il valore di url ha i seguenti componenti:

   • schema: https
   • autorità: mocktarget.apigee.net
   • percorso: ?json

   Il percorso inizia con un punto interrogativo (?) anziché una barra (/), che non è valida. Di conseguenza, Apigee Edge restituisce 500 Internal Server Error con il codice di errore protocol.http.BadPath.

   Esempio 2

   Esempio 2: criterio JavaScript che aggiorna la variabile target.url in base al valore nell'intestazione della richiesta

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

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

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

   Esempio di richiesta effettuata dall'utente

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

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

   Pertanto:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + "?user"
   • target.url = https://mocktarget.apigee.net?user

   Tieni presente che il valore di target.url ha i seguenti componenti:

   • schema: https
   • autorità: mocktarget.apigee.net
   • percorso: ?user

   Il percorso inizia con un punto interrogativo (?) anziché una barra (/), che non è valida. Quindi, Apigee Edge restituisce 500 Internal Server Error con il codice di errore protocol.http.BadPath.

   Esempio 3

   Esempio 3: criterio di AssegnaMessage che aggiorna la variabile target.url

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

   Tieni presente che il valore di url ha i seguenti componenti:

   • schema: https
   • autorità: mocktarget.apigee.net
   • percorso: ?echo

   Anche in questo esempio, il percorso inizia con un punto interrogativo (?) anziché una barra (/), che non è valida. Di conseguenza, Apigee Edge restituisce 500 Internal Server Error con il codice di errore protocol.http.BadPath.

Risoluzione

Secondo la specifica degli URL RFC 3986, sezione 3: componenti di sintassi, il componente path è obbligatorio e DEVE iniziare sempre con "/". Per risolvere il problema, segui i passaggi riportati di seguito:

1. Assicurati che l'URL del server di backend, rappresentato dalla variabile di flusso target.url, abbia sempre un percorso valido e inizi sempre con una barra (/).
   1. In alcuni casi, potresti non avere un nome di risorsa nel percorso, quindi assicurati che il percorso abbia almeno una barra (/).
   2. Se utilizzi altre variabili per determinare il valore della variabile di flusso target.url, assicurati che le altre variabili non abbiano un percorso non valido.
   3. Se esegui operazioni sulle stringhe per determinare il valore della variabile di flusso target.url, assicurati che il risultato o il risultato delle operazioni stringa non abbia un percorso non valido.

2. Negli esempi illustrati sopra, puoi risolvere il problema come spiegato di seguito:

   Esempio 1

   Esempio 1: criterio JavaScript che aggiorna la variabile target.url

   Utilizza una barra (/) anziché un punto interrogativo (?) nella variabile url per risolvere il problema, come illustrato di seguito:

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

   Esempio 2

   Esempio 2: criterio JavaScript che aggiorna la variabile target.url in base al valore nell'intestazione della richiesta

   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 /user nell'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: /user"
   

   Esempio 3

   Esempio 3: criterio di AssegnaMessage che aggiorna la variabile target.url

   Aggiungi un percorso valido nell'elemento <Value> del criterio AssegnaMessage. In altre parole, sostituisci il punto interrogativo (?) con una barra (/) nell'elemento <Value> e impostalo su https://mocktarget.apigee.net/echo per risolvere il problema, 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/echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

   Specifiche

   Apigee Edge prevede che il path componente nell'URL del server di backend DEVE iniziare sempre con una barra (/) in base alle seguenti specifiche:

   Specifiche
   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 informazioni diagnostiche.

   Devi raccogliere dati diagnostici

   Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, raccogli le seguenti informazioni diagnostiche e contatta l'assistenza Apigee Edge:

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

   • Nome dell'organizzazione.
   • Nome ambiente
   • Nome proxy API
   • Comando curl completo utilizzato per riprodurre 500 Internal Server Error con il codice di errore protocol.http.BadPath
   • File di traccia per le richieste API

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

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

   • Log degli accessi NGINX:

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

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

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

   Riferimenti

   Variabili di flusso - Target