Obsługa błędów Cloud Storage na platformach Apple

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

W razie wątpliwości sprawdź zwrócony błąd i sprawdź, jaki jest komunikat o błędzie.

Uwaga: domyślnie zasobnik Cloud Storage for Firebase wymaga uprawnień Firebase Authenticationdo wykonywania jakichkolwiek działań na danych lub plikach zasobnika. Możesz zmienić ustawienie Firebase Security Rules na Cloud Storage, aby zezwolić na nieautoryzowany dostęp w określonych sytuacjach. W większości przypadków zdecydowanie zalecamy ograniczenie dostępu i skonfigurowanie solidnych zasad bezpieczeństwa (szczególnie w przypadku aplikacji produkcyjnych). Jeśli używasz Google App Engine i masz domyślny zasobnik Cloud Storage o nazwie *.appspot.com, musisz sprawdzić, jak Twoje reguły zabezpieczeń wpływają na dostęp do plików App Engine.

Jeśli po sprawdzeniu komunikatu o błędzie masz Cloud Storage Security Rules, które umożliwiają działanie, ale nadal nie możesz naprawić błędu, 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, między innymi z tego, że 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, zapoznaj się z pełną listą wszystkich błędów, które może zgłosić nasz klient, oraz sposobami ich wystąpienia.

Nazwa	Przyczyna
FIRStorageErrorCodeUnknown	Wystąpił nieznany błąd.
FIRStorageErrorCodeObjectNotFound	W określonym odwołaniu nie ma obiektu.
FIRStorageErrorCodeBucketNotFound	Dla Cloud Storage nie skonfigurowano zasobnika.
FIRStorageErrorCodeProjectNotFound	W przypadku Cloud Storage nie ma skonfigurowanego żadnego projektu.
FIRStorageErrorCodeQuotaExceeded	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.
FIRStorageErrorCodeUnauthenticated	Użytkownik nie jest uwierzytelniony. Zaloguj się i spróbuj ponownie.
FIRStorageErrorCodeUnauthorized	Użytkownik nie ma uprawnień do wykonania żądanej czynności. Sprawdź reguły, aby się upewnić, że są prawidłowe.
FIRStorageErrorCodeRetryLimitExceeded	przekroczono maksymalny limit czasu operacji (przesyłanie, pobieranie, usuwanie itp.); Spróbuj przesłać jeszcze raz.
FIRStorageErrorCodeNonMatchingChecksum	Plik na kliencie nie jest zgodny z sumą kontrolną pliku otrzymanego przez serwer. Spróbuj przesłać jeszcze raz.
FIRStorageErrorCodeCanceled	Operacja została anulowana przez użytkownika.
FIRStorageErrorCodeDownloadSizeExceeded	Rozmiar pobieranego pliku przekracza ilość pamięci przydzielonej do pobrania. Zwiększ limit pamięci i spróbuj pobrać plik ponownie.