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

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

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

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

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

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

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

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

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

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

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

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

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

ข้อผิดพลาดนี้มักจะหมายความว่าแอปของคุณไม่มีการอ้างอิงที่เก็บ Maven ของ Google อย่างน้อย 1 รายการ โปรดตรวจสอบว่าได้รวมที่เก็บ 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 ได้ปิดใช้ desugaring สำหรับไลบรารี Android ทั้งหมด (ดูหมายเหตุประจำรุ่น)

การเปลี่ยนแปลงนี้หมายความว่าบิลด์ Gradle ที่ใช้ปลั๊กอิน Android Gradle (AGP) v4.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 จากคีย์สโตร์การเผยแพร่/เวอร์ชันที่ใช้งานจริง ลงในแอป Firebase บน Android ในคอนโซล Firebase (ไปที่ การตั้งค่าโปรเจ็กต์ เลื่อนลงไปที่ แอปของคุณ แล้วเลือกแอป Android)
• คุณได้เพิ่มลายนิ้วมือใบรับรอง SHA-1 จากGoogle Play Consoleลงในแอป Firebase บน Android ในFirebase console (ไปที่ การตั้งค่าโปรเจ็กต์ เลื่อนลงไปที่แอปของคุณ แล้วเลือกแอป 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.1	com.google.firebase.appdistribution
ปลั๊กอิน Crashlytics	com.google.firebase:firebase-crashlytics-gradle	3.0.7	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'
       ...
   }
   

ฉันควรใส่ประกาศโอเพนซอร์สใดไว้ในแอป

Firebase Android SDK มี ตัวช่วย Activity สำหรับการแสดงข้อมูลใบอนุญาต