לפעמים כשיוצרים אפליקציה, הדברים לא הולכים לפי התכנון אירעה שגיאה.
אם אתם לא בטוחים, כדאי לבדוק את בורר השגיאות (או את הפונקציה 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 שלך. אם יש לכם מינוי ללא עלות, עליכם לשדרג למינוי בתשלום. אם יש לכם מינוי בתשלום, תוכלו לפנות לתמיכה של Firebase. |
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. |
storage/cannot-slice-blob |
לרוב זה קורה כשהקובץ המקומי משתנה (נמחק, נשמר שוב, וכו'). כדאי לנסות להעלות שוב אחרי שמוודאים שהקובץ לא השתנה. |
storage/server-file-wrong-size |
הקובץ בלקוח אינו תואם לגודל הקובץ שהתקבל על ידי השרת. כדאי לנסות להעלות שוב. |