การแก้ปัญหา & คำถามที่พบบ่อยสำหรับ Android และ Firebase

หน้านี้มีเคล็ดลับและการแก้ปัญหาสำหรับปัญหาที่เฉพาะเจาะจงของ Android ที่คุณอาจพบเมื่อใช้ Firebase

หากพบความท้าทายอื่นๆ หรือไม่เห็นปัญหาของคุณที่ระบุไว้ด้านล่าง อย่าลืมดูคำถามที่พบบ่อยหลักของ Firebase เพื่อดูคำถามที่พบบ่อยเพิ่มเติมเกี่ยวกับ Firebase หรือผลิตภัณฑ์โดยเฉพาะ

นอกจากนี้ คุณยังดูรายการปัญหาที่รายงานและการแก้ปัญหาล่าสุดได้ใน ที่เก็บ GitHub ของ Firebase Android SDK เราขอแนะนำให้คุณ รายงานปัญหาที่เกี่ยวข้องกับ Firebase Android SDK ของคุณที่นั่นด้วย

ฉันได้รับข้อผิดพลาดว่าktxไลบรารีแก้ไขไม่สำเร็จหรือ ไม่พบ

ข้อผิดพลาดนี้อาจเกิดขึ้นเนื่องจากคุณใช้ Firebase BoM และ ระบุโมดูล KTX เป็นการอ้างอิงไลบรารีผลิตภัณฑ์

ในเดือนกรกฎาคม 2025 เราได้หยุดเผยแพร่โมดูล KTX เวอร์ชันใหม่ และนำไลบรารี KTX ออกจาก Firebase Android BoM (v34.0.0)

หากคุณใช้ KTX API จากโมดูล KTX ที่เผยแพร่ก่อนหน้านี้ เราขอแนะนำให้ย้ายข้อมูลแอปเพื่อใช้ KTX API จากโมดูลหลักแทน ดูรายละเอียดได้ที่ คำถามที่พบบ่อยเกี่ยวกับโครงการนี้

ฉันต้องระบุ SHA-1 เมื่อเพิ่มแอป Android ลงในโปรเจ็กต์ Firebase ไหม

ข้อมูล SHA-1 จำเป็นสำหรับ Firebase Authentication (เมื่อใช้ Google Sign-In หรือ การลงชื่อเข้าใช้ด้วยหมายเลขโทรศัพท์) และ Firebase Dynamic Links หากไม่ได้ใช้ฟีเจอร์เหล่านี้ คุณก็ไม่ต้องระบุ SHA-1

ฉันจะแก้ไขข้อผิดพลาด "มีไคลเอ็นต์ OAuth2 สำหรับ ชื่อแพ็กเกจนี้อยู่แล้ว และมี SHA-1 อยู่ในโปรเจ็กต์อื่น" ได้อย่างไร

ข้อผิดพลาดนี้จะเกิดขึ้นหากเราตรวจพบว่าโปรเจ็กต์ Firebase หรือ Google Cloud อื่นมีรหัสไคลเอ็นต์ OAuth 2.0 ที่มีชื่อแพ็กเกจ และ SHA-1 ที่คุณระบุ ดูวิธี แก้ไขข้อผิดพลาดนี้

เมื่อเพิ่ม Firebase ลงในโปรเจ็กต์ Android ฉันได้รับข้อผิดพลาด "ไม่พบ"

ข้อผิดพลาดนี้มักจะหมายความว่าแอปของคุณไม่มีการอ้างอิงอย่างน้อย 1 รายการ ไปยังที่เก็บ Maven ของ Google ตรวจสอบว่าได้รวมที่เก็บ Maven ของ Google (google()) ไว้ในไฟล์การกำหนดค่า Gradle

• หากโปรเจ็กต์ใช้ไวยากรณ์ plugins ให้ใส่ไวยากรณ์นั้น ในส่วน plugins ในไฟล์ settings.gradle.kts หรือ settings.gradle
• หากโปรเจ็กต์ใช้ไวยากรณ์ buildscript ให้ใส่ไวยากรณ์ดังกล่าว ทั้งในส่วน buildscript และ allprojects ในไฟล์ build.gradle.kts หรือ build.gradle ระดับโปรเจ็กต์

เมื่อเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Android ฉันได้รับข้อผิดพลาดเกี่ยวกับ การรองรับ invoke-custom และการเปิดใช้ desugaring

ในเดือนพฤษภาคม 2021 (Firebase BoM v28.0.0) Firebase ได้ปิดใช้การแปลงโค้ดสำหรับ ไลบรารี Android ทั้งหมด (ดูหมายเหตุประจำรุ่น)

