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

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

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

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