Risoluzione degli errori di deployment dei criteri JavaCallout

Stai visualizzando la documentazione di Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.

ResourceDoesNotExist

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non riesce e viene visualizzato questo messaggio di errore:

Error Deploying Revision <var>revision_number</var> to <var>environment</var>
Resource with name <var>ResourceURL</var> and type java does not exist.

Esempio di messaggio di errore

Error Deploying Revision 1 to test
Resource with name myresource.jar and type java does not exist.

Screenshot di esempio dell'errore

Errore durante il deployment della revisione 1 per il test.

Causa

Se la risorsa specificata nell'elemento <ResourceURL> nel JavaCallout policy non esiste a livello di proxy API o ambiente, il deployment del proxy API non va a buon fine.

Diagnosi

  1. Identifica l'ambiente e il nome della risorsa. Puoi trovare queste informazioni nel messaggio di errore. Ad esempio, nel seguente errore l'ambiente è test e il nome della risorsa utilizzato nell'elemento <ResourceURL> è myresource.jar.

    Error Deploying Revision 1 to test
Resource with name myresource.jar and type java does not exist.

  2. Determina la norma JavaCallout che utilizza la risorsa identificata nel passaggio 1.

    Ad esempio, il seguente criterio specifica il valore di <ResourceURL> come myresource.jar, che corrisponde al valore nel messaggio di errore:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JavaCallout name="hello-java">
    <ClassName>com.apigeesample.HelloJava</ClassName>
    <ResourceURL>java://myresource.jar</ResourceURL>
</JavaCallout>

  3. Determina se la risorsa fa parte del proxy API che non funziona o è stata caricata a livello di ambiente. In caso contrario, questa è la causa dell'errore.

    • Vai alla scheda Risorse nel riquadro del navigatore dell'editor del proxy API per visualizzare tutte le risorse caricate a livello di proxy API. In questo esempio, il proxy API non ha risorse caricate.

      Scheda Risorse dell&#39;editor proxy API nel riquadro di navigazione.

    • Le risorse possono essere disponibili a livello di ambiente. Per ulteriori informazioni, vedi File di risorse.

      • Per determinare se la risorsa esiste a livello di ambiente, esegui la seguente chiamata API utilizzando curl:

        curl \
