500 Errore interno del server - BadPath

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.BadPath 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":"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 elemento path che inizia con un punto interrogativo (?) di 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 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 iniziare con e contengono sempre una barra (/).

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

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

Causa	Descrizione	Le istruzioni di 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é con l'inoltro barra (/).	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) non è valido

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.BadPath e Origine errore ha il valore target, questo indica che nell'URL del server di backend è presente un valore non valido 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 (target.url) in modo dinamico usare uno qualsiasi dei criteri (all'interno proxy/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 valore non valido path e l'origine del valore utilizzando uno dei seguenti metodi:

   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 non valido, ovvero se inizia con un punto interrogativo (?) anziché una barra (/).

   2. In caso affermativo, verifica il criterio che ha modificato o aggiornato il valore target.url contenere un percorso non valido.

      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 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 (?) invece che una avanti barra (/), quindi non è valida.

   Log

   Utilizzo dei log nel server di log

   1. Se non riesci a trovare alcuna traccia per questo errore (si è verificato un problema intermittente), verifica se hai 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 non valido e
      2. Verificare se è possibile determinare le informazioni relative alle norme modificate target.url contenere un percorso non valido

   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 attentamente il criterio specifico (ad esempio AssegnaMessage o JavaScript) che modifica o aggiorna la variabile di flusso target.url e determina la causa aggiornamento di target.url in modo che abbia un percorso non valido.

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

   Esempio 1

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

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

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

   Tieni presente che il valore dell'elemento 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. Pertanto, Apigee Edge restituisce 500 Internal Server Error con codice di errore protocol.http.BadPath.

   Esempio 2

   Esempio 2: aggiornamento del criterio JavaScript di target.url variabile 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 un la variabile url e il valore di un'altra variabile path, il cui valore viene 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> -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 dell'elemento 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. Pertanto, Apigee Edge restituisce 500 Internal Server Error con il codice di errore protocol.http.BadPath.

   Esempio 3

   Esempio 3: criterioAssignMessage in aggiornamento della 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 (?) invece di una barra (/), che non è valida. Pertanto, Apigee Edge restituisce 500 Internal Server Error con codice di errore protocol.http.BadPath.

Risoluzione

In base alla specifica dell'URL RFC 3986, sezione 3: componenti di sintassi, il componente path è obbligatorio e DEVE iniziare sempre con "/". Per risolvere il problema, procedi nel seguente modo:

1. Assicurati che l'URL del server di backend, rappresentato dalla variabile di flusso target.url ha sempre un percorso valido e inizia sempre con un barra obliqua (/).
   1. In alcuni casi, potresti non avere un nome risorsa nel percorso, quindi assicurati che il valore il percorso contiene almeno una barra (/).
   2. Se utilizzi altre variabili per determinare il valore della variabile di flusso target.url, poi assicurati che altre variabili non abbiano un percorso non valido.
   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 non valido.

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

   Esempio 1

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

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

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

   Esempio 2

   Esempio 2: aggiornamento del criterio JavaScript di target.url variabile 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, come parte della richiesta intestazione Path per risolvere il problema, come illustrato di seguito:

   Esempio di richiesta:

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

   Esempio 3

   Esempio 3: aggiornamento del criterio AssegnaMessage per l'aggiornamento di target.url

   Aggiungi un percorso valido nell'elemento <Value> del criterioAssignMessage. Vale a dire, sostituisci il punto interrogativo (?) con una barra obliqua (/) 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>
   

   Specifica

   Apigee Edge si aspetta che il path componente nell'URL del server di backend DEVE sempre iniziare con una barra (/) , come indicato di seguito 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 Devo raccogliere informazioni diagnostiche.

   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.BadPath
   • 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