Risoluzione degli errori ricevuti in risposta

Questa pagina descrive come risolvere i problemi relativi agli errori ricevuti in una risposta da una richiesta alla tua API.

Upstream backend unavailable

Se ricevi il codice di errore 14 e il messaggio upstream backend unavailable, indica che il Extensible Service Proxy (ESP) non riesce a raggiungere il backend del servizio. Verifica quanto segue:

  • Assicurati che il servizio di backend sia in esecuzione. La modalità di esecuzione dipende dal backend.

  • È specificata la porta dell'indirizzo IP corretto del servizio di backend:
    • Per GKE, controlla il valore del flag ESP --backend (l'opzione breve è -a) nel file manifest di deployment (spesso chiamato deployment.yaml).
    • Per Compute Engine, controlla il valore del flag ESP --backend (l'opzione breve è -a) nel comando docker run.

reset reason: connection failure

Se ricevi il codice HTTP 503 o il codice gRPC 14 e il messaggio upstream connect error or disconnect/reset before headers. reset reason: connection failure, significa che ESPv2 non riesce a raggiungere il backend del servizio.

Per risolvere il problema, controlla gli elementi riportati di seguito.

Indirizzo del backend

ESPv2 deve essere configurato con l'indirizzo del backend corretto. I problemi più comuni includono:

  • Lo schema dell'indirizzo di backend deve corrispondere al tipo di applicazione di backend. I backend OpenAPI devono essere http:// e i backend gRPC grpc://.
  • Per ESPv2 di cui è stato eseguito il deployment su Cloud Run, lo schema dell'indirizzo di backend deve essere https:// o grpcs://. s indica a ESPv2 di configurare TLS con il backend.

Ricerca DNS

Per impostazione predefinita, ESPv2 tenta di risolvere i nomi di dominio in indirizzi IPv6. Se la risoluzione IPv6 non va a buon fine, ESPv2 torna agli indirizzi IPv4.

Per alcune emittenti, il meccanismo di riserva potrebbe non funzionare come previsto. In alternativa, puoi forzare ESPv2 a utilizzare indirizzi IPv4 tramite il flag --backend_dns_lookup_family.

Questo errore è comune se configuri un connettore VPC serverless per ESPv2 di cui è stato eseguito il deployment su Cloud Run. Le VPC non supportano il traffico IPv6.

API is not enabled for the project

Se hai inviato una chiave API nella richiesta, un messaggio di errore come "L'API my-api.endpoints.example-project-12345.cloud.goog non è abilitata per il project" indica che la chiave API è stata creata in un progetto Google Cloud diverso dall'API. Per risolvere il problema, puoi creare la chiave API nello stesso progetto Google Cloud a cui è associata l'API oppure attivare l'API nel progetto Google Cloud in cui è stata creata la chiave API.

Service control request failed with HTTP response code 403

Se ricevi il codice di errore 14 e il messaggio Service control request failed with HTTP response code 403, significa che l'API Service Control (servicecontrol.googleapis.com) non è abilitata nel progetto.

  1. Consulta la sezione Controllare i servizi richiesti per assicurarti che nel tuo progetto siano abilitati tutti i servizi richiesti da Endpoints ed ESP.

  2. Consulta la sezione Controllo delle autorizzazioni richieste per assicurarti che tutte le autorizzazioni richieste siano presenti per l'account di servizio associato all'istanza in cui è in esecuzione ESP.

Method doesn't allow unregistered callers

ESP risponde con l'errore Method doesn't allow unregistered callers quando hai specificato allow_unregistered_calls: false nel file di configurazione dell'API gRPC, ma la richiesta alla tua API non ha una chiave API assegnata a un parametro di query denominato key.

Se devi generare una chiave API per effettuare chiamate alla tua API, consulta Creare una chiave API.

Method does not exist

La risposta Method does not exist indica che il metodo HTTP (GET, POST o altro) nel percorso dell'URL specificato non è stato trovato. Per risolvere i problemi, confronta la configurazione del servizio che hai disegnato per assicurarti che il nome del metodo e il percorso dell'URL che invii nella richiesta corrispondano:

  1. Nella console Google Cloud, vai alla pagina Servizi endpoint per il tuo progetto.

    Vai alla pagina Servizi endpoint

  2. Se hai più di un'API, seleziona quella a cui hai inviato la richiesta.

  3. Fai clic sulla scheda Cronologia deployment.

  4. Seleziona il deployment più recente per visualizzare la configurazione del servizio.

Transport is closing

Se ricevi un codice di errore 13 e il messaggio transport is closing, significa che l'ESP non è raggiungibile.

Controlla i log degli errori dell'ESP. La modalità di esecuzione dipende dal backend. Vai ai seguenti argomenti per ulteriori informazioni:

Risposte impreviste

Se la risposta HTTP sembra essere binaria, questo potrebbe indicare che la richiesta sta raggiungendo l'API utilizzando la porta HTTP2 quando avevi intenzione di utilizzare la porta HTTP1.

Controlla le opzioni di configurazione della porta per l'ESP. Poiché i flag per i contenuti nel formato breve, -p (per HTTP1) e -P (per HTTP2), sono simili, ti consigliamo di utilizzare i flag per i contenuti nel formato lungo: --http_port per HTTP1 e --http2_port per HTTP2.

Anche una configurazione errata del backend dell'ESP potrebbe causare risposte impreviste. Assicurati che il flag di backend (-a o --backend) sia impostato su un URL gRPC come --backend=grpc://127.0.0.1:8081.

Per ulteriori dettagli sui flag ESP, consulta Opzioni di avvio di ESP.

Controllare i log di Cloud Logging

Per utilizzare i log di Cloud Logging per risolvere i problemi di risposta:

  1. Nella console Google Cloud, vai alla pagina Logging.

    Vai alla pagina Esplora log

  2. Nella parte superiore della pagina, seleziona il progetto Google Cloud.

  3. Utilizzando il menu a discesa a sinistra, seleziona API prodotta > [YOUR_SERVICE_NAME].

  4. Modifica l'intervallo di tempo finché non visualizzi una riga che mostra l'errore di risposta.

  5. Espandi il payload JSON e cerca error_cause.

    • Se error_cause è impostato su application, indica un problema nel codice.

    • Se error cause è diverso e non riesci a risolvere il problema, esporta il log e includilo in qualsiasi comunicazione con Google.

Vai ai seguenti argomenti per ulteriori informazioni: