معالجة الأخطاء في Cloud Storage لـ C++

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

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

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

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

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

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

الاسم السبب
kErrorNone لم يحدث أي خطأ.
kErrorUnknown حدث خطأ غير معروف.
kErrorObjectNotFound لا يتوفّر أي عنصر في المرجع المحدّد.
kErrorBucketNotFound لم يتم إعداد أي حزمة لـ Cloud Storage.
kErrorProjectNotFound لم يتم ضبط أي مشروع للغة Cloud Storage.
kErrorQuotaExceeded تم تجاوز الحصة المخصّصة لحزمة Cloud Storage. إذا كنت تستخدم خطة أسعار Spark، ننصحك بالترقية إلى خطة أسعار Blaze بنظام الدفع حسب الاستخدام. إذا كنت مشتركًا في خطة أسعار Blaze، يُرجى التواصل مع فريق دعم Firebase.

ملاحظة مهمة: اعتبارًا من 1 أكتوبر 2025، يجب الاشتراك في خطة أسعار Blaze لاستخدام Cloud Storage، حتى الحِزم التلقائية.
kErrorUnauthenticated لم يتم إثبات هوية المستخدم. يُرجى إكمال عملية المصادقة والمحاولة مجددًا.
kErrorUnauthorized لا يُسمح للمستخدم بتنفيذ الإجراء المطلوب. تحقَّق من قواعدك للتأكّد من صحتها.
kErrorRetryLimitExceeded تم تجاوز الحدّ الأقصى للوقت المسموح به لإجراء عملية (تحميل أو تنزيل أو حذف أو غير ذلك). يُرجى محاولة التحميل مرة أخرى.
kErrorNonMatchingChecksum لا يتطابق الملف على الجهاز مع المجموع الاختباري للملف الذي تلقّاه الخادم. يُرجى محاولة التحميل مرة أخرى.
kErrorCanceled ألغى المستخدِم العملية.
kErrorDownloadSizeExceeded يتجاوز حجم الملف الذي تم تنزيله مقدار الذاكرة المخصّصة للتنزيل. زيادة الحد الأقصى للذاكرة ومحاولة التنزيل مرة أخرى