Fehlerbehebung

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite werden Methoden zur Fehlerbehebung für häufige Fehler beschrieben, die bei der Verwendung von Cloud Storage auftreten können.

Im Google Cloud-Status-Dashboard finden Sie Informationen zu regionalen oder globalen Vorfällen, die Google Cloud-Dienste wie Cloud Storage betreffen.

Unverarbeitete Anfragen protokollieren

Bei Verwendung von Tools wie gcloud oder den Cloud Storage-Clientbibliotheken werden viele der Anfrage- und Antwortinformationen vom Tool verarbeitet. Manchmal ist es jedoch hilfreich, Details zur Unterstützung bei der Fehlerbehebung anzuzeigen. Gehen Sie nach der folgenden Anleitung vor, um Anfrage- und Antwortheader für das Tool zurückzugeben:

Console

Die Anzeige von Anfrage- und Antwortinformationen hängt vom Browser ab, über den Sie auf die Google Cloud Console zugreifen. Google Chrome:

  1. Klicken Sie auf die Chrome-Schaltfläche für das Hauptmenü ().

  2. Wählen Sie Weitere Tools aus.

  3. Klicken Sie auf Entwicklertools.

  4. Klicken Sie im angezeigten Bereich auf den Tab Network.

Befehlszeile

gcloud

Verwenden Sie globale Debugging-Flags in Ihrer Anfrage. Beispiel:

gcloud storage ls gs://my-bucket/my-object --log-http --verbosity=debug

gsutil

Verwenden Sie das globale -D-Flag in Ihrer Anfrage. Beispiel:

gsutil -D ls gs://my-bucket/my-object

Clientbibliotheken

C++

  • Legen Sie die Umgebungsvariable CLOUD_STORAGE_ENABLE_TRACING=http fest, um den gesamten HTTP-Traffic abzurufen.

  • Legen Sie die Umgebungsvariable CLOUD_STORAGE_ENABLE_CLOG=yes fest, um das Logging für jeden RPC abzurufen.

C#

Fügen Sie über ApplicationContext.RegisterLogger einen Logger hinzu und legen Sie Logging-Optionen für den Nachrichten-Handler HttpClient fest. Weitere Informationen finden Sie unter Häufig gestellte Fragen:

Go

Legen Sie die Umgebungsvariable GODEBUG=http2debug=1 fest. Weitere Informationen finden Sie im Go-Paket net/http.

Wenn Sie auch den Anfragetext protokollieren möchten, verwenden Sie einen benutzerdefinierten HTTP-Client.

Java

  1. Erstellen Sie eine Datei mit dem Namen "logging.properties" mit folgendem Inhalt:

    # Properties file which configures the operation of the JDK logging facility.
    # The system will look for this config file to be specified as a system property:
    # -Djava.util.logging.config.file=${project_loc:googleplus-simple-cmdline-sample}/logging.properties
    
    # Set up the console handler (uncomment "level" to show more fine-grained messages)
    handlers = java.util.logging.ConsoleHandler
    java.util.logging.ConsoleHandler.level = CONFIG
    
    # Set up logging of HTTP requests and responses (uncomment "level" to show)
    com.google.api.client.http.level = CONFIG
  2. Logging.properties mit Maven verwenden

    mvn -Djava.util.logging.config.file=path/to/logging.properties insert_command

Weitere Informationen finden Sie unter Plug-in HTTP-Transport.

Node.js

Legen Sie die Umgebungsvariable NODE_DEBUG=https fest, bevor Sie das Knotenskript aufrufen.

PHP

Stellen Sie dem Client mit httpHandler Ihren eigenen HTTP-Handler bereit und richten Sie Middleware ein, um die Anfrage und die Antwort zu protokollieren.

Python

Verwenden Sie das Logging-Modul. Beispiel:

import logging
import http.client

logging.basicConfig(level=logging.DEBUG)
http.client.HTTPConnection.debuglevel=5

Ruby

Fügen Sie oben in der Datei .rb file nach require "google/cloud/storage" Folgendes hinzu:

ruby
Google::Apis.logger.level = Logger::DEBUG

Fehlercodes

Nachfolgend sehen Sie einige gängige HTTP-Statuscodes.

301: Dauerhaft verschoben

Problem: Ich bin dabei, eine statische Website einzurichten, und beim Zugriff auf einen Verzeichnispfad wird ein leeres Objekt und der HTTP-Antwortcode 301 zurückgegeben.