การเปลี่ยนแปลงนี้หมายความว่าบิลด์ Gradle ที่ใช้ปลั๊กอิน Android Gradle (AGP) เวอร์ชัน 4.2 หรือก่อนหน้าจะต้องเปิดใช้การรองรับ Java 8 ไม่เช่นนั้น เมื่อเพิ่ม Firebase SDK โปรเจ็กต์ Android เหล่านี้จะสร้างไม่สําเร็จด้วยข้อความต่อไปนี้

D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.

หากต้องการแก้ไขการสร้างที่ไม่สำเร็จนี้ คุณสามารถทำตามตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

• เพิ่ม compileOptions ที่ระบุจากข้อความแสดงข้อผิดพลาดลงในไฟล์ ระดับแอป build.gradle.kts หรือ build.gradle
• เพิ่ม minSdkVersion สำหรับโปรเจ็กต์ Android เป็น 26 ขึ้นไป

การลงชื่อเข้าใช้ด้วย Google แสดงข้อผิดพลาด "12500:" หลังจากที่ฉันเผยแพร่แอปแล้ว ฉันจะแก้ไขได้อย่างไร

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

• คุณได้เพิ่มอีเมลสนับสนุนไปยัง การตั้งค่าทั่วไปของโปรเจ็กต์ ในคอนโซล Firebase
• คุณได้เพิ่ม ลายนิ้วมือของใบรับรอง SHA-1 จากคีย์สโตร์รุ่นที่เผยแพร่/เวอร์ชันที่ใช้งานจริง ลงในแอป Android ของ Firebase ในคอนโซล Firebase (ไปที่ การตั้งค่าโปรเจ็กต์ เลื่อนลงไปที่ แอปของคุณ แล้วเลือกแอป Android)
• คุณได้เพิ่ม ลายนิ้วมือของใบรับรอง SHA-1 จากGoogle Playคอนโซล ไปยังแอป Firebase Android ในคอนโซล Firebase (ไปที่ การตั้งค่าโปรเจ็กต์ เลื่อนลงไปที่ แอปของคุณ แล้วเลือกแอป Android)

วิธีเพิ่มปลั๊กอิน Firebase ลงในโปรเจ็กต์ Android โดยใช้ไวยากรณ์ buildscript

เคล็ดลับ: ลองย้ายข้อมูลจากไวยากรณ์ buildscript ไปเป็น plugin เนื่องจากจะช่วยให้ Android Studio เติมโค้ดอัตโนมัติและให้คำแนะนำอื่นๆ ที่เป็นประโยชน์ได้

Firebase มีปลั๊กอิน Gradle ต่อไปนี้

ชื่อปลั๊กอิน	พิกัด Maven	เวอร์ชันล่าสุด	รหัสปลั๊กอิน
ปลั๊กอินบริการ Google Play	com.google.gms:google-services	4.4.4	com.google.gms.google-services
ปลั๊กอิน App Distribution	com.google.firebase:firebase-appdistribution-gradle	5.2.0	com.google.firebase.appdistribution
ปลั๊กอิน Crashlytics	com.google.firebase:firebase-crashlytics-gradle	3.0.6	com.google.firebase.crashlytics
ปลั๊กอิน Performance Monitoring	com.google.firebase:perf-plugin	2.0.2	com.google.firebase.firebase-perf

วิธีเพิ่มปลั๊กอิน Firebase ลงในโปรเจ็กต์ Android ที่ยังใช้ไวยากรณ์ buildscript มีดังนี้

1. ในไฟล์ Gradle ระดับรูท (ระดับโปรเจ็กต์) (<project>/build.gradle.kts หรือ <project>/build.gradle) ให้เพิ่มปลั๊กอินเป็น ทรัพยากร Dependency โดยใช้พิกัด Maven ของปลั๊กอิน

   Kotlin

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

   Groovy

   buildscript {
   
       repositories {
         // Make sure that you have the following two repositories
         google()  // Google's Maven repository
         mavenCentral()  // Maven Central repository
       }
   
       dependencies {
         ...
   
         // Add the Maven coordinates and latest version of the plugin
         classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
       }
   }
   
   allprojects {
     ...
   
     repositories {
       // Make sure that you have the following two repositories
       google()  // Google's Maven repository
       mavenCentral()  // Maven Central repository
     }
   }
   

2. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติคือ <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้เพิ่มปลั๊กอินโดยใช้ รหัสปลั๊กอิน

   Kotlin

   plugins {
       id("com.android.application")
   
       // Add the ID of the plugin
       id("FIREBASE_PLUGIN_ID")
       ...
   }
   

   Groovy

   plugins {
       id 'com.android.application'
   
       // Add the ID of the plugin
       id 'FIREBASE_PLUGIN_ID'
       ...
   }