จัดการข้อผิดพลาดสำหรับ Cloud Storage ใน Flutter

บางครั้งเมื่อคุณสร้างแอป ทุกอย่างอาจไม่เป็นไปตามแผนที่วางไว้และเกิดข้อผิดพลาดขึ้น

หากไม่แน่ใจ ให้ตรวจหาข้อยกเว้นที่ใส่โดยฟังก์ชัน และดูว่าข้อความแสดงข้อผิดพลาดนั้นบอกอะไร

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 ต้องดำเนินการใดๆ กับข้อมูลหรือไฟล์ของถัง คุณสามารถเปลี่ยน Firebase Security Rules สำหรับ Cloud Storage เพื่ออนุญาตการเข้าถึงที่ไม่ผ่านการตรวจสอบสิทธิ์ในบางสถานการณ์ อย่างไรก็ตาม ในสถานการณ์ส่วนใหญ่ เราขอแนะนําอย่างยิ่งให้จํากัดการเข้าถึงและตั้งค่ากฎการรักษาความปลอดภัยที่มีประสิทธิภาพ (โดยเฉพาะสําหรับแอปเวอร์ชันที่ใช้งานจริง) โปรดทราบว่าหากคุณใช้ Google App Engine และมีที่เก็บข้อมูล Cloud Storage เริ่มต้นที่มีรูปแบบชื่อเป็น *.appspot.com คุณอาจต้องพิจารณาผลกระทบที่กฎความปลอดภัยมีต่อการเข้าถึงไฟล์ 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 แบบจ่ายตามการใช้งาน หากคุณใช้แพ็กเกจราคา Blaze อยู่แล้ว โปรดติดต่อทีมสนับสนุนของ Firebase สำคัญ: ตั้งแต่วันที่ 1 ตุลาคม 2025 เป็นต้นไป คุณจะต้องต้องใช้แพ็กเกจราคา Blaze เพื่อใช้ Cloud Storage รวมถึงที่เก็บข้อมูลเริ่มต้นด้วย
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	ไฟล์ในไคลเอ็นต์ไม่ตรงกับขนาดของไฟล์ที่เซิร์ฟเวอร์ได้รับ โปรดลองอัปโหลดอีกครั้ง