Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Firebase iOS Kimlik Doğrulama Hatalarını Yönetin

Kimlik Doğrulama yöntemlerinde tamamlama geri NSError , sıfır olmayan bir NSError bağımsız değişkeni alırsa, bir hata oluşmuştur. Üretim kodunuzdaki uygun hata işleme mantığına göndermek için, aşağıda listelenen yaygın hatalara ve yönteme özgü hatalara karşı hata kodunu kontrol edin.

Bazı hatalar belirli kullanıcı eylemleriyle çözülebilir; örneğin, FIRAuthErrorCodeUserTokenExpired , kullanıcıyı tekrar oturum açarak ve FIRAuthErrorCodeWrongPassword , kullanıcıdan doğru parolayı sağlamasını isteyerek FIRAuthErrorCodeWrongPassword .

FIRAuthErrorCodeNetworkError veya FIRAuthErrorCodeTooManyRequests durumu dışında, aynı bağımsız değişkenlerle başarısız bir işlemi yeniden denemek asla başarılı olmaz. İşlemin sunucu tarafında etkili olup olmadığı konusunda hiçbir varsayımda bulunmayın.

Hataları araştırırken veya günlüğe userInfo , userInfo sözlüğünü inceleyin. FIRAuthErrorNameKey , hatayı tanımlamak için kullanılabilen bir çapraz platform hata adı dizesi içerir. NSLocalizedDescriptionKey , hatanın açıklamasını içerir. Bu açıklama, kullanıcı için değil geliştirici içindir. NSUnderlyingErrorKey , altta yatan bir hata varsa söz konusu hataya neden olan temeldeki hatayı içerir.

Yukarıda listelenen ana alanlara ek olarak, userInfo sözlüğünde hataları teşhis ederken faydalı bulabileceğiniz başka alanlar da olabilir.

Tüm API yöntemlerinde ortak olan hata kodları

Kod Anlam
FIRAuthErrorCodeNetworkError İşlem sırasında bir ağ hatası oluştuğunu gösterir.
FIRAuthErrorCodeUserNotFound Kullanıcı hesabının bulunamadığını gösterir. Kullanıcı hesabı silinmişse bu olabilir.
FIRAuthErrorCodeUserTokenExpired Mevcut kullanıcının jetonunun süresinin dolduğunu gösterir, örneğin kullanıcı başka bir cihazda hesap şifresini değiştirmiş olabilir. Kullanıcıdan bu cihazda tekrar oturum açmasını istemelisiniz.
FIRAuthErrorCodeTooManyRequests Arayan cihazdan Firebase Authentication sunucularına anormal sayıda istekte bulunulduktan sonra isteğin engellendiğini belirtir. Bir süre sonra tekrar deneyin.
FIRAuthErrorCodeInvalidAPIKey Uygulamanın geçersiz bir API anahtarıyla yapılandırıldığını gösterir.
FIRAuthErrorCodeAppNotAuthorized Uygulamanın, sağlanan API Anahtarıyla Firebase Kimlik Doğrulaması'nı kullanma yetkisinin olmadığını belirtir. Google API Konsolu'na gidin ve kimlik bilgileri sekmesinin altında, kullandığınız API anahtarının uygulamanızın paket kimliğinin beyaz listeye alındığını kontrol edin.
FIRAuthErrorCodeKeychainError Anahtar zincirine erişilirken bir hata oluştuğunu gösterir. NSError.userInfo sözlüğündeki NSLocalizedFailureReasonErrorKey ve NSUnderlyingErrorKey alanları, karşılaşılan hata hakkında daha fazla bilgi içerir.
FIRAuthErrorCodeInternalError Dahili bir hata oluştuğunu gösterir. Lütfen hatayı tüm NSError nesnesi ile birlikte NSError .

Yönteme özel hata kodları

FIRAuth

fetchProvidersForEmail: tamamlama:

Kod Anlam
FIRAuthErrorCodeInvalidEmail E-posta adresinin bozuk olduğunu gösterir.

