Questa pagina mostra come risolvere i problemi relativi allo scollegamento del payload.
Errori relativi ai codici di stato HTTP
Quando utilizzi il smontaggio del payload, possono verificarsi errori comuni dei codici di stato HTTP.
Puoi monitorare gli errori con la metrica push_request_count.
400 Bad Request
Il seguente errore si verifica quando Pub/Sub non riesce a elaborare la richiesta a causa di una configurazione errata o di dati mancanti.
400 Bad Request
Questo errore si verifica per diversi motivi. Di seguito sono riportate alcune delle cause più comuni dell'errore:
- Il payload (dati del messaggio) non corrisponde al formato della richiesta previsto specificato dall'endpoint HTTP.
- Mancano le intestazioni necessarie per elaborare la richiesta.
- Per l'abbonamento è configurato un endpoint HTTP errato.
Per risolvere il problema, prova le seguenti soluzioni:
- Controlla il formato del payload (dati del messaggio). Assicurati che corrisponda al formato della richiesta previsto specificato dall'endpoint HTTP.
- Verifica che la richiesta contenga le intestazioni richieste. Se mancano le intestazioni,
potrebbe essere necessario aggiungerle agli attributi del messaggio. Un esempio potrebbe includere
Content-Type, ma potrebbero essere necessari anche altri. - Verifica che l'endpoint HTTP configurato per l'abbonamento sia valido.
- Attiva la coda dei messaggi non recapitabili (DLQ) nella tua sottoscrizione push. In questo modo, i singoli messaggi che non possono essere consegnati vengono reindirizzati. È utile attivare la coda DLQ se noti un numero ridotto di errori 400 che vuoi ispezionare.
401 unauthorized / 403 forbidden
Il seguente errore si verifica quando Pub/Sub non riesce a elaborare la richiesta a causa di credenziali errate o non valide.
401 unauthorized / 403 forbidden
Questo errore si verifica perché l'abbonamento push non è autenticato.
Per risolvere il problema, prova le seguenti soluzioni:
Attiva l'autenticazione push. L'utilizzo dell'autenticazione push è importante se esegui l'integrazione con Cloud Run o App Engine.
Se l'autenticazione push non funziona con la tua soluzione, potresti dover aggiungere la tua chiave di autorizzazione o chiave API negli attributi del messaggio di pubblicazione.
415 Unsupported Media Type
Il seguente errore si verifica quando Pub/Sub non riesce a elaborare la richiesta perché il formato del payload non è supportato.
415 Unsupported Media Type
Questo errore si verifica per diversi motivi. Di seguito sono riportate alcune delle cause più comuni dell'errore:
- Nell'endpoint manca l'intestazione media-type obbligatoria.
Per risolvere il problema, prova la seguente soluzione:
- È probabile che il tuo endpoint richieda un'intestazione
Content-Type. Per impostazione predefinita, lo scollegamento del payload non imposta un'intestazione del tipo di media. Puoi impostare un'intestazioneContent-Typeallegandola come attributo del messaggio di pubblicazione.
431 request header fields too large / 413 content too large
Il seguente errore si verifica quando Pub/Sub non riesce a elaborare la richiesta perché i contenuti inviati nella richiesta sono troppo grandi.
431 request header fields too Large / 413 content too large
Questo errore si verifica se gli attributi in un messaggio Pub/Sub superano le dimensioni limite dell'intestazione di un server.
Per risolvere questi problemi, prova le seguenti soluzioni:
- Disattiva l'opzione Scrivi metadati.
- Attiva la coda dei messaggi non recapitabili (DLQ) nella tua sottoscrizione push. In questo modo, i singoli messaggi che non possono essere consegnati vengono reindirizzati. Dopodiché, la sottoscrizione continua a funzionare, ma i messaggi con errori vengono reindirizzati a un argomento separato per un'ulteriore analisi.
Controllare se l'annullamento del wrapping del payload è attivo
Nella console Google Cloud, vai alla pagina Abbonamenti.
Fai clic sul nome del servizio.
Viene visualizzata la pagina dei dettagli del servizio.
Nella tabella di configurazione, individua i seguenti valori: Smontaggio dei dati dei messaggi e Scrivere i metadati dei messaggi.
Lo stato dell'imballaggio del payload (abilitato o disabilitato) viene visualizzato nella riga della tabella corrispondente.
Passaggi successivi
- Se i problemi con lo scollegamento del payload persistono, consulta la sezione Ricevere assistenza.