Fehler beim Entpacken der Nutzlast beheben

Auf dieser Seite erfahren Sie, wie Sie Probleme beim Entpacken der Nutzlast beheben.

Fehler im HTTP-Statuscode

Beim Entpacken der Nutzlast können häufige Fehler im HTTP-Statuscode auftreten. Sie können die Fehler mit dem Messwert push_request_count beobachten.

400-Fehler – ungültige Anfrage

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

400 Bad Request

Für diesen Fehler gibt es mehrere Gründe. Im Folgenden sind einige der häufigsten Ursachen für diesen Fehler aufgeführt:

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

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Überprüfen Sie das Format der Nutzlast (Nachrichtendaten). Er 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 den Nachrichtenattributen hinzufügen. Ein Beispiel kann Content-Type sein, aber andere können auch erforderlich sein.
  • Prüfen Sie, ob der für Ihr Abo konfigurierte HTTP-Endpunkt gültig ist.
  • Aktivieren Sie Dead Letter Queue (DLQ) für Ihr Push-Abo. Dadurch werden einzelne Nachrichten weitergeleitet, die nicht zugestellt werden können. Es ist hilfreich, DLQ zu aktivieren, wenn Sie eine kleine Anzahl von 400-Fehlern sehen, die Sie prüfen 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 Verwendung der Push-Authentifizierung ist für die Integration in Cloud Run oder App Engine wichtig.

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

415 Nicht unterstützter Medientyp

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage nicht verarbeiten kann, weil das Nutzlastformat in einem nicht unterstützten Format vorliegt.

415 Unsupported Media Type

Für diesen Fehler gibt es mehrere Gründe. Im Folgenden sind einige der häufigsten Ursachen für diesen Fehler aufgeführt:

  • Im Endpunkt fehlt der erforderliche Medientyp-Header.

Versuchen Sie Folgendes, um das Problem zu beheben:

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

431 Anfrageheader zu groß / 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 die Header-Limitgröße eines Servers überschreiten.

Versuchen Sie Folgendes, um diese Probleme zu beheben:

  • Deaktivieren Sie Metadaten schreiben.
  • Aktivieren Sie die Dead Letter Queue (DLQ) für Ihr Push-Abo. Dadurch werden einzelne Nachrichten weitergeleitet, die nicht zugestellt werden können. Danach läuft Ihr Abo weiter, aber die fehlerhaften Nachrichten werden zur weiteren Analyse an ein anderes Thema weitergeleitet.

Prüfen, ob das Entpacken der Nutzlast aktiviert ist

  1. Öffnen Sie in der Google Cloud Console die Seite Abos.

    Pub/Sub-Abos öffnen

  2. Klicken Sie auf den Namen Ihres Dienstes.

    Die Seite mit den Dienstdetails wird geöffnet.

  3. Suchen Sie in der Konfigurationstabelle die folgenden Werte: Entpacken von Nachrichtendaten und Nachrichtenmetadaten schreiben.

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

Nächste Schritte

  • Sollten weiterhin Probleme beim Entpacken der Nutzlast auftreten, lesen Sie unter Support nach.