Flutter पर Cloud Storage के लिए गड़बड़ियां मैनेज करना

कभी-कभी ऐप्लिकेशन बनाते समय, चीज़ें प्लान के मुताबिक नहीं होती हैं और गड़बड़ी हो जाती है!

अगर आपको कोई समस्या आ रही है, तो फ़ंक्शन से मिले अपवाद को देखें और गड़बड़ी के मैसेज को पढ़ें.

final storageRef = FirebaseStorage.instance.ref().child("files/uid");
try {
  final listResult = await storageRef.listAll();
} on FirebaseException catch (e) {
  // Caught an exception from Firebase.
  print("Failed with error '${e.code}': ${e.message}");
}

ध्यान दें: डिफ़ॉल्ट रूप से, Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई भी कार्रवाई करने के लिए, Firebase Authentication की ज़रूरत होती है. Cloud Storage के लिए Firebase Security Rules को बदलकर, कुछ खास स्थितियों में बिना पुष्टि किए ऐक्सेस करने की अनुमति दी जा सकती है. हालांकि, ज़्यादातर मामलों में हमारा सुझाव है कि आप ऐक्सेस को सीमित करें और सुरक्षा से जुड़े सख्त नियम सेट अप करें. खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए. ध्यान दें कि अगर आपने Google App Engine का इस्तेमाल किया है और आपके पास *.appspot.com नाम के फ़ॉर्मैट वाला डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि सुरक्षा के नियमों का App Engine फ़ाइलों के ऐक्सेस पर क्या असर पड़ता है.

गड़बड़ी के मैसेज मैनेज करना

गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना, उपयोगकर्ता के पास फ़ाइल को ऐक्सेस करने की अनुमति न होना या उपयोगकर्ता के फ़ाइल अपलोड करने की प्रोसेस को रद्द करना.

समस्या का पता लगाने और गड़बड़ी को ठीक करने के लिए, यहां उन सभी गड़बड़ियों की पूरी सूची दी गई है जिनके बारे में हमारा क्लाइंट शिकायत करेगा. साथ ही, यह भी बताया गया है कि ये गड़बड़ियां कैसे हुईं.

कोड	ब्यौरा
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 प्लान पर अपग्रेड करें. अगर आपने पहले से ही ब्लेज़ प्लान लिया हुआ है, तो Firebase की सहायता टीम से संपर्क करें. अहम जानकारी: Cloud Storage का इस्तेमाल करने के लिए, 1 अक्टूबर, 2025 से ब्लेज़ प्लान लेना ज़रूरी होगा. भले ही, डिफ़ॉल्ट बकेट का इस्तेमाल किया जा रहा हो.
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=<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	क्लाइंट पर मौजूद फ़ाइल का साइज़, सर्वर को मिली फ़ाइल के साइज़ से मेल नहीं खाता. फिर से अपलोड करके देखें.