Fehler bei der Bestätigung der Telefonnummer in Firebase unter Android beheben

Wenn ein Aufruf der Firebase PNV-Bibliothek fehlschlägt, meldet die Bibliothek einen FirebasePhoneNumberVerificationException. Auf dieser Seite werden alle Fehlercodes aufgeführt, die die Ausnahme enthalten kann, wann sie auftreten und was Ihre App tun sollte.

Auf dieser Seite wird davon ausgegangen, dass Sie Firebase PNV wie unter Erste Schritte mit Firebase Phone Number Verification für Android beschrieben eingebunden haben.

Wie Fehler gemeldet werden

• Asynchrone Methoden (getVerificationSupportInfo(), getVerifiedPhoneNumber() und die Methoden für den benutzerdefinierten Ablauf) geben ein Task-Objekt zurück. Wenn sie fehlschlagen, schlägt die Task mit einem FirebasePhoneNumberVerificationException fehl, den Sie in addOnFailureListener erhalten.

• enableTestSession() ist synchron. Es wird direkt ein FirebasePhoneNumberVerificationException ausgegeben.

Lesen Sie die errorCode der Ausnahme, um herauszufinden, was schiefgelaufen ist. Die Firebase PNV-Codes sind Konstanten in der Klasse FirebasePnvStatusCodes. Wenn der Fehler von den Google Play-Diensten stammt, kann errorCode auch ein CommonStatusCodes-Wert sein, z. B. NETWORK_ERROR.

Ein nicht unterstütztes Gerät oder eine nicht unterstützte SIM-Karte ist kein Fehler. getVerificationSupportInfo() erfolgreich ist und isSupported() als false für diese SIM meldet und getReason() Ihnen den Grund dafür nennt. Weitere Informationen finden Sie unter Nicht unterstützte Geräte und SIM-Karten.

Fehlercodes

Testsitzung einrichten

Diese Fehler werden synchron von enableTestSession() ausgegeben.

Überprüfung

Diese Fehler führen dazu, dass der von getVerifiedPhoneNumber() zurückgegebene Task fehlschlägt.

Support-Check

Der von getVerificationSupportInfo() zurückgegebene Task schlägt nur fehl, wenn die Prüfung selbst nicht ausgeführt werden kann. In diesem Fall ist errorCode entweder ein CommonStatusCodes-Wert der Google Play-Dienste oder CARRIER_NOT_SUPPORTED. Behandle das Gerät als nicht unterstützt und verwende eine andere Bestätigungsmethode, z. B. SMS.

Während eine Testsitzung aktiviert ist, kontaktiert getVerificationSupportInfo() nicht das Firebase PNV-Backend und meldet die Test-SIM immer als unterstützt, auch wenn das Testtoken abgelaufen ist.

Benutzerdefinierter Ablauf

Wenn Sie den benutzerdefinierten Ablauf anstelle von getVerifiedPhoneNumber() verwenden:

• getDigitalCredentialPayload() schlägt mit PREFLIGHT_CHECK_FAILED oder mit INVALID_TEST_NUMBER_ID fehl, wenn das Backend Ihr Testtoken ablehnt.
• exchangeCredentialResponseForPhoneNumber() schlägt mit INVALID_DIGITAL_CREDENTIAL_RESPONSE oder mit INVALID_TEST_NUMBER_ID fehl, wenn das Backend Ihr Testtoken ablehnt.
• Ihr eigener Aufruf von Credential Manager löst eine GetCredentialException aus, die Sie direkt verarbeiten.

Nicht unterstützte Geräte und SIM-Karten

Wenn isSupported() für eine SIM-Karte false ist, gibt getReason() einen der folgenden VerificationSupportStatus-Werte zurück:

Verwenden Sie in jedem Fall eine andere Bestätigungsmethode, z. B. SMS, für diese SIM-Karte.

Beispiel

Im folgenden Beispiel werden die Fehler behandelt, die eine typische App beim Aufrufen von getVerifiedPhoneNumber() unterscheiden muss:

import android.util.Log
// Credential Manager is included with the Firebase PNV library.
import androidx.credentials.exceptions.GetCredentialCancellationException
import com.google.firebase.pnv.FirebasePhoneNumberVerification
import com.google.firebase.pnv.FirebasePhoneNumberVerificationException
import com.google.firebase.pnv.FirebasePnvStatusCodes

private const val TAG = "PhoneVerification"

// In your Activity:
private fun verifyPhoneNumber() {
    FirebasePhoneNumberVerification.getInstance()
        .getVerifiedPhoneNumber(this)
        .addOnSuccessListener { result ->
            // Send result.getToken() to your backend.
        }
        .addOnFailureListener { e -> handleFpnvError(e) }
}

private fun handleFpnvError(e: Exception) {
    if (e !is FirebasePhoneNumberVerificationException) {
        Log.w(TAG, "Firebase PNV failed", e)
        showSmsVerification()
        return
    }
    when (e.errorCode) {
        FirebasePnvStatusCodes.CREDENTIAL_MANAGER_ERROR -> {
            if (e.cause is GetCredentialCancellationException) {
                // The user dismissed the consent screen.
            }
            showSmsVerification()
        }
        FirebasePnvStatusCodes.INVALID_TEST_NUMBER_ID -> {
            // Test mode only: generate a new test token.
            Log.e(TAG, "Firebase PNV test token rejected", e)
        }
        FirebasePnvStatusCodes.ACTIVITY_CONTEXT_REQUIRED -> {
            // App bug: pass an Activity to getVerifiedPhoneNumber().
            Log.e(TAG, "Firebase PNV needs an Activity context", e)
        }
        else -> {
            // Carrier not supported, network errors, and other failures.
            Log.w(TAG, "Firebase PNV failed with error code ${e.errorCode}", e)
            showSmsVerification()
        }
    }
}

In diesem Beispiel ist showSmsVerification() der vorhandene Ablauf zur Bestätigung der Telefonnummer in Ihrer App.

Nächste Schritte

• Details zu den einzelnen Klassen und Konstanten finden Sie in der Firebase PNV API-Referenz.
• Informationen zum Bestätigen des Tokens auf Ihrem Server finden Sie unter Firebase PNV-Tokens bestätigen.