"https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles/java/myresource.jar" \
-H "Authorization: Bearer $TOKEN"

        Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl. Per una descrizione delle variabili di ambiente che puoi utilizzare, consulta Impostazione delle variabili di ambiente per le richieste API Apigee.

      Se ricevi un codice di stato 404 come risposta per queste API, la risorsa non è presente a livello di ambiente.

    Se la risorsa non è disponibile a livello di proxy API e ambiente, viene restituito l'errore di deployment:

    Resource with name myresource.jar and type java does not exist.
 ```

Risoluzione

Assicurati che la risorsa specificata nell'elemento <ResourceURL> esista a livello di proxy API o ambiente. Per ulteriori informazioni, vedi Gestione delle risorse.

Per correggere il criterio JavaCallout di esempio mostrato sopra, carica il file JAR al livello appropriato (proxy API o ambiente).

NoResourceForURL

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non riesce e viene visualizzato questo messaggio di errore:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL <var>ResourceURL</var>

Esempio di messaggio di errore

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar

Screenshot di esempio dell'errore

Errore nel deployment per il test dell&#39;ambiente.

Causa

Questo errore può verificarsi se il file di risorse è danneggiato o caricato parzialmente, anche se sembra esistere a livello di proxy API o ambiente.

Diagnosi

  1. Identifica l'ambiente e il nome della risorsa. Puoi trovare queste informazioni nel messaggio di errore. Ad esempio, nel seguente errore, il nome dell'ambiente è test e il nome della risorsa utilizzato nell'elemento <ResourceURL> è myresource.jar.

    Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Could not locate a resource with URL java://myresource.jar

  2. Assicurati che la risorsa venga caricata a livello di proxy API o ambiente. Nell'esempio seguente, puoi notare che la risorsa myresource.jar viene caricata a livello di proxy API.

    Risorse proxy API.

    Le risorse possono essere disponibili a livello di ambiente. Per ulteriori informazioni, vedi File di risorse.

    Per determinare se la risorsa esiste a livello di ambiente, esegui la seguente chiamata API utilizzando curl:

    curl \
"https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles/java/myresource.jar" \
-H "Authorization: Bearer $TOKEN"

    Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl.

    Se ricevi un codice di stato 404 come risposta per queste API, la risorsa non è presente a livello di ambiente.

Risoluzione

  1. Se determini che la risorsa esiste a livello di proxy API o ambiente, elimina la risorsa e caricala di nuovo, come descritto nel passaggio 2. In caso contrario vai al passaggio 3.

  2. Per eliminare la risorsa a livello di proxy API, vai alla scheda Risorse nel riquadro Navigatore dell'editor del proxy API e fai clic sul pulsante "X" accanto alla risorsa, come mostrato di seguito.

    Per eliminare la risorsa a livello di proxy API, fai clic su Elimina.

    Per eliminare la risorsa nell'ambiente, utilizza il verbo DELETE nelle chiamate API utilizzate in precedenza nei passaggi di diagnostica. Ad esempio, per eliminare la risorsa a livello di ambiente, inserisci questo comando:

    curl -X DELETE \
"https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles/java/myresource.jar" \
-H "Authorization: Bearer $TOKEN"

    Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl.

  3. Carica il file JAR) al livello appropriato (proxy API o ambiente).

  4. Se il nuovo caricamento della risorsa non risolve il problema, contatta l'assistenza Apigee.

JavaCalloutInstantiationFailed

Messaggio di errore

Il deployment del proxy API tramite la UI o l'API Apigee non riesce e viene visualizzato questo messaggio di errore:

Error in deployment for environment <var>environment</var>
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class <var>class_name</var>

Oppure

Error in deployment for environment <var>environment</var>.
The revision is deployed and traffic can flow, but flow may be impaired. Failed to instantiate the JavaCallout Class <var>class_name</var>

Esempio di messaggio di errore

Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class

Screenshot di esempio dell'errore

Errore nel deployment per il test dell&#39;ambiente.

Causa

Ecco le cause tipiche di questo errore

Causa Descrizione
File JAR mancante Il file JAR contenente la classe Java identificata nell'errore non viene caricato.
File JAR danneggiato Il file JAR contenente la classe Java identificata nell'errore è danneggiato/caricato parzialmente.
File Class mancante Il file della classe Java identificato nell'errore non fa parte del file JAR specificato in >ResourceURL< o dei file JAR dipendenti.
Problema con il codice Java È presente un errore nel codice, ad esempio un costruttore mancante, un problema di dipendenza del codice o un altro problema.

Passaggio di diagnostica comune

  1. Identifica il nome dell'ambiente e della classe che non è stato importato. Ad esempio, nel seguente messaggio di errore il nome dell'ambiente è test e il nome della classe è my.class:

    Error in deployment for environment test
The revision is deployed, but traffic cannot flow. Failed to instantiate the JavaCallout Class my.class

Causa: file JAR mancante

Diagnosi

  1. Determina il file JAR che dovrebbe contenere la classe (identificata nel passaggio 1 sopra) e che non è stato possibile istanziare.
  2. Controlla se il file JAR specifico è caricato a livello di proxy API o ambiente. Se il file JAR non viene caricato in nessuno dei livelli, vai a Risoluzione.
  3. Se il file JAR viene caricato, vai a Causa: file JAR danneggiato.

Risoluzione

  1. Se il file JAR è danneggiato o caricato parzialmente, ricompila il file JAR e caricalo al livello appropriato (proxy API o ambiente).
  2. Esegui nuovamente il deployment del proxy API.

Causa: file JAR danneggiato

Diagnosi

  1. Determina il file JAR che dovrebbe contenere la classe (identificata nel passaggio 1 sopra) che non è stato possibile istanziare.
  2. Verifica se il file JAR specifico è danneggiato. Ad esempio, se non riesci a decomprimere il file perché è danneggiato o è stato caricato parzialmente. Se è danneggiato, vai a Risoluzione.
  3. Se il file JAR non è danneggiato, vai a Causa: file di classe mancante.

Risoluzione

  1. Ricostruisci i file JAR danneggiati e caricali al livello appropriato (proxy API o ambiente).
  2. Esegui nuovamente il deployment del proxy API.

Causa: file della classe mancante

Diagnosi

  1. Controlla se il file della classe Java specifico (identificato nel passaggio 1 sopra) fa parte del file JAR specificato in >ResourceURL< o di uno dei file JAR dipendenti.
  2. Se il file della classe non esiste in nessuno dei file JAR, hai determinato la causa dell'errore. Vai a Risoluzione.
  3. Se il file della classe esiste in uno dei file JAR specificati nel criterio JavaCallout, deve esserci un problema con il codice Java o con la classe dipendente che causa questo errore. Per ricevere aiuto, contatta l'assistenza Apigee.

Risoluzione

  1. Ricompila il file JAR con i file di classe mancanti e caricalo al livello appropriato (proxy API o livello di ambiente).
  2. Esegui nuovamente il deployment del proxy API.

Carica il file JAR

Assicurati che l'elemento della risorsa con tutte le classi necessarie esista a livello di proxy API o ambiente. Per ulteriori informazioni, vedi File di risorse.

  1. Per caricare una risorsa a livello di proxy API, fai clic su + (segno più) nella scheda Risorse, poi seleziona Importa file e carica il file dalla tua macchina locale. Il nome del file deve corrispondere all'elemento >ResourceURL<, ma senza il prefisso java://.

    Nella scheda Risorse, seleziona Importa file.

  2. Se vuoi che una risorsa sia disponibile per più di un proxy API nello stesso ambiente, caricala nell'ambiente. Dovrai utilizzare l'API Apigee, come descritto in File di risorse.

    Ad esempio, inserisci la seguente chiamata API dalla macchina locale per caricare il file specificato a livello di ambiente:

    curl -H "Content-Type: application/octet-stream" \
-X POST  -H "Authorization: Bearer $TOKEN" --data-binary @{classes.jar} \
"https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles?name=myresouce.jar&type=java"

    Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl.

    Esegui la chiamata API dalla stessa directory del file.

  3. Per rendere il file disponibile per tutti i proxy API in tutti gli ambienti dell'organizzazione, puoi omettere i dettagli dell'ambiente nel percorso di base. Ad esempio:

    curl -H "Content-Type: application/octet-stream" \
-X POST  -H "Authorization: Bearer $TOKEN" --data-binary @{classes.jar} \
"https://apigee.googleapis.com/v1/organizations/$ORG/resourcefiles?name=myresouce.jar&type=java"

    Dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta la sezione Utilizzare curl.