معالجة الأخطاء في Cloud Storage على أنظمة Apple الأساسية

في بعض الأحيان، عند إنشاء تطبيق، لا تسير الأمور كما هو مخطّط لها ويحدث خطأ.

عند الشك، تحقَّق من الخطأ الذي تم إرجاعه واطّلِع على ما تقوله رسالة الخطأ.

ملاحظة: يتطلّب Cloud Storage for Firebase تلقائيًا Firebase Authentication لتنفيذ أي إجراء على بيانات الحزمة أو ملفاتها. يمكنك تغيير Firebase Security Rules Cloud Storage إلى السماح بالوصول بدون مصادقة في حالات معيّنة. ومع ذلك، ننصحك بشدة في معظم الحالات بتقييد الوصول وإعداد قواعد أمان قوية (خاصةً للتطبيقات المتاحة للجميع). يُرجى العِلم أنّه في حال استخدام Google App Engine وكان لديك حزمة Cloud Storage تلقائية بتنسيق اسم *.appspot.com، قد تحتاج إلى التفكير في كيفية تأثير قواعد الأمان في الوصول إلى ملفات App Engine.

إذا راجعت رسالة الخطأ وتأكّدت من توفّر Cloud Storage Security Rules التي تسمح لك بتنفيذ الإجراء، ولكنك لا تزال تواجه صعوبة في حلّ الخطأ، يُرجى الانتقال إلى صفحة الدعم وإعلامنا بكيفية مساعدتك.

التعامل مع رسائل الخطأ

هناك عدة أسباب قد تؤدي إلى حدوث أخطاء، بما في ذلك عدم توفّر الملف أو عدم توفّر إذن للمستخدم بالوصول إلى الملف المطلوب أو إلغاء المستخدم لعملية تحميل الملف.

لتشخيص المشكلة ومعالجة الخطأ بشكل صحيح، إليك قائمة كاملة بجميع الأخطاء التي سيبلغ عنها برنامجنا وكيفية حدوثها.

الاسم	السبب
FIRStorageErrorCodeUnknown	حدث خطأ غير معروف.
FIRStorageErrorCodeObjectNotFound	لا يتوفّر أي عنصر في المرجع المحدّد.
FIRStorageErrorCodeBucketNotFound	لم يتم إعداد أي حزمة لـ Cloud Storage.
FIRStorageErrorCodeProjectNotFound	لم يتم ضبط أي مشروع للغة Cloud Storage.
FIRStorageErrorCodeQuotaExceeded	تم تجاوز الحصة المخصّصة لحزمة Cloud Storage. إذا كنت تستخدم خطة أسعار Spark، ننصحك بالترقية إلى خطة أسعار Blaze بنظام الدفع حسب الاستخدام. إذا كنت مشتركًا في خطة أسعار Blaze، يُرجى التواصل مع فريق دعم Firebase. ملاحظة مهمة: اعتبارًا من 1 أكتوبر 2025، يجب الاشتراك في خطة أسعار Blaze لاستخدام Cloud Storage، حتى الحِزم التلقائية.
FIRStorageErrorCodeUnauthenticated	لم يتم إثبات هوية المستخدم. يُرجى إكمال عملية المصادقة والمحاولة مجددًا.
FIRStorageErrorCodeUnauthorized	لا يُسمح للمستخدم بتنفيذ الإجراء المطلوب. تحقَّق من قواعدك للتأكّد من صحتها.
FIRStorageErrorCodeRetryLimitExceeded	تم تجاوز الحدّ الأقصى للوقت المسموح به لإجراء عملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة التحميل مرة أخرى.
FIRStorageErrorCodeNonMatchingChecksum	لا يتطابق الملف على الجهاز مع المجموع الاختباري للملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى.
FIRStorageErrorCodeCanceled	ألغى المستخدِم العملية.
FIRStorageErrorCodeDownloadSizeExceeded	يتجاوز حجم الملف الذي تم تنزيله مقدار الذاكرة المخصّصة للتنزيل. زيادة الحد الأقصى للذاكرة ومحاولة التنزيل مرة أخرى