Probleme beim Entpacken der Nutzlast beheben

Auf dieser Seite wird beschrieben, wie Sie Probleme mit dem Entpacken der Nutzlast beheben.

Fehler bei HTTP-Statuscodes

Bei der Verwendung des Entpackens der Nutzlast können häufig Fehler bei HTTP- Statuscodes auftreten. Sie können die Fehler mit der push_request_count Messwert beobachten.

400 – Ungültige Anfrage

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage aufgrund einer Fehlkonfiguration oder fehlender Daten nicht verarbeiten kann. 

400 Bad Request

Dieser Fehler kann mehrere Ursachen haben. Im Folgenden sind einige der häufigsten Ursachen für den Fehler aufgeführt:

  • Die Nutzlast (Nachrichtendaten) entspricht nicht dem erwarteten Anfrageformat, das vom HTTP-Endpunkt angegeben wird.
  • Die erforderlichen Header zum Verarbeiten der Anfrage fehlen.
  • Für das Abo ist ein falscher HTTP-Endpunkt konfiguriert.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Prüfen Sie das Format Ihrer Nutzlast (Nachrichtendaten). Es muss dem erwarteten Anfrageformat entsprechen, das vom HTTP-Endpunkt angegeben wird.
  • Prüfen Sie, ob die Anfrage die erforderlichen Header enthält. Wenn die Header fehlen, müssen Sie sie möglicherweise in den Nachrichtenattributen hinzufügen. Beispielsweise müssen Sie möglicherweise Content-Type einfügen, aber auch andere Header können erforderlich sein.
  • Prüfen Sie, ob der für Ihr Abo konfigurierte HTTP-Endpunkt gültig ist.
  • Aktivieren Sie die Dead-Letter-Warteschlange (DLQ) für Ihr Push-Abo. Dadurch werden einzelne Nachrichten umgeleitet, die nicht zugestellt werden können. Es ist hilfreich, die DLQ zu aktivieren, wenn Sie eine kleine Anzahl von 400-Fehlern sehen, die Sie untersuchen möchten.

401 – Nicht autorisiert / 403 – Verboten

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage aufgrund falscher oder ungültiger Anmeldedaten nicht verarbeiten kann.

401 unauthorized / 403 forbidden

Dieser Fehler tritt auf, weil das Push-Abo nicht authentifiziert ist.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Aktivieren Sie die Push-Authentifizierung. Die Push-Authentifizierung ist wichtig, wenn Sie eine Integration mit Cloud Run oder App Engine vornehmen.

    Wenn die Push-Authentifizierung mit Ihrer Lösung nicht funktioniert, müssen Sie möglicherweise Ihren eigenen Autorisierungsschlüssel oder API-Schlüssel in den Attributen der Veröffentlichungsnachricht hinzufügen.

415 – Nicht unterstützter Medientyp

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage nicht verarbeiten kann, weil das Nutzlastformat nicht unterstützt wird.

415 Unsupported Media Type

Dieser Fehler kann mehrere Ursachen haben. Im Folgenden sind einige der häufigsten Ursachen für den Fehler aufgeführt:

  • Im Endpunkt fehlt der erforderliche Header für den Medientyp.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Für Ihren Endpunkt ist wahrscheinlich ein Content-Type-Header erforderlich. Standardmäßig wird beim Entpacken der Nutzlast kein Header für den Medientyp festgelegt. Sie können einen Content-Type Header festlegen, indem Sie ihn als Attribut der Veröffentlichungsnachricht anhängen.

431 – Anfrageheader zu lang / 413 – Inhalt zu groß

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage nicht verarbeiten kann, weil der in der Anfrage gesendete Inhalt zu groß ist.

431 request header fields too Large / 413 content too large

Dieser Fehler tritt auf, wenn die Attribute in einer Pub/Sub Nachricht das Header-Limit eines Servers überschreiten.

Versuchen Sie Folgendes, um diese Probleme zu beheben:

  • Deaktivieren Sie Metadaten schreiben.
  • Aktivieren Sie die Dead-Letter-Warteschlange (DLQ) für Ihr Push-Abo. Dadurch werden einzelne Nachrichten umgeleitet, die nicht zugestellt werden können. Danach funktioniert Ihr Abo weiterhin, aber die Nachrichten mit Fehlern werden zur weiteren Analyse an ein separates Thema umgeleitet.

Prüfen, ob das Entpacken der Nutzlast aktiviert ist

  1. Rufen Sie in der Google Cloud Console die Seite Abos auf.

    Pub/Sub-Abos aufrufen

  2. Klicken Sie auf den Namen Ihres Dienstes.

    Die Seite mit den Dienstdetails wird geöffnet.

  3. Suchen Sie in der Konfigurationstabelle nach den folgenden Werten: Entpacken von Nachrichtendaten und Nachrichtenmetadaten schreiben.

    Der Status des Entpackens der Nutzlast (aktiviert oder deaktiviert) wird in der entsprechenden Tabellenzeile angezeigt.

Nächste Schritte

  • Wenn weiterhin Probleme mit dem Entpacken der Nutzlast auftreten, lesen Sie den Hilfeartikel Support erhalten.