Обработка ошибок облачного хранилища на платформах 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 Размер загружаемого файла превышает объём памяти, выделенный для загрузки. Увеличьте лимит памяти и повторите попытку.