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

گاهی اوقات وقتی در حال ساخت اپلیکیشن هستید، همه چیز طبق برنامه پیش نمی رود و خطایی رخ می دهد!

در صورت شک، کنترل کننده خطا (یا تابع 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 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 فایل روی کلاینت با اندازه فایل دریافت شده توسط سرور مطابقت ندارد. دوباره آپلود کنید.