Gérer les erreurs de Cloud Storage sur le Web

Cloud Storage for Firebase nécessite que les projets soient associés au forfait Blaze avec paiement à l'usage. Cette exigence s'applique également à l'accès au bucket par défaut de votre projet. En savoir plus

Parfois, lorsque vous créez une application, les choses ne se passent pas comme prévu et une erreur se produit.

En cas de doute, vérifiez le gestionnaire d'erreurs (ou la fonction catch() pour les promesses) et lisez le message d'erreur.

Remarque : Par défaut, un bucket Cloud Storage for Firebase nécessite Firebase Authentication pour effectuer une action sur les données ou les fichiers du bucket. Vous pouvez modifier votre Firebase Security Rules pour Cloud Storage afin d'autoriser l'accès non authentifié dans des situations spécifiques. Toutefois, dans la plupart des cas, nous vous recommandons vivement de restreindre l'accès et de configurer des règles de sécurité robustes (en particulier pour les applications de production). Notez que si vous utilisez Google App Engine et que vous disposez d'un bucket Cloud Storage par défaut au format de nom *.appspot.com, vous devrez peut-être prendre en compte l'impact de vos règles de sécurité sur l'accès aux fichiers App Engine.

Si vous avez vérifié le message d'erreur et que vous disposez des Cloud Storage Security Rules qui autorisent votre action, mais que vous ne parvenez toujours pas à résoudre l'erreur, consultez notre page d'assistance et indiquez-nous comment nous pouvons vous aider.

Gérer les messages d'erreur

Des erreurs peuvent se produire pour plusieurs raisons, par exemple si le fichier n'existe pas, si l'utilisateur n'est pas autorisé à accéder au fichier souhaité ou si l'utilisateur annule l'importation du fichier.

Pour diagnostiquer correctement le problème et gérer l'erreur, voici la liste complète de toutes les erreurs que notre client peut générer et de la manière dont elles se sont produites.

Code	Motif
storage/unknown	Une erreur inconnue s'est produite.
storage/object-not-found	Aucun objet n'existe à la référence spécifiée.
storage/bucket-not-found	Aucun bucket n'est configuré pour Cloud Storage
storage/project-not-found	Aucun projet n'est configuré pour Cloud Storage
storage/quota-exceeded	Le quota de votre bucket a été dépassé. Cloud Storage for Firebase nécessite le forfait Blaze avec paiement à l'usage. Si vous recevez cette erreur sur un projet avec le forfait Spark, vous devez passer au forfait Blaze pour récupérer l'accès. Pour en savoir plus, consultez nos questions fréquentes.
storage/unauthenticated	L'utilisateur n'est pas authentifié. Veuillez vous authentifier et réessayer.
storage/unauthorized	L'utilisateur n'est pas autorisé à effectuer l'action demandée. Vérifiez que vos règles de sécurité sont correctes.
storage/retry-limit-exceeded	La durée maximale d'une opération (importation, téléchargement, suppression, etc.) a été dépassé. Réessayez d'importer une vidéo.
storage/invalid-checksum	Le fichier sur le client ne correspond pas à la somme de contrôle du fichier reçu par le serveur. Réessayez d'importer une vidéo.
storage/canceled	L'utilisateur a annulé l'opération.
storage/invalid-event-name	Le nom d'événement fourni n'est pas valide. Doit être l'un des suivants : [`running`, `progress`, `pause`]
storage/invalid-url	L'URL fournie à refFromURL() n'est pas valide. Doit être au format gs://bucket/object ou https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>.
storage/invalid-argument	L'argument transmis à put() doit être un tableau "File", "Blob" ou "UInt8". L'argument transmis à putString() doit être une chaîne brute, "Base64" ou "Base64URL".
storage/no-default-bucket	Aucun bucket n'a été défini dans la propriété storageBucket de votre configuration Firebase.
storage/cannot-slice-blob	Se produit généralement lorsque le fichier local a été modifié (supprimé, enregistré à nouveau, etc.). Réessayez d'importer le fichier après avoir vérifié qu'il n'a pas été modifié.
storage/server-file-wrong-size	La taille du fichier sur le client ne correspond pas à celle du fichier reçu par le serveur. Réessayez d'importer une vidéo.