Обработка ошибок Cloud Storage for Unity

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

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

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

Для правильной диагностики проблемы и обработки ошибки ниже приведён полный список всех ошибок Firebase.Storage.StorageException , которые может вызвать наш клиент, и описание возможных причин их возникновения.

Имя	Причина
ErrorUnknown	Произошла неизвестная ошибка.
ErrorObjectNotFound	Объект по указанной ссылке отсутствует.
ErrorBucketNotFound	Для Cloud Storage не настроен ни один сегмент.
ErrorProjectNotFound	Для Cloud Storage не настроен ни один проект.
ErrorQuotaExceeded	Квота в вашем хранилище Cloud Storage превышена. Если вы используете тарифный план Spark, рассмотрите возможность перехода на тарифный план Blaze с оплатой по мере использования . Если вы уже используете тарифный план Blaze, обратитесь в службу поддержки Firebase. Важно : начиная со 2 февраля 2026 года , для использования тарифного плана Blaze потребуется Cloud Storage , даже для стандартных сегментов.
ErrorNotAuthenticated	Пользователь не авторизован. Пройдите авторизацию и попробуйте снова.
ErrorNotAuthorized	Пользователь не авторизован для выполнения запрошенного действия. Проверьте свои правила, чтобы убедиться в их правильности.
ErrorRetryLimitExceeded	Превышен максимальный лимит времени для выполнения операции (загрузка, скачивание, удаление и т. д.). Попробуйте загрузить файл еще раз.
ErrorInvalidChecksum	Контрольная сумма файла на стороне клиента не совпадает с контрольной суммой файла, полученного сервером. Попробуйте загрузить файл еще раз.
ErrorCanceled	Пользователь отменил операцию.