signInWithEmail: şifre: tamamlama:

Kod Anlam
FIRAuthErrorCodeOperationNotAllowed E-posta ve şifre hesaplarının etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.
FIRAuthErrorCodeInvalidEmail E-posta adresinin bozuk olduğunu gösterir.
FIRAuthErrorCodeUserDisabled Kullanıcının hesabının devre dışı bırakıldığını gösterir.
FIRAuthErrorCodeWrongPassword Kullanıcının yanlış bir parola ile oturum açmaya çalıştığını gösterir.

signInWithCredential: tamamlama:

Kod Anlam
FIRAuthErrorCodeInvalidCredential Sağlanan kimlik bilgilerinin geçersiz olduğunu gösterir. Bu, süresi dolmuşsa veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Firebase konsolunun Kimlik Doğrulama bölümünde bunları etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse Kimlik bilgileriyle öne sürülen e-postanın (ör. Facebook erişim belirtecindeki e-posta), bu oturum açma yöntemiyle kimliği doğrulanamayan mevcut bir hesap tarafından zaten kullanıldığını belirtir. Bu kullanıcının e- fetchProvidersForEmail için fetchProvidersForEmail arayın ve ardından döndürülen oturum açma sağlayıcılarından herhangi biriyle oturum fetchProvidersForEmail . Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "E-posta adresi başına bir hesap" ayarı etkinleştirildiğinde atılır.
FIRAuthErrorCodeUserDisabled Kullanıcının hesabının devre dışı bırakıldığını gösterir.
FIRAuthErrorCodeWrongPassword Kimlik bilgisi EmailPasswordAuthCredential , kullanıcının yanlış bir parola ile oturum açmaya çalıştığını gösterir.

signInAnonymousouslyWithCompletion:

Kod Anlam
FIRAuthErrorCodeOperationNotAllowed Anonim hesapların etkinleştirilmediğini gösterir. Firebase konsolunun Yetkilendirme bölümünde bunları etkinleştirin.

signInWithCustomToken: tamamlama:

Kod Anlam
FIRAuthErrorCodeInvalidCustomToken Özel jetonla ilgili bir doğrulama hatasını gösterir.
FIRAuthErrorCodeCustomTokenMismatch Hizmet hesabının ve API anahtarının farklı projelere ait olduğunu gösterir.

createUserWithEmail: şifre: tamamlama:

Kod Anlam
FIRAuthErrorCodeInvalidEmail E-posta adresinin bozuk olduğunu gösterir.
FIRAuthErrorCodeEmailAlreadyInUse Kaydolmayı denemek için kullanılan e-postanın zaten mevcut olduğunu gösterir. Böyle bir kullanıcının hangi oturum açma mekanizmalarını kullandığını kontrol etmek için fetchProvidersForEmail çağırın ve kullanıcıdan bunlardan fetchProvidersForEmail oturum fetchProvidersForEmail .
FIRAuthErrorCodeOperationNotAllowed E-posta ve şifre hesaplarının etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.
FIRAuthErrorCodeWeakPassword Çok zayıf kabul edilen bir parola belirleme girişimini gösterir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklamalar içerecektir.

oturumu Kapat:

Kod Anlam
FIRAuthErrorCodeKeychainError Anahtar zincirine erişilirken bir hata oluştuğunu belirtti. NSError.userInfo sözlüğündeki NSLocalizedFailureReasonErrorKey ve NSUnderlyingErrorKey alanları, karşılaşılan hata hakkında daha fazla bilgi içerir.

FIRUser

FIRUser işlemleri için yaygın hatalar

Kod Anlam
FIRAuthErrorCodeInvalidUserToken Oturum açmış kullanıcının oturum bilgilerini tutan yenileme belirtecinin geçersiz olduğunu belirtir. Kullanıcıdan bu cihazda tekrar oturum açmasını istemelisiniz.
FIRAuthErrorCodeUserDisabled Kullanıcının hesabının devre dışı bırakıldığını ve Firebase konsolundaki Kullanıcılar panelinden tekrar etkinleştirilene kadar kullanılamayacağını belirtir.

