Обработка ошибок облачного хранилища на платформах Apple

Иногда при разработке приложения что-то идёт не по плану, и возникает ошибка.

В случае сомнений проверьте полученное сообщение об ошибке и посмотрите, что в нём говорится.

Если вы проверили сообщение об ошибке и у вас есть Cloud Storage Security Rules , разрешающие ваши действия, но вы все еще не можете исправить ошибку, посетите нашу страницу поддержки и сообщите нам, чем мы можем вам помочь.

Обработка сообщений об ошибках

Ошибки могут возникать по ряду причин, включая отсутствие файла, отсутствие у пользователя прав доступа к нужному файлу или отмену пользователем загрузки файла.

Для правильной диагностики проблемы и устранения ошибки, ниже приведён полный список всех ошибок, которые может выдать наш клиент, и описание того, как они могут возникать.

Имя Причина
FIRStorageErrorCodeUnknown Произошла неизвестная ошибка.
FIRStorageErrorCodeObjectNotFound Объект по указанной ссылке отсутствует.
FIRStorageErrorCodeBucketNotFound Для Cloud Storage не настроен ни один сегмент.
FIRStorageErrorCodeProjectNotFound Для Cloud Storage не настроен ни один проект.
FIRStorageErrorCodeQuotaExceeded Квота в вашем хранилище Cloud Storage превышена. Если вы используете тарифный план Spark, рассмотрите возможность перехода на тарифный план Blaze с оплатой по мере использования . Если вы уже используете тарифный план Blaze, обратитесь в службу поддержки Firebase.

Важно : начиная со 2 февраля 2026 года , для использования тарифного плана Blaze потребуется Cloud Storage , даже для стандартных сегментов.
FIRStorageErrorCodeUnauthenticated Пользователь не авторизован. Пройдите авторизацию и попробуйте снова.
FIRStorageErrorCodeUnauthorized Пользователь не авторизован для выполнения запрошенного действия. Проверьте свои правила, чтобы убедиться в их правильности.
FIRStorageErrorCodeRetryLimitExceeded Превышен максимальный лимит времени для выполнения операции (загрузка, скачивание, удаление и т. д.). Попробуйте загрузить файл еще раз.
FIRStorageErrorCodeNonMatchingChecksum Контрольная сумма файла на стороне клиента не совпадает с контрольной суммой файла, полученного сервером. Попробуйте загрузить файл еще раз.
FIRStorageErrorCodeCanceled Пользователь отменил операцию.
FIRStorageErrorCodeDownloadSizeExceeded Размер загруженного файла превышает объем памяти, выделенный для загрузки. Увеличьте лимит памяти и попробуйте загрузить файл снова.