Fehler für Cloud Storage im Web behandeln
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Manchmal läuft bei der Entwicklung einer App nicht alles nach Plan und es tritt ein Fehler auf.
Im Zweifelsfall sollten Sie den Fehler-Handler (oder die catch()-Funktion für Promises) prüfen und sich die Fehlermeldung ansehen.
Wenn Sie die Fehlermeldung geprüft haben und Cloud Storage Security Rules haben, die Ihre Aktion ermöglichen, aber immer noch Probleme beim Beheben des Fehlers haben, rufen Sie unsere Supportseite auf und teilen Sie uns mit, wie wir Ihnen helfen können.
Fehlermeldungen behandeln
Es gibt eine Reihe von Gründen, warum Fehler auftreten können, z. B. wenn die Datei nicht vorhanden ist, der Nutzer keine Berechtigung für den Zugriff auf die gewünschte Datei hat oder der Nutzer den Dateiupload abbricht.
Damit Sie das Problem richtig diagnostizieren und den Fehler beheben können, finden Sie hier eine vollständige Liste aller Fehler, die unser Client ausgibt, und wie sie aufgetreten sind.
| Code |
Grund |
storage/unknown |
Ein unbekannter Fehler ist aufgetreten. |
storage/object-not-found |
Unter der angegebenen Referenz ist kein Objekt vorhanden. |
storage/bucket-not-found |
Für Cloud Storage ist kein Bucket konfiguriert. |
storage/project-not-found |
Für Cloud Storage ist kein Projekt konfiguriert |
storage/quota-exceeded |
Das Kontingent für Ihren Cloud Storage-Bucket wurde überschritten. Wenn Sie den Spark-Tarif nutzen, sollten Sie ein Upgrade auf den Blaze-Tarif (Pay as you go) in Betracht ziehen. Wenn Sie bereits den Blaze-Tarif nutzen, wenden Sie sich an den Firebase-Support.
Wichtig: Ab dem 1. Oktober 2025 ist der Blaze-Tarif erforderlich, um Cloud Storage zu verwenden, auch Standard-Buckets. |
storage/unauthenticated |
Der Nutzer ist nicht authentifiziert. Bitte authentifizieren Sie sich und versuchen Sie es noch einmal. |
storage/unauthorized |
Der Nutzer ist nicht autorisiert, die angeforderte Aktion auszuführen. Prüfen Sie Ihre Sicherheitsregeln, um sicherzustellen, dass sie korrekt sind. |
storage/retry-limit-exceeded |
Das maximale Zeitlimit für einen Vorgang (Hochladen, Herunterladen, Löschen usw.)
wurde überschritten. Versuche es noch einmal. |
storage/invalid-checksum |
Die Datei auf dem Client stimmt nicht mit der Prüfsumme der vom Server empfangenen Datei überein. Versuche es noch einmal. |
storage/canceled |
Der Nutzer hat den Vorgang abgebrochen. |
storage/invalid-event-name |
Ungültiger Ereignisname angegeben. Muss einer der folgenden Werte sein: [`running`, `progress`, `pause`] |
storage/invalid-url |
Für refFromURL() wurde eine ungültige URL angegeben. Muss das Format gs://bucket/object oder https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN> haben. |
storage/invalid-argument |
Das an put() übergebene Argument muss ein „File“-, „Blob“- oder „UInt8“-Array sein. Das an putString() übergebene Argument muss ein Roh-, `Base64`- oder `Base64URL`-String sein. |
storage/no-default-bucket |
In der storageBucket-Property Ihrer Firebase-Konfiguration wurde kein Bucket festgelegt. |
storage/cannot-slice-blob |
Tritt häufig auf, wenn sich die lokale Datei geändert hat (gelöscht, noch einmal gespeichert usw.). Versuchen Sie es noch einmal, nachdem Sie überprüft haben, dass sich die Datei nicht geändert hat. |
storage/server-file-wrong-size |
Die Datei auf dem Client stimmt nicht mit der Größe der Datei überein, die vom Server empfangen wurde. Versuche es noch einmal. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-08 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-08 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nSometimes when you're building an app, things don't go as planned and an\nerror occurs!\n\nWhen in doubt, check the error handler (or `catch()` function for Promises),\nand see what the error message has to say.\n| **Note:** By default, a Cloud Storage for Firebase bucket requires Firebase Authentication to perform any action on the bucket's data or files. You can change your Firebase Security Rules for Cloud Storage to [allow unauthenticated access for specific situations](/docs/storage/security/rules-conditions#public). However, for most situations, we strongly recommend [restricting access and setting up robust security rules](/docs/storage/security/get-started) (especially for production apps). Note that if you use Google App Engine and have a default Cloud Storage bucket with a name format of `*.appspot.com`, you may need to consider [how your security rules impact access to App Engine files](/docs/storage/gcp-integration#security-rules-and-app-engine-files).\n\nIf you've checked the error message and have Cloud Storage Security Rules that allow your\naction, but are still struggling to solve the error, visit our\n[Support page](/support) and let us know how we can help.\n\nHandle Error Messages\n\nThere are a number of reasons why errors may occur, including the file\nnot existing, the user not having permission to access the desired file, or the\nuser cancelling the file upload.\n\nTo properly diagnose the issue and handle the error, here is a full list of\nall the errors our client will raise, and how they occurred.\n\n| Code | Reason |\n|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `storage/unknown` | An unknown error occurred. |\n| `storage/object-not-found` | No object exists at the specified reference. |\n| `storage/bucket-not-found` | No bucket is configured for Cloud Storage |\n| `storage/project-not-found` | No project is configured for Cloud Storage |\n| `storage/quota-exceeded` | Quota on your Cloud Storage bucket has been exceeded. If you're on the Spark pricing plan, consider upgrading to the [pay-as-you-go Blaze pricing plan](/pricing). If you're already on the Blaze pricing plan, reach out to Firebase Support. **Important** : Starting October 1, 2025, the [Blaze pricing plan will be *required* to use Cloud Storage](/docs/storage/faqs-storage-changes-announced-sept-2024), even default buckets. |\n| `storage/unauthenticated` | User is unauthenticated, please authenticate and try again. |\n| `storage/unauthorized` | User is not authorized to perform the requested action, check your security rules to ensure they are correct. |\n| `storage/retry-limit-exceeded` | The maximum time limit on an operation (upload, download, delete, etc.) has been exceeded. Try uploading again. |\n| `storage/invalid-checksum` | File on the client does not match the checksum of the file received by the server. Try uploading again. |\n| `storage/canceled` | User canceled the operation. |\n| `storage/invalid-event-name` | Invalid event name provided. Must be one of \\[```running```, ```progress```, ```pause```\\] |\n| `storage/invalid-url` | Invalid URL provided to `refFromURL()`. Must be of the form: gs://bucket/object or https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=\\<TOKEN\\\u003e |\n| `storage/invalid-argument` | The argument passed to `put()` must be \\`File\\`, \\`Blob\\`, or \\`UInt8\\` Array. The argument passed to `putString()` must be a raw, \\`Base64\\`, or \\`Base64URL\\` string. |\n| `storage/no-default-bucket` | No bucket has been set in your Firebase config's `storageBucket` property. |\n| `storage/cannot-slice-blob` | Commonly occurs when the local file has changed (deleted, saved again, etc.). Try uploading again after verifying that the file hasn't changed. |\n| `storage/server-file-wrong-size` | File on the client does not match the size of the file received by the server. Try uploading again. |"]]