reauthenticateWithCredential: tamamlama:

Kod Anlam
FIRAuthErrorCodeInvalidCredential Sağlanan kimlik bilgilerinin geçersiz olduğunu gösterir. Bu, süresi dolmuşsa veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeWrongPassword Kimlik bilgisi EmailPasswordAuthCredential , kullanıcının yanlış bir parola ile yeniden kimlik doğrulama girişiminde bulunduğunu gösterir.
FIRAuthErrorCodeUserMismatch Mevcut kullanıcı olmayan bir kullanıcıyla yeniden kimlik doğrulama girişiminde bulunulduğunu gösterir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Firebase konsolunun Yetkilendirme bölümünde bunları etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse Kimlik bilgileriyle iddia edilen e-postanın (ör. Facebook erişim belirtecindeki e-posta), bu oturum açma yöntemiyle yeniden doğrulanamayan mevcut bir hesap tarafından zaten kullanıldığını gösterir. Bu kullanıcının e- fetchProvidersForEmail için fetchProvidersForEmail arayın ve ardından döndürülen oturum açma sağlayıcılarından herhangi biriyle oturum fetchProvidersForEmail . Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "E-posta adresi başına bir hesap" ayarı etkinleştirildiğinde atılır.
FIRAuthErrorCodeUserDisabled Kullanıcının hesabının devre dışı bırakıldığını gösterir.

updateEmail: tamamlama:

Kod Anlam
FIRAuthErrorCodeEmailAlreadyInUse E-postanın zaten başka bir hesap tarafından kullanıldığını gösterir.
FIRAuthErrorCodeInvalidEmail E-posta adresinin bozuk olduğunu gösterir.
FIRAuthErrorCodeRequiresRecentLogin Bir kullanıcının e-postasını güncellemek, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözmek için, FIRUser reauthenticateWithCredential:completion: FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .

updatePassword: tamamlama:

Kod Anlam
FIRAuthErrorCodeOperationNotAllowed Yöneticinin belirtilen kimlik sağlayıcıyla oturum açmayı devre dışı bıraktığını gösterir.
FIRAuthErrorCodeRequiresRecentLogin Bir kullanıcının şifresini güncelleme, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözmek için, FIRUser reauthenticateWithCredential:completion: FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .
FIRAuthErrorCodeWeakPassword Çok zayıf kabul edilen bir parola belirleme girişimini gösterir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklamalar içerecektir.

linkWithCredential: tamamlama:

Kod Anlam
FIRAuthErrorCodeProviderAlreadyLinked Bu hesaba zaten bağlı olan türde bir sağlayıcıyı bağlama girişimini gösterir.
FIRAuthErrorCodeCredentialAlreadyInUse Zaten farklı bir Firebase hesabına bağlanmış bir kimlik bilgileriyle bağlantı kurma girişimini gösterir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Firebase konsolunun Kimlik Doğrulama bölümünde bunları etkinleştirin.

Bu yöntem ayrıca updateEmail:completion: ve updatePassword:completion: updateEmail:completion: ile ilişkili hata kodlarını FIRUser .

unlinkFromProvider: tamamlama:

Kod Anlam
FIRAuthErrorCodeNoSuchProvider Hesaba bağlı olmayan bir sağlayıcının bağlantısını kaldırma girişimini gösterir.
FIRAuthErrorCodeRequiresRecentLogin E-postayı güncelleme, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözmek için, FIRUser reauthenticateWithCredential:completion: FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .

sendEmailVerificationWithCompletion:

Kod Anlam
FIRAuthErrorCodeUserNotFound Kullanıcı hesabının bulunamadığını gösterir.

deleteWithCompletion:

Kod Anlam
FIRAuthErrorCodeRequiresRecentLogin Bir kullanıcı hesabının silinmesi, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözmek için, FIRUser reauthenticateWithCredential:completion: FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .