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

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

Если у вас возникли сомнения, проверьте возвращаемую ошибку и посмотрите, что говорится в сообщении об ошибке.

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

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

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

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

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

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