Wenn der Abschluss-Callback für Authentication-Methoden ein NSError
-Argument empfängt, das
nicht null ist, ist ein Fehler aufgetreten. Weiterleitung zur entsprechenden Fehlerbehandlung
in Ihrem Produktionscode verwenden, prüfen Sie den Fehlercode auf häufige Fehler
methodenspezifischen Fehlern, die unten aufgeführt sind.
Einige Fehler können durch bestimmte Nutzeraktionen behoben werden, z. B.
FIRAuthErrorCodeUserTokenExpired
kann durch Anmeldung des Nutzers behoben werden
und FIRAuthErrorCodeWrongPassword
indem er den Nutzer bittet,
das richtige Passwort eingeben.
Außer bei FIRAuthErrorCodeNetworkError
oder FIRAuthErrorCodeTooManyRequests
ist es nicht möglich, einen fehlgeschlagenen Vorgang mit denselben Argumenten noch einmal auszuführen. Keine Annahmen darüber anstellen, ob der Vorgang
auf der Serverseite in Kraft getreten ist.
Prüfen Sie beim Untersuchen oder Logging von Fehlern das Wörterbuch userInfo
.
FIRAuthErrorNameKey
enthält einen plattformübergreifenden Fehlernamen-String, der zur Identifizierung des Fehlers verwendet werden kann.
NSLocalizedDescriptionKey
enthält eine Beschreibung des Fehlers. Dieses
Die Beschreibung richtet sich an den Entwickler, nicht an den Nutzer.
NSUnderlyingErrorKey
enthält den zugrunde liegenden Fehler, der den Fehler verursacht hat in
ob ein zugrunde liegender Fehler vorliegt.
Neben den oben aufgeführten Hauptfeldern können in der Spalte
userInfo
-Wörterbuch, das bei der Fehlerdiagnose nützlich sein kann.
Fehlercodes, die für alle API-Methoden gelten
Code |
Bedeutung |
FIRAuthErrorCodeNetworkError |
Gibt an, dass während des Vorgangs ein Netzwerkfehler aufgetreten ist. |
FIRAuthErrorCodeUserNotFound |
Gibt an, dass das Nutzerkonto nicht gefunden wurde. Das kann passieren, wenn das Nutzerkonto gelöscht wurde. |
FIRAuthErrorCodeUserTokenExpired |
Gibt an, dass das Token des aktuellen Nutzers abgelaufen ist, z. B. wenn der Nutzer das Kontopasswort auf einem anderen Gerät geändert hat. Sie müssen den Nutzer auffordern, sich auf diesem Gerät noch einmal anzumelden. |
FIRAuthErrorCodeTooManyRequests |
Gibt an, dass die Anfrage blockiert wurde, nachdem eine ungewöhnliche Anzahl von Anfragen vom Aufrufergerät an die Firebase Authentication-Server gesendet wurde. Versuchen Sie es später noch einmal. |
FIRAuthErrorCodeInvalidAPIKey |
Gibt an, dass die Anwendung mit einem ungültigen API-Schlüssel konfiguriert wurde. |
FIRAuthErrorCodeAppNotAuthorized |
Die App ist nicht autorisiert, die Firebase-Authentifizierung mit dem angegebenen API-Schlüssel zu verwenden. Rufen Sie die Google API Console auf und prüfen Sie auf dem Tab „Anmeldedaten“, ob die Bundle-ID Ihrer Anwendung für den verwendeten API-Schlüssel auf die Zulassungsliste gesetzt wurde. |
FIRAuthErrorCodeKeychainError |
Gibt an, dass beim Zugriff auf den Schlüsselbund ein Fehler aufgetreten ist. Die Felder NSLocalizedFailureReasonErrorKey und NSUnderlyingErrorKey im Wörterbuch NSError.userInfo enthalten weitere Informationen zum aufgetretenen Fehler. |
FIRAuthErrorCodeInternalError |
Gibt an, dass ein interner Fehler aufgetreten ist. Melden Sie den Fehler mit dem gesamten NSError -Objekt. |
Methodenspezifische Fehlercodes
FIRAuth
AbrufProvidersForEmail:Vervollständigung:
Code |
Bedeutung |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist. |
signInWithEmail:password:complete:
Code |
Bedeutung |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass E-Mail- und Passwortkonten nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole. |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist. |
FIRAuthErrorCodeUserDisabled |
Gibt an, dass das Konto des Nutzers deaktiviert ist. |
FIRAuthErrorCodeWrongPassword |
Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort anzumelden. |
signInWithCredential:Completion:
Code |
Bedeutung |
FIRAuthErrorCodeInvalidCredential |
Gibt an, dass die angegebenen Anmeldedaten ungültig sind. Das kann passieren, wenn sie abgelaufen oder fehlerhaft ist. |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind. |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass Konten beim Identitätsanbieter, der durch die Anmeldedaten vertreten wird, nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole. |
FIRAuthErrorCodeEmailAlreadyInUse |
Gibt an, dass die durch die Anmeldedaten (z.B. die E-Mail-Adresse in einem Facebook-Zugriffstoken) bestätigte E-Mail-Adresse bereits von einem vorhandenen Konto verwendet wird, das mit dieser Anmeldemethode nicht authentifiziert werden kann. Rufen Sie fetchProvidersForEmail auf, um die E-Mail-Adresse dieses Nutzers zu erhalten, und fordern Sie ihn auf, sich über einen der zurückgegebenen Anbieter anzumelden. Dieser Fehler tritt nur auf, wenn die Option "Ein Konto pro E-Mail-Adresse" ist in der Firebase-Konsole unter „Authentication“-Einstellungen aktiviert. |
FIRAuthErrorCodeUserDisabled |
Gibt an, dass das Konto des Nutzers deaktiviert ist. |
FIRAuthErrorCodeWrongPassword |
Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort anzumelden, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind. |
signInAnonymouslyWithCompletion:
Code |
Bedeutung |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass anonyme Konten nicht aktiviert sind. Aktiviere sie im Bereich „Authentifizierung“ der Firebase-Konsole. |
signInWithCustomToken:complete:
Code |
Bedeutung |
FIRAuthErrorCodeInvalidCustomToken |
Gibt einen Validierungsfehler beim benutzerdefinierten Token an. |
FIRAuthErrorCodeCustomTokenMismatch |
Gibt an, dass das Dienstkonto und der API-Schlüssel zu verschiedenen Projekten gehören. |
createUserWithEmail:password:completion:
Code |
Bedeutung |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist. |
FIRAuthErrorCodeEmailAlreadyInUse |
Gibt an, dass die für die Registrierung verwendete E-Mail-Adresse bereits vorhanden ist. Rufen Sie fetchProvidersForEmail auf, um zu prüfen, welche Anmeldemechanismen der Nutzer verwendet hat, und fordern Sie den Nutzer auf, sich mit einem dieser Mechanismen anzumelden. |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass E-Mail- und Passwortkonten nicht aktiviert sind. Sie können sie im Bereich „Authentication“ der Firebase-Konsole aktivieren. |
FIRAuthErrorCodeWeakPassword |
Weist auf einen Versuch hin, ein Passwort festzulegen, das als zu schwach eingestuft wird. Das Feld NSLocalizedFailureReasonErrorKey im Wörterbuchobjekt NSError.userInfo enthält eine detailliertere Erklärung, die dem Nutzer angezeigt werden kann. |
Abmelden:
Code |
Bedeutung |
FIRAuthErrorCodeKeychainError |
Gibt an, dass beim Zugriff auf den Schlüsselbund ein Fehler aufgetreten ist. Die Felder NSLocalizedFailureReasonErrorKey und NSUnderlyingErrorKey im Wörterbuch NSError.userInfo enthalten weitere Informationen zum aufgetretenen Fehler. |
FIRUser
Häufige Fehler bei FIRUser-Vorgängen
Code |
Bedeutung |
FIRAuthErrorCodeInvalidUserToken |
Gibt an, dass das Aktualisierungstoken des angemeldeten Nutzers, das die Sitzungsinformationen enthält, ungültig ist. Sie müssen den Nutzer auffordern, sich auf diesem Gerät noch einmal anzumelden. |
FIRAuthErrorCodeUserDisabled |
Gibt an, dass das Konto des Nutzers deaktiviert ist und erst wieder verwendet werden kann, wenn es im Bereich „Nutzer“ in der Firebase-Konsole wieder aktiviert wird. |
reauthenticateWithCredential:completion:
Code |
Bedeutung |
FIRAuthErrorCodeInvalidCredential |
Gibt an, dass die angegebenen Anmeldedaten ungültig sind. Das kann passieren, wenn sie abgelaufen oder fehlerhaft ist. |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist, wenn Anmeldedaten vom Typ EmailPasswordAuthCredential sind. |
FIRAuthErrorCodeWrongPassword |
Gibt an, dass der Nutzer versucht hat, sich mit einem falschen Passwort noch einmal zu authentifizieren, wenn die Anmeldedaten vom Typ EmailPasswordAuthCredential sind. |
FIRAuthErrorCodeUserMismatch |
Gibt an, dass versucht wurde, sich mit einem Nutzer neu zu authentifizieren, der nicht der aktuelle Nutzer ist. |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass Konten mit dem durch die Anmeldedaten repräsentierten Identitätsanbieter nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole. |
FIRAuthErrorCodeEmailAlreadyInUse |
Gibt an, dass die durch die Anmeldedaten (z.B. die E-Mail-Adresse in einem Facebook-Zugriffstoken) bestätigte E-Mail-Adresse bereits von einem vorhandenen Konto verwendet wird, das mit dieser Anmeldemethode nicht noch einmal authentifiziert werden kann. Rufen Sie fetchProvidersForEmail auf, um die E-Mail-Adresse dieses Nutzers zu erhalten, und fordern Sie ihn auf, sich über einen der zurückgegebenen Anbieter anzumelden. Dieser Fehler tritt nur auf, wenn die Option "Ein Konto pro E-Mail-Adresse" ist in der Firebase-Konsole unter „Authentication“-Einstellungen aktiviert. |
FIRAuthErrorCodeUserDisabled |
Gibt an, dass das Konto des Nutzers deaktiviert ist. |
updateEmail:completion:
Code |
Bedeutung |
FIRAuthErrorCodeEmailAlreadyInUse |
Gibt an, dass die E-Mail-Adresse bereits von einem anderen Konto verwendet wird. |
FIRAuthErrorCodeInvalidEmail |
Gibt an, dass die E-Mail-Adresse fehlerhaft ist. |
FIRAuthErrorCodeRequiresRecentLogin |
Das Aktualisieren der E-Mail-Adresse eines Nutzers ist ein sicherheitsrelevanter Vorgang, der eine aktuelle Anmeldung des Nutzers erfordert. Dieser Fehler gibt an, dass sich der Nutzer nicht vor Kurzem angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst. |
updatePassword:Vervollständigung:
Code |
Bedeutung |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass der Administrator die Anmeldung über den angegebenen Identitätsanbieter deaktiviert hat. |
FIRAuthErrorCodeRequiresRecentLogin |
Die Aktualisierung eines Nutzerpassworts ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht kürzlich angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst. |
FIRAuthErrorCodeWeakPassword |
Weist auf einen Versuch hin, ein Passwort festzulegen, das als zu schwach eingestuft wird. Das Feld NSLocalizedFailureReasonErrorKey im Wörterbuchobjekt NSError.userInfo enthält eine detailliertere Erklärung, die dem Nutzer angezeigt werden kann. |
linkWithCredential:completion:
Code |
Bedeutung |
FIRAuthErrorCodeProviderAlreadyLinked |
Gibt an, dass versucht wurde, einen Anbieter eines Typs zu verknüpfen, der bereits mit diesem Konto verknüpft ist. |
FIRAuthErrorCodeCredentialAlreadyInUse |
Weist auf einen Versuch hin, eine Verknüpfung mit einem Berechtigungsnachweis herzustellen, der bereits mit einem anderen Firebase-Konto verknüpft wurde. |
FIRAuthErrorCodeOperationNotAllowed |
Gibt an, dass Konten mit dem durch die Anmeldedaten repräsentierten Identitätsanbieter nicht aktiviert sind. Aktivieren Sie sie im Abschnitt „Auth“ der Firebase-Konsole. |
Diese Methode kann auch Fehlercodes zurückgeben, die mit updateEmail:completion:
und
updatePassword:completion:
am FIRUser
.
unlinkFromProvider:completion:
Code |
Bedeutung |
FIRAuthErrorCodeNoSuchProvider |
Zeigt an, dass versucht wurde, die Verknüpfung eines Anbieters aufzuheben, der nicht mit dem Konto verknüpft ist. |
FIRAuthErrorCodeRequiresRecentLogin |
Die Aktualisierung der E-Mail-Adresse ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht kürzlich angemeldet hat. Authentifizierung des Nutzers durch Aufrufen von reauthenticateWithCredential:completion: auf FIRUser noch einmal, um das Problem zu beheben. |
sendEmailVerificationWithCompletion:
Code |
Bedeutung |
FIRAuthErrorCodeUserNotFound |
Gibt an, dass das Nutzerkonto nicht gefunden wurde. |
deleteWithCompletion:
Code |
Bedeutung |
FIRAuthErrorCodeRequiresRecentLogin |
Das Löschen eines Nutzerkontos ist ein sicherheitsrelevanter Vorgang, für den eine kürzliche Anmeldung des Nutzers erforderlich ist. Dieser Fehler gibt an, dass sich der Nutzer nicht vor Kurzem angemeldet hat. Authentifiziere den Nutzer noch einmal, indem du reauthenticateWithCredential:completion: auf FIRUser aufrufst. |