Fehler beim Entpacken der Nutzlast beheben

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

HTTP-Statuscodefehler

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

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 tritt aus verschiedenen Gründen auf. 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 wurde.
  • Die zum Verarbeiten der Anfrage erforderlichen Header fehlen.
  • Für das Abo wurde ein falscher HTTP-Endpunkt konfiguriert.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Überprüfen Sie das Format Ihrer Nutzlast (Nachrichtendaten). Achten Sie darauf, dass sie dem vom HTTP-Endpunkt angegebenen Anfrageformat entspricht.
  • 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 enthalten, es können aber auch andere erforderlich sein.
  • Prüfen Sie, ob der für Ihr Abo konfigurierte HTTP-Endpunkt gültig ist.
  • Aktivieren Sie die 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 geringe Anzahl von 400-Fehlern feststellen, die Sie überprü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 wurde.

Versuchen Sie Folgendes, um dieses Problem zu beheben:

  • Aktivieren Sie die Push-Authentifizierung. Die Verwendung der Push-Authentifizierung ist bei der Einbindung in Cloud Run oder App Engine wichtig.

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

415 Nicht unterstützter Medientyp

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

415 Unsupported Media Type

Dieser Fehler tritt aus verschiedenen Gründen auf. 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 dieses Problem zu beheben:

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

431 Anfrageheader-Felder zu groß / 413 Inhalte zu groß

Der folgende Fehler tritt auf, wenn Pub/Sub die Anfrage nicht verarbeiten kann, da 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.

Um diese Probleme zu beheben, versuchen Sie Folgendes:

  • 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 funktioniert Ihr Abo weiterhin, aber die fehlerhaften Nachrichten werden zur weiteren Analyse an ein separates 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

  • Wenn Sie weiterhin Probleme beim Entpacken der Nutzlast haben, lesen Sie den Abschnitt Support.