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

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

หากมีข้อสงสัย ให้ตรวจสอบตัวแฮนเดิลข้อผิดพลาด (หรือฟังก์ชัน catch() สำหรับ Promise) และดูว่าข้อความแสดงข้อผิดพลาดบอกอะไร

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

หากคุณตรวจสอบข้อความแสดงข้อผิดพลาดแล้วและมี 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 ของคุณแล้ว หากคุณใช้แพ็กเกจราคา 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=&ltTOKEN>
storage/invalid-argument	อาร์กิวเมนต์ที่ส่งไปยัง put() ต้องเป็นอาร์เรย์ `File`, `Blob` หรือ `UInt8` อาร์กิวเมนต์ที่ส่งไปยัง putString() ต้องเป็นสตริงแบบดิบ, `Base64` หรือ `Base64URL`
storage/no-default-bucket	ไม่มีการกําหนดที่เก็บข้อมูลในพร็อพเพอร์ตี้ storageBucket ของการกำหนดค่า Firebase
storage/cannot-slice-blob	มักเกิดขึ้นเมื่อไฟล์ในเครื่องมีการเปลี่ยนแปลง (ลบ บันทึกอีกครั้ง ฯลฯ) โปรดลองอัปโหลดอีกครั้งหลังจากยืนยันว่าไฟล์ไม่มีการเปลี่ยนแปลง
storage/server-file-wrong-size	ไฟล์ในไคลเอ็นต์ไม่ตรงกับขนาดของไฟล์ที่เซิร์ฟเวอร์ได้รับ โปรดลองอัปโหลดอีกครั้ง