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ź moduł obsługi błędów (lub funkcję catch() w przypadku obietnic) i zobacz, co mówi komunikat o błędzie.

Jeśli po sprawdzeniu komunikatu o błędzie masz Cloud Storage Security Rules, które umożliwiają wykonanie działania, 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, np. z powodu braku pliku, braku uprawnień użytkownika do dostępu do wybranego pliku lub anulowania przez użytkownika przesyłania pliku.

Aby prawidłowo zdiagnozować problem i obsłużyć błąd, zapoznaj się z pełną listą wszystkich błędów, które może zgłosić nasz klient, oraz z informacjami o tym, jak one powstają.

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 Nie skonfigurowano zasobnika dla: Cloud Storage
storage/project-not-found Nie skonfigurowano projektu dla Cloud Storage
storage/quota-exceeded Przekroczono limit w przypadku zasobnika Cloud Storage. Jeśli korzystasz z abonamentu Spark, rozważ przejście na abonament Blaze z płatnością za wykorzystanie. Jeśli korzystasz już z abonamentu Blaze, skontaktuj się z zespołem pomocy Firebase.

Ważne: od 1 października 2025 r. korzystanie z Cloud Storage, nawet z domyślnych zasobników, będzie wymagać abonamentu Blaze.
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ź reguły zabezpieczeń, aby upewnić się, że są prawidłowe.
storage/retry-limit-exceeded Maksymalny limit czasu operacji (przesyłania, pobierania, usuwania itp.) został przekroczony. Spróbuj przesłać jeszcze raz.
storage/invalid-checksum Plik na komputerze klienta nie jest zgodny z sumą kontrolną pliku otrzymanego przez serwer. Spróbuj przesłać jeszcze raz.
storage/canceled Operacja anulowana przez użytkownika.
storage/invalid-event-name Podano nieprawidłową nazwę zdarzenia. Musi być jedną z tych wartości: [`running`, `progress`, `pause`]
storage/invalid-url Nieprawidłowy adres URL przekazany do refFromURL(). Musi mieć format: gs://bucket/object lub https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
storage/invalid-argument Argument przekazywany do funkcji put() musi być tablicą `File`, `Blob` lub `UInt8`. Argument przekazywany do funkcji putString() musi być ciągiem znaków w formacie surowym, `Base64` lub `Base64URL`.
storage/no-default-bucket W konfiguracji Firebase nie ustawiono żadnego zasobnika w właściwości storageBucket.
storage/cannot-slice-blob Zwykle występuje, gdy lokalny plik został zmieniony (usunięty, ponownie zapisany itp.). Spróbuj przesłać plik ponownie po sprawdzeniu, czy nie uległ zmianie.
storage/server-file-wrong-size Plik na urządzeniu klienta nie jest zgodny z rozmiarem pliku otrzymanego przez serwer. Spróbuj przesłać jeszcze raz.