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

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

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

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