Errore interno del server 500: server di backend

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Video

Sintomo

L'applicazione client riceve un codice di stato HTTP 500 con il messaggio Internal Server Error come risposta alle chiamate API.

Il codice di stato HTTP 500 è una risposta di errore generica. Significa che il server ha riscontrato una condizione imprevista che gli ha impedito di soddisfare la richiesta. In genere, questo errore viene restituito dal server quando non è adatto nessun altro codice di errore.

Messaggi di errore

L'applicazione client riceve il seguente codice di risposta:

HTTP/1.1 500 Internal Server Error

Inoltre, potresti visualizzare un messaggio di errore simile a quello mostrato di seguito:

{"errorMessage":"Sorry either your e-mail or password didn't match.",
"errorParameters":"{}",
"errorCode":"500",
"errorKey":"INVALID_EMAILPASSWORD"}

<Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <Body>
      <Error>
         <code>500</code>
         <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
      </Error>
   </Body>
</Envelope>

Possibili cause

Il 500 Internal Server Error potrebbe essere restituito dal server di backend per diversi motivi. Questa guida pratica spiega come risolvere questo errore, indipendentemente dalla causa, utilizzando passaggi comuni.

Di seguito sono riportate le possibili cause di questo problema:

Passaggi comuni per la diagnosi

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

Causa: errore nel server di backend

Diagnosi

L'500 Internal Server Error restituito dal server di backend può essere causato da diversi motivi. Dovrai diagnosticare ogni situazione in modo indipendente.

1. Determina il codice di errore e l'origine dell'errore osservato utilizzando il monitoraggio delle API, lo strumento Traccia o i log degli accessi di NGINX, come spiegato in Passaggi comuni per la diagnosi.
2. Se l'origine dell'errore è target e il codice di errore è messaging.adaptors.http.flow.ErrorResponseCode, significa che l'errore viene restituito dal server di backend.
3. Puoi utilizzare uno dei seguenti passaggi per diagnosticare la causa del problema:

   Traccia

   Utilizzo di Traccia:

   Se hai una sessione di traccia per l'errore, segui questi passaggi:

   1. Nella traccia, seleziona la richiesta API che non è andata a buon fine con 500 Internal Server Error.

   2. Seleziona la fase Risposta ricevuta dal server di destinazione dalla richiesta API non riuscita, come mostrato nella figura seguente:

      ( vedi immagine più grande)

      

   3. Scorri verso il basso fino alla sezione Dettagli fase e controlla il Contenuto della risposta, che contiene la risposta del server di backend.

      Contenuto della risposta di esempio:

      <Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
         <Body>
            <Error>
               <code>500</code>
               <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
            </Error>
         </Body>
      </Envelope>

      Nella risposta riportata sopra, tieni presente che il messaggio di errore del server di backend è Not Authorised (Non autorizzato). Ciò indica che l'utente potrebbe aver inserito credenziali non valide e per questo motivo riceve questo errore.

   Chiama il server di backend

   Effettuare una chiamata diretta al server di backend:

   Puoi effettuare una chiamata diretta al server di backend e:

   • Verificare se ricevi la stessa 500 Internal Server Error risposta ricevuta quando la richiesta è stata effettuata tramite Apigee Edge
   • Controllare il messaggio di errore (risposta) ricevuto dal server di backend

   Segui questi passaggi per effettuare la chiamata diretta al server di backend:

   1. Assicurati di avere tutte le intestazioni, i parametri di query e le credenziali necessarie da passare al server di backend come parte della richiesta.
   2. Se il servizio di backend è accessibile pubblicamente, puoi utilizzare il curl comando, Postman o qualsiasi altro client REST e richiamare direttamente l'API del server di backend.

   3. Se il server di backend è accessibile solo dai processori di messaggi, puoi utilizzare il comando curl, Postman o qualsiasi altro client REST e richiamare direttamente l'API del server di backend dal processore di messaggi.

   4. Verifica se il servizio di backend restituisce effettivamente 500 Internal Server Error, controlla il messaggio di errore (risposta) restituito dal server di backend e determina la causa di questo errore.

   Log del server di backend

   Utilizzo dei log del server di backend

   1. Esamina i log del server di backend e prova a ottenere maggiori dettagli sull'errore e sulla sua causa.
   2. Se possibile, attiva la modalità di debug sul server di backend per ottenere maggiori dettagli sull'errore e la causa.

4. Verifica se stai utilizzando il concatenamento di proxy nell'endpoint di destinazione specifico del proxy API non riuscito, ovvero se il server di destinazione/endpoint di destinazione richiama un altro proxy in Apigee Edge. Per determinarlo:

   1. Se hai la traccia della richiesta non riuscita, vai alla fase Richiesta inviata al server di destinazione e fai clic su Mostra Curl.

      
   2. Si apre la finestra Curl per la richiesta inviata al server di destinazione , da cui puoi determinare l'alias host del server di destinazione.
   3. Esamina l'endpoint di destinazione del proxy API e verifica se l'URL del server di backend o il nome host nel server di destinazione rimanda a un altro proxy o al tuo server di backend.
   4. Se l'alias host del server di destinazione rimanda a un alias host virtuale, si tratta di un concatenamento di proxy. In questo caso, devi ripetere tutti i passaggi precedenti per il proxy concatenato finché non determini la causa effettiva del 500 Internal Server Error. In questi casi, 500 Internal Server Error può verificarsi anche in altri proxy concatenati in altre fasi, che possono essere diagnosticati e risolti utilizzando le istruzioni fornite in questa guida pratica o nella guida pratica relativa all'errore 500 Internal Server Error.
   5. Se l'alias host del server di destinazione rimanda al tuo server di backend, vai a Risoluzione.

Risoluzione

Se viene accertato che l'errore 500 proviene dal server di backend, allora collabora con il team del server di backend per risolvere il problema in modo appropriato.

Nell'esempio discusso sopra, potrebbe essere necessario richiedere agli utenti di inserire credenziali valide per risolvere il problema.

Punti chiave da tenere presenti

1. Il messaggio di errore effettivo restituito dal server di backend per 500 Internal Server Error può essere visualizzato solo se hai acquisito la sessione di traccia per le richieste non riuscite.
2. Per motivi di sicurezza, la risposta del server di backend non verrà registrata nei log del monitoraggio delle API, nei log degli accessi di NGINX o nei log del processore di messaggi.
3. Puoi esaminare i log del server di backend o attivare la modalità di debug sul backend per ottenere maggiori dettagli sull'500 Internal Server Error e/o visualizzare il messaggio di errore restituito dal server di backend.

Informazioni di diagnostica da raccogliere

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

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

• Nome organizzazione
• Nome ambiente
• Nome proxy API
• Comando curl completo per riprodurre l'errore 500
• File di traccia contenente le richieste con l'errore 500 Internal Server Error
• Se gli errori 500 non si verificano attualmente, fornisci il periodo di tempo con le informazioni sul fuso orario in cui si sono verificati 500 in passato.

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

• Messaggio di errore completo osservato per le richieste non riuscite
• Nome dell'organizzazione, dell'ambiente e del proxy API per cui stai osservando 500 errori
• Bundle del proxy API
• File di traccia contenente le richieste con l'errore 500 Internal Server Error
• Log degli accessi di 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
• Il periodo di tempo con le informazioni sul fuso orario in cui si sono verificati gli errori 500.