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

Czasami podczas tworzenia aplikacji coś idzie nie tak 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.

Poniżej znajdziesz pełną listę wszystkich błędów zgłaszanych przez klienta wraz z ich opisem, aby umożliwić prawidłowe zdiagnozowanie i rozwiązanie problemu.

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 Przekroczono limit w zasobniku Cloud Storage. Jeśli korzystasz z abonamentu Spark, rozważ przejście na abonament Blaze z płatnością za korzystanie. Jeśli masz już abonament Blaze, skontaktuj się z zespołem pomocy Firebase.

Ważne: od 1 października 2025 r. abonament Blaze będzie wymagany do używania Cloud Storage, nawet domyślnych zasobników.
storage/unauthenticated Użytkownik nie jest uwierzytelniony. Przeprowadź uwierzytelnianie i spróbuj ponownie.
storage/unauthorized Użytkownik nie ma uprawnień do wykonania żądanego działania. Sprawdź, czy reguły zabezpieczeń są prawidłowe.
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 w kliencie nie jest zgodny z sumą kontrolną pliku odebranego 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 We właściwości storageBucket konfiguracji Firebase nie ustawiono zasobnika.
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 w kliencie nie pasuje do rozmiaru pliku odebranego przez serwer. Spróbuj przesłać jeszcze raz.