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

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

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