رسیدگی به خطاهای ذخیره سازی ابری در وب

Sometimes when you're building an app, things don't go as planned and an error occurs!

در صورت شک، مدیریت‌کننده خطا (یا تابع catch() برای Promises) را بررسی کنید و ببینید پیام خطا چه می‌گوید.

اگر پیام خطا را بررسی کرده‌اید و Cloud Storage Security Rules شما اجازه اقدام را می‌دهد، اما هنوز در حل خطا مشکل دارید، از صفحه پشتیبانی ما دیدن کنید و به ما اطلاع دهید که چگونه می‌توانیم کمک کنیم.

مدیریت پیام‌های خطا

دلایل مختلفی برای بروز خطا وجود دارد، از جمله وجود نداشتن فایل، نداشتن مجوز دسترسی کاربر به فایل مورد نظر یا لغو آپلود فایل توسط کاربر.

To properly diagnose the issue and handle the error, here is a full list of all the errors our client will raise, and how they occurred.

کد دلیل
storage/unknown خطای ناشناخته‌ای رخ داده است.
storage/object-not-found هیچ شیء در مرجع مشخص شده وجود ندارد.
storage/bucket-not-found هیچ باکتی برای Cloud Storage پیکربندی نشده است
storage/project-not-found هیچ پروژه‌ای برای Cloud Storage پیکربندی نشده است
storage/quota-exceeded سهمیه‌ی موجود در فضای Cloud Storage شما به پایان رسیده است. اگر از طرح قیمت‌گذاری Spark استفاده می‌کنید، ارتقا به طرح قیمت‌گذاری Pay-as-you-go Blaze را در نظر بگیرید. اگر از قبل از طرح قیمت‌گذاری Blaze استفاده می‌کنید، با پشتیبانی Firebase تماس بگیرید.

مهم : از تاریخ ۳ فوریه ۲۰۲۶ ، طرح قیمت‌گذاری Blaze ملزم به استفاده از Cloud Storage ، حتی باکت‌های پیش‌فرض، خواهد بود .
storage/unauthenticated User is unauthenticated, please authenticate and try again.
storage/unauthorized کاربر مجاز به انجام عمل درخواستی نیست، قوانین امنیتی خود را بررسی کنید تا از صحت آنها اطمینان حاصل کنید.
storage/retry-limit-exceeded حداکثر زمان مجاز برای یک عملیات (آپلود، دانلود، حذف و غیره) به پایان رسیده است. دوباره آپلود کنید.
storage/invalid-checksum File on the client does not match the checksum of the file received by the server. Try uploading again.
storage/canceled کاربر عملیات را لغو کرد.
storage/invalid-event-name نام رویداد نامعتبر است. باید یکی از [ `running` , `progress` , `pause` ] باشد.
storage/invalid-url آدرس اینترنتی نامعتبری به refFromURL() ارائه شده است. باید به شکل زیر باشد: gs://bucket/object یا https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument آرگومان ارسالی به put() باید `File`، `Blob` یا `UInt8` Array` باشد. آرگومان ارسالی به putString() باید یک رشته خام، `Base64` یا `Base64URL` باشد.
storage/no-default-bucket No bucket has been set in your Firebase config's storageBucket property.
storage/cannot-slice-blob معمولاً زمانی رخ می‌دهد که فایل محلی تغییر کرده باشد (حذف شده، دوباره ذخیره شده و غیره). پس از تأیید عدم تغییر فایل، دوباره آپلود را امتحان کنید.
storage/server-file-wrong-size فایل روی کلاینت با اندازه فایل دریافتی توسط سرور مطابقت ندارد. دوباره آپلود کنید.