Obsługa błędów w Cloud Storage w internecie

Czasami podczas tworzenia aplikacji coś idzie nie tak, jak powinno, i występuje błąd.

W razie wątpliwości sprawdź, co zwraca funkcja obsługi błędów (lub funkcja catch() w przypadku obietnic).

Jeśli po sprawdzeniu komunikatu o błędzie masz Cloud Storage Security Rules, które umożliwiają działanie, ale nadal nie możesz rozwiązać problemu, odwiedź naszą stronę pomocy i poinformuj nas, jak możemy Ci pomóc.

Obsługa komunikatów o błędach

Błędy mogą wystąpić z różnych powodów, m.in. gdy plik nie istnieje, użytkownik nie ma uprawnień do dostępu do wybranego pliku lub użytkownik anulował przesyłanie pliku.

Aby prawidłowo zdiagnozować problem i rozwiązać błąd, przedstawiamy pełną listę wszystkich błędów, które może zgłosić nasz klient, oraz sposobów ich wystąpienia.

Kod Przyczyna
storage/unknown Wystąpił nieznany błąd.
storage/object-not-found W określonym odwołaniu nie ma obiektu.
storage/bucket-not-found Brak zasobnika skonfigurowanego dla Cloud Storage
storage/project-not-found Nie skonfigurowano żadnego projektu dla Cloud Storage
storage/quota-exceeded Limit w przypadku puli Cloud Storage został przekroczony. Jeśli korzystasz z abonamentu Spark, rozważ przejście na abonament Blaze z płatnością za korzystanie. Jeśli korzystasz już z abonamentu Blaze, skontaktuj się z zespołem pomocy Firebase.

Ważne: od 1 października 2025 r. abonament Blaze będzie wymagany do korzystania z Cloud Storage, nawet w przypadku domyślnych zasobników.
storage/unauthenticated Użytkownik nie jest uwierzytelniony. Uwierzytelnij się i spróbuj ponownie.
storage/unauthorized Użytkownik nie ma uprawnień do wykonania żądanej czynności. Sprawdź, czy reguły zabezpieczeń są poprawne.
storage/retry-limit-exceeded Maksymalny limit czasu operacji (przesyłanie, pobieranie, usuwanie itp.) został przekroczony. Spróbuj przesłać jeszcze raz.
storage/invalid-checksum Plik na kliencie nie jest zgodny z sumą kontrolną pliku otrzymanego przez serwer. Spróbuj przesłać jeszcze raz.
storage/canceled Operacja została anulowana przez użytkownika.
storage/invalid-event-name Podano nieprawidłową nazwę zdarzenia. Wymagana jest jedna z tych wartości:`running`, `progress`, `pause`
storage/invalid-url Podany adres URL jest nieprawidłowy.refFromURL() Musi mieć format: gs://bucket/object lub https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
storage/invalid-argument Argument przekazany do funkcji put() musi być typu „File”, „Blob” lub tablica „UInt8”. Argument przekazany do funkcji putString() musi być ciągiem w formacie „raw”, „Base64” lub „Base64URL”.
storage/no-default-bucket W ustawieniu storageBucket w konfiguracji Firebase nie ma żadnego zbiornika.
storage/cannot-slice-blob Zwykle występuje, gdy plik lokalny uległ zmianie (został usunięty, zapisany ponownie itp.). Spróbuj przesłać plik ponownie, gdy upewnisz się, że nie uległ zmianie.
storage/server-file-wrong-size Plik na kliencie nie pasuje do rozmiaru pliku otrzymanego przez serwer. Spróbuj przesłać jeszcze raz.