Lösung: Wenn beim Zugriff auf ein Verzeichnis, z. B. http://www.example.com/dir/, ein Nullbyte-Objekt vom Browser heruntergeladen wird und Sie den HTTP-Antwortcode 301 erhalten, enthält Ihr Bucket sehr wahrscheinlich ein leeres Objekt mit diesem Namen. Prüfen Sie, ob dies der Fall ist, und beheben Sie das Problem:

  1. Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.

    Buckets aufrufen

  2. Klicken Sie im oberen Bereich der Google Cloud Console auf Activate Cloud Shell. Cloud Shell aktivieren
  3. Führen Sie gcloud storage ls --recursive gs://www.example.com/dir/ aus. Wenn die Ausgabe http://www.example.com/dir/ enthält, ist an diesem Speicherort ein leeres Objekt vorhanden.
  4. Entfernen Sie das leere Objekt mit dem folgenden Befehl: gcloud storage rm gs://www.example.com/dir/

Sie können nun auf http://www.example.com/dir/ zugreifen und die index.html-Datei dieses Verzeichnisses anstelle des leeren Objekts zurückgeben lassen.

400: Ungültige Anfrage

Problem: Bei einem fortsetzbaren Upload habe ich diesen Fehler und die Meldung Failed to parse Content-Range header. erhalten.

Lösung: Der Wert, den Sie im Header Content-Range verwendet haben, ist ungültig. Content-Range: */* ist beispielsweise ungültig und sollte als Content-Range: bytes */* angegeben werden. Wenn Sie diesen Fehler erhalten, ist Ihr aktueller fortsetzbarer Upload nicht mehr aktiv und Sie müssen einen neuen fortsetzbaren Upload starten.

401: Nicht autorisiert

Problem: Anfragen an einen öffentlichen Bucket direkt oder über Cloud CDN schlagen mit den Antworten HTTP 401: Unauthorized und Authentication Required fehl.

Lösung: Achten Sie darauf, dass Ihr Client oder ein Zwischen-Proxy Anfragen an Cloud Storage keinen Authorization-Header hinzufügt. Jede Anfrage mit einem Authorization-Header wird überprüft, als wenn es sich um einen Authentifizierungsversuch handeln würde, selbst wenn die Anfrage leer ist.

403: Konto deaktiviert

Problem: Ich habe versucht, einen Bucket zu erstellen, erhalte jedoch den Fehler 403 Account Disabled.

Lösung: Dieser Fehler weist darauf hin, dass Sie die Abrechnung für das verknüpfte Projekt noch nicht aktiviert haben. Wie Sie vorgehen müssen, um die Abrechnung zu aktivieren, erfahren Sie unter Abrechnung für ein Projekt aktivieren.

Wenn die Abrechnung aktiviert ist und Sie weiterhin diese Fehlermeldung erhalten, wenden Sie sich an den Support. Geben Sie dabei Ihre Projekt-ID und eine Beschreibung des Problems an.

403: Unzulässig

Problem: Ich sollte die Berechtigung haben, auf einen bestimmten Bucket oder ein bestimmtes Objekt zuzugreifen. Wenn ich das aber versuche, erhalte ich einen 403 - Forbidden-Fehler mit einer Nachricht wie dieser: example@email.com does not have storage.objects.get access to the Google Cloud Storage object.

Lösung: Ihnen fehlt eine IAM-Berechtigung für den Bucket oder das Objekt, die zum Abschließen der Anfrage erforderlich ist. Wenn Sie davon ausgehen, dass Sie die Anfrage stellen können, aber dies nicht können, führen Sie die folgenden Prüfungen durch:

  1. Ist der in der Fehlermeldung genannte Empfänger derjenige, den Sie erwartet haben? Wenn die Fehlermeldung auf eine unerwartete E-Mail-Adresse oder einen „anonymen Aufrufer“ verweist, verwendet Ihre Anfrage nicht die gewünschten Anmeldedaten. Das kann daran liegen, dass das Tool, mit dem Sie die Anfrage stellen, mit den Anmeldedaten eines anderen Alias oder einer anderen Entität eingerichtet wurde, oder dass die Anfrage in Ihrem Namen von einem Dienstkonto gestellt wird.

  2. Ist die in der Fehlermeldung referenzierte Berechtigung eine, die Sie benötigen? Wenn die Berechtigung unerwartet ist, liegt dies wahrscheinlich daran, dass das von Ihnen verwendete Tool zusätzlichen Zugriff benötigt, um Ihre Anfrage abzuschließen. Wenn Sie beispielsweise Objekte in einem Bucket im Bulk löschen möchten, muss gcloud zuerst eine Liste der Objekte im Bucket erstellen, die gelöscht werden sollen. Für diesen Teil der Bulk-Löschaktion ist die Berechtigung storage.objects.list erforderlich, die möglicherweise überraschend ist, da das Ziel das Löschen von Objekten ist, für das normalerweise nur die Berechtigung storage.objects.delete erforderlich ist. Wenn dies die Ursache Ihrer Fehlermeldung ist, prüfen Sie, ob Ihnen IAM-Rollen mit den zusätzlichen erforderlichen Berechtigungen zugewiesen sind.

  3. Haben Sie die IAM-Rolle für die vorgesehene Ressource oder die übergeordnete Ressource? Wenn Ihnen zum Beispiel die Rolle Storage Object Viewer für ein Projekt zugewiesen ist und Sie versuchen, ein Objekt herunterzuladen, prüfen Sie, ob sich das Objekt in einem Bucket im Projekt befindet. Möglicherweise haben Sie versehentlich die Berechtigung Storage Object Viewer für ein anderes Projekt.

