Обработка ошибок облачного хранилища в Интернете

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

Если у вас есть сомнения, проверьте обработчик ошибок (или функцию catch() для Promises) и посмотрите, что говорит сообщение об ошибке.

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

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

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

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

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

Код	Причина
storage/unknown	Произошла неизвестная ошибка.
storage/object-not-found	По указанной ссылке не существует объекта.
storage/bucket-not-found	Для Cloud Storage не настроен ни один сегмент.
storage/project-not-found	Ни один проект не настроен для Cloud Storage
storage/quota-exceeded	Квота в вашем сегменте Cloud Storage превышена. Если вы используете тарифный план Spark, рассмотрите возможность перехода на тарифный план Blaze с оплатой по мере использования . Если вы уже используете тарифный план Blaze, обратитесь в службу поддержки Firebase. Важно ! С 1 октября 2025 г. в рамках тарифного плана Blaze необходимо будет использовать Cloud Storage , даже сегменты по умолчанию.
storage/unauthenticated	Пользователь не авторизован, пожалуйста, авторизуйтесь и повторите попытку.
storage/unauthorized	Пользователь не авторизован для выполнения запрошенного действия. Проверьте правила безопасности, чтобы убедиться в их правильности.
storage/retry-limit-exceeded	Превышено максимальное время выполнения операции (загрузка, скачивание, удаление и т. д.). Попробуйте загрузить еще раз.
storage/invalid-checksum	Файл на клиенте не соответствует контрольной сумме файла, полученного сервером. Попробуйте загрузить еще раз.
storage/canceled	Пользователь отменил операцию.
storage/invalid-event-name	Указано неверное название события. Должно быть одно из [ `running` , `progress` , `pause` ]
storage/invalid-url	Для refFromURL() указан неверный URL-адрес. Должен иметь вид: gs://bucket/object или https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>.
storage/invalid-argument	Аргумент, передаваемый в put() должен быть File, Blob или Array UInt8. Аргумент, передаваемый в putString() должен быть необработанной строкой Base64 или Base64URL.
storage/no-default-bucket	В свойстве storageBucket вашей конфигурации Firebase не установлено ни одного сегмента.
storage/cannot-slice-blob	Обычно происходит, когда локальный файл был изменен (удален, сохранен снова и т. д.). Попробуйте загрузить еще раз, убедившись, что файл не изменился.
storage/server-file-wrong-size	Размер файла на клиенте не соответствует размеру файла, полученного сервером. Попробуйте загрузить еще раз.