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

Если у вас по умолчанию используется хранилище *.appspot.com , ваш проект Firebase необходимо обновить до тарифного плана Blaze с оплатой по мере использования не позднее 2 февраля 2026 года, чтобы сохранить доступ к вашему хранилищу по умолчанию. Подробнее.

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

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

Примечание: По умолчанию для выполнения любых действий с данными или файлами в хранилище Cloud Storage for Firebase требуется Firebase Authentication . Вы можете изменить Firebase Security Rules для Cloud Storage , чтобы разрешить неаутентифицированный доступ в определенных ситуациях . Однако в большинстве случаев мы настоятельно рекомендуем ограничить доступ и настроить надежные правила безопасности (особенно для приложений, используемых в производственной среде). Обратите внимание, что если вы используете Google App Engine и у вас есть хранилище Cloud Storage по умолчанию с именем в формате [укажите формат имени], это может быть связано с использованием [укажите формат имени]. *.appspot.com вам, возможно, потребуется учесть, как ваши правила безопасности влияют на доступ к файлам App Engine .

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