403: Unzulässig

Problem: Ich lade meine Inhalte aus storage.cloud.google.com herunter und erhalte die Fehlermeldung 403: Forbidden, wenn ich den Browser verwende, um das Objekt über die URL aufzurufen:

https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME

Lösung: Die Verwendung von storage.cloud.google.com zum Herunterladen von Objekten wird als authentifizierter Browserdownload bezeichnet. Dabei wird die cookiebasierte Authentifizierung verwendet. Wenn Sie Datenzugriffslogs in Cloud-Audit-Logs so konfiguriert haben, dass der Zugriff auf Objekte verfolgt wird, besteht eine der Einschränkungen dieser Funktion darin, authentifizierte Browserdownloads zu verwenden. Sie können nicht zum Herunterladen eines verfolgten Objekts verwendet werden, es sei denn, das Objekt ist öffentlich lesbar. Der Versuch, einen authentifizierten Browserdownload für nicht öffentliche Objekte zu verwenden, führt zu einer 403-Antwort. Diese Einschränkung will dem Phishing für Google-IDs entgegenwirken, die für die cookiebasierte Authentifizierung verwendet werden.

Führen Sie einen der folgenden Schritte aus, um dieses Problem zu vermeiden:

  • Verwenden Sie direkte API-Aufrufe, die nicht authentifizierte Downloads unterstützen, anstatt authentifizierte Browserdownloads.
  • Deaktivieren Sie die Cloud Storage-Audit-Logs zum Datenzugriff, die den Zugriff auf die betroffenen Objekte verfolgen. Beachten Sie, dass Audit-Logs zum Datenzugriff auf oder oberhalb der Projektebene eingerichtet werden und gleichzeitig auf mehreren Ebenen aktiviert werden können.
  • Legen Sie Ausnahmen fest, um bestimmte Nutzer vom Audit-Log-Tracking von Datenzugriffen auszuschließen. So können diese Nutzer authentifizierte Browserdownloads ausführen.
  • Machen Sie die betroffenen Objekte öffentlich lesbar, indem Sie allUsers oder allAuthenticatedUsers Leseberechtigung erteilen. In Audit-Logs zum Datenzugriff wird kein Zugriff auf öffentliche Objekte aufgezeichnet.

409: Konflikt

Problem: Ich habe versucht, einen Bucket zu erstellen, erhalte jedoch folgenden Fehler:

409 Conflict. Sorry, that name is not available. Please try a different one.

