مدیریت خطاها برای Cloud Storage در وب

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

اگر شک دارید، کنترل‌کننده خطا (یا تابع 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 for Firebase به طرح قیمت‌گذاری Blaze پرداخت به اندازه استفاده نیاز دارد. اگر این خطا را در پروژه طرح قیمت‌گذاری Spark دریافت می‌کنید، برای دسترسی مجدد باید به طرح قیمت‌گذاری Blaze ارتقا دهید. برای جزئیات، پرسشگان ما را ببینید.
storage/unauthenticated کاربر اصالت‌سنجی نشده است، لطفاً اصالت‌سنجی کنید و دوباره امتحان کنید.
storage/unauthorized کاربر برای انجام کنش درخواستی مجاز نیست، قوانین امنیتی‌تان را بررسی کنید تا مطمئن شوید درست باشند.
storage/retry-limit-exceeded حداکثر محدودیت زمانی برای یک عملیات (بارگذاری، بارگیری، حذف، و غیره) فراتر رفته است. دوباره بارگذاری کنید.
storage/invalid-checksum فایل موجود در کارخواه با جمع‌آزمای فایل دریافتی توسط سرور مطابقت ندارد. دوباره بارگذاری کنید.
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=&ltTOKEN>
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 اندازه فایل در کارخواه با اندازه فایل دریافتی توسط سرور مطابقت ندارد. دوباره بارگذاری کنید.