Lösung: Der Bucket-Name, den Sie verwenden wollten (z. B. gs://cats oder gs://dogs), ist bereits vergeben. Cloud Storage verfügt über einen globalen Namespace. Sie können einem Bucket daher keinen Namen geben, der bereits für einen anderen Bucket verwendet wird. Wählen Sie einen Namen, der noch nicht vergeben ist.

429: Zu viele Anfragen

Problem: Meine Anfragen werden mit dem Fehler 429 Too Many Requests abgelehnt.

Lösung: Sie erreichen ein Limit für die Anzahl der Anfragen, die Cloud Storage für eine bestimmte Ressource zulässt. Eine Erläuterung der Limits in Cloud Storage finden Sie unter Cloud Storage-Kontingente. Wenn Ihre Arbeitslast aus 1.000 Anfragen pro Sekunde an einen Bucket besteht, finden Sie in den Richtlinien für die Anforderungsrate und Zugriffsverteilung Best Practices, einschließlich der schrittweisen Erhöhung Ihrer Arbeitslast und der Vermeidung sequenzieller Dateinamen.

Fehler in der Google Cloud Console diagnostizieren

Problem: Wenn ich die Google Cloud Console für einen Vorgang verwende, wird eine generische Fehlermeldung angezeigt. Ich erhalte beispielsweise eine Fehlermeldung, wenn ich versuche, einen Bucket zu löschen, es wird aber nicht angezeigt, warum der Vorgang fehlgeschlagen ist.

Lösung: Verwenden Sie die Benachrichtigungen der Google Cloud Console, um detaillierte Informationen zum fehlgeschlagenen Vorgang anzeigen zu lassen:

  1. Klicken Sie in der Google Cloud Console auf die Schaltfläche Benachrichtigungen.

    Benachrichtigungen

    In einem Drop-down-Menü werden die zuletzt von der Google Cloud Console ausgeführten Vorgänge angezeigt.

  2. Klicken Sie auf das Element, zu dem Sie mehr erfahren möchten.

    Eine Seite mit detaillierten Informationen zum Vorgang wird geöffnet.

  3. Klicken Sie auf die einzelnen Zeilen, um die detaillierten Fehlerinformationen zu maximieren.

    Nachstehend finden Sie ein Beispiel für eine Fehlermeldung, die angezeigt wird, wenn das Löschen eines Buckets fehlgeschlagen ist. Darin wird erläutert, dass eine Bucket-Aufbewahrungsrichtlinie das Löschen des Buckets verhindert hat.

    Detailinformationen nach fehlgeschlagenem Löschen eines Buckets

Fehler bei einer statischen Website

Die folgenden Probleme treten häufig auf, wenn Sie einen Bucket zum Hosten einer statischen Website einrichten.

HTTPS-Bereitstellung

Problem: Ich möchte meine Inhalte über HTTPS bereitstellen, ohne einen Load-Balancer zu verwenden.

Lösung: Sie können statische Inhalte über HTTPS mit direkten URIs wie https://storage.googleapis.com/my-bucket/my-object bereitstellen. Außerdem haben Sie zur Bereitstellung Ihrer Inhalte über eine benutzerdefinierte Domain und SSL folgende Möglichkeiten:

Domainbestätigung

Problem: Ich kann meine Domain nicht bestätigen.

Lösung: Normalerweise werden Sie während der Prüfung in der Search Console angewiesen, eine Datei in Ihre Domain hochzuladen. Dies ist jedoch ohne den entsprechenden Bucket eventuell nicht möglich. Diesen können Sie erst erstellen, nachdem Sie die Domainbestätigung durchgeführt haben.

Überprüfen Sie in diesem Fall die Inhaberschaft mithilfe der Verifizierungsmethode Domain Name Provider. Weitere Informationen hierzu finden Sie unter Prüfung der Domaininhaberschaft. Diese Bestätigung kann durchgeführt werden, bevor der Bucket erstellt wird.

Seite nicht zugänglich

Problem: Ich erhalte die Fehlermeldung Access denied für eine Webseite, die über meine Website bereitgestellt wird.

Lösung: Prüfen Sie, ob das Objekt öffentlich freigegeben ist. Wenn dies nicht der Fall ist, finden Sie eine Anleitung dazu unter Daten öffentlich machen.

Wenn Sie zuvor ein Objekt hochgeladen und freigegeben haben und dann eine neue Version hochladen, müssen Sie das Objekt noch einmal öffentlich freigeben. Der Grund hierfür ist, dass die öffentliche Berechtigung mit dem neuen Upload ersetzt wird.

Fehler beim Aktualisieren der Berechtigung

Problem: Ich erhalte eine Fehlermeldung, wenn ich versuche, meine Daten zu veröffentlichen.

Lösung: Achten Sie darauf, dass Sie die Berechtigung setIamPolicy für Ihr Objekt oder Ihren Bucket haben. Diese Berechtigung wird beispielsweise in der Rolle Storage Admin erteilt. Wenn Sie die Berechtigung setIamPolicy haben und weiterhin einen Fehler erhalten, unterliegt Ihr Bucket möglicherweise der Verhinderung des öffentlichen Zugriffs, wodurch der Zugriff auf allUsers oder allAuthenticatedUsers nicht möglich ist. Die Verhinderung des öffentlichen Zugriffs kann direkt für den Bucket festgelegt oder über eine Organisationsrichtlinie erzwungen werden, die auf einer höheren Ebene festgelegt ist.

Herunterladen von Inhalten

Problem: Meine Website wird im Browser nicht dargestellt. Stattdessen werde ich aufgefordert, den Inhalt meiner Website herunterzuladen.

Lösung: Wenn Sie ein MainPageSuffix als Objekt angeben, das keinen Webinhaltstyp aufweist, wird die Seite den Besuchern nicht angezeigt. Stattdessen werden sie dazu aufgefordert, die Inhalte der Website herunterzuladen. Aktualisieren Sie den Metadateneintrag content-type auf einen geeigneten Wert wie text/html, um dieses Problem zu beheben. Eine Anleitung dazu finden Sie unter Objektmetadaten bearbeiten.

Latenz

Nachfolgend einige Beispiele für häufig auftretende Latenzprobleme. Das Google Cloud-Status-Dashboard enthält Informationen zu regionalen oder globalen Vorfällen, die Google Cloud-Dienste wie Cloud Storage betreffen.

Latenz beim Hochladen oder Herunterladen

Problem: Beim Hochladen oder Herunterladen tritt eine erhöhte Latenz auf.

Lösung: Führen Sie mit dem Befehl gsutil perfdiag Leistungsdiagnosen der betroffenen Umgebung durch. Beachten Sie die folgenden häufigen Ursachen für Latenz beim Hochladen oder Herunterladen:

  • CPU- oder Speichereinschränkungen: Das Betriebssystem der betroffenen Umgebung sollte Tools zur Messung des lokalen Ressourcenverbrauchs haben, z. B. zur CPU- und Arbeitsspeichernutzung.

  • Laufwerk-E/A-Beschränkungen: Als Teil des gsutil perfdiag-Befehls verwenden Sie die Tests rthru_file und wthru_file, um die Leistungsauswirkungen zu messen, die durch die lokale Laufwerk-E/A verursacht werden.

  • Geografische Entfernung: Die Leistung kann durch die physische Trennung Ihres Cloud Storage-Buckets und der betroffenen Umgebung beeinflusst werden, insbesondere in Interkontinentalen Szenarien. Tests mit einem Bucket, der sich in derselben Region wie die betroffene Umgebung befindet, können zeigen, inwieweit die geografische Trennung zu Ihrer Latenz beiträgt.

    • Gegebenenfalls sollte der DNS-Resolver der betroffenen Umgebung das EDNS(0)-Protokoll verwenden, damit Anfragen aus der Umgebung über ein entsprechendes Google Front End weitergeleitet werden.

Latenz der Befehlszeile oder Clientbibliothek

Problem: Beim Zugriff auf Cloud Storage mit gcloud storage oder einer der Clientbibliotheken tritt eine erhöhte Latenz auf.

Lösung: Sowohl Befehlszeilen als auch Clientbibliotheken wiederholen Anfragen automatisch, wenn dies sinnvoll ist. Dieses Verhalten kann die Latenz aus Sicht des Endnutzers erhöhen. Verwenden Sie den Cloud Monitoring-Messwert storage.googleapis.com/api/request_count, um festzustellen, ob Cloud Storage konsistent einen wiederholbaren Antwortcode wie 429 oder 5xx bereitstellt.

Proxyserver

Problem: Ich stelle die Verbindung über einen Proxyserver her. Was muss ich tun?

Lösung: Für den Zugriff auf Cloud Storage über einen Proxyserver müssen Sie den Zugriff auf diese Domains zulassen:

  • accounts.google.com zum Erstellen von OAuth2-Authentifizierungstokens über gsutil config
  • oauth2.googleapis.com für den OAuth2-Token-Austausch
  • *.googleapis.com für Speicheranfragen

Wenn Ihr Proxyserver oder Ihre Sicherheitsrichtlinie weiße Listen nach Domain nicht unterstützt und stattdessen weiße Listen nach IP-Netzwerkblock benötigt, sollten Sie Ihren Proxyserver unbedingt für alle IP-Adressbereiche von Google konfigurieren. Diese Adressbereiche finden Sie durch Abfrage der WHOIS-Daten unter ARIN. Als Best Practice sollten Sie Ihre Proxy-Einstellungen regelmäßig prüfen, um dafür zu sorgen, dass sie mit den IP-Adressen von Google übereinstimmen.

Die Konfiguration von Proxyservern mit einzelnen IP-Adressen, die Sie durch eine einmalige DNS-Abfrage von oauth2.googleapis.comund storage.googleapis.com erhalten haben, wird nicht empfohlen. Google-Dienste werden über DNS-Namen bereitgestellt, denen viele IP-Adressen zugeordnet sind, die sich im Laufe der Zeit ändern können. Daher können bei der Verbindung mit Cloud Storage Fehler auftreten, wenn Sie den Proxy anhand einer einzelnen Abfrage konfigurieren.

Wenn Ihre Anfragen über einen Proxyserver geleitet werden, klären Sie mit Ihrem Netzwerkadministrator, dass der Authorization-Header mit Ihren Anmeldedaten nicht durch den Proxy entfernt werden darf. Ohne den Authorization-Header werden Ihre Anfragen abgelehnt und Sie erhalten den Fehler MissingSecurityHeader.

Nächste Schritte