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ğrulaması Hatalarını İşleme

Kimlik Doğrulama yöntemlerine ilişkin tamamlama geri NSError , nil olmayan bir NSError argümanı alırsa, bir hata oluştu. Üretim kodunuzdaki uygun hata işleme mantığına göndermek için, hata kodunu sık karşılaşılan hatalara ve aşağıda listelenen yönteme özgü hatalara karşı kontrol edin.

Bazı hatalar belirli kullanıcı eylemleriyle çözülebilir, örneğin FIRAuthErrorCodeUserTokenExpired , kullanıcının tekrar oturum FIRAuthErrorCodeUserTokenExpired çözülebilir ve FIRAuthErrorCodeWrongPassword kullanıcıdan doğru şifreyi vermesini isteyerek FIRAuthErrorCodeWrongPassword .

FIRAuthErrorCodeNetworkError veya FIRAuthErrorCodeTooManyRequests 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ığına dair hiçbir varsayımda bulunmayın.

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

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

Tüm API yöntemlerinde ortak 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. Bu, kullanıcı hesabı silindiyse olabilir.
FIRAuthErrorCodeUserTokenExpired Geçerli kullanıcının belirtecinin süresinin dolduğunu belirtir; örneğin, kullanıcı başka bir cihazdaki hesap şifresini değiştirmiş olabilir. Kullanıcıdan bu cihazda tekrar oturum açmasını istemelisiniz.
FIRAuthErrorCodeTooManyRequests Arayan cihazdan Firebase Kimlik Doğrulama sunucularına anormal sayıda istek yapıldıktan sonra isteğin engellendiğini gösterir. 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ı ile Firebase Kimlik Doğrulaması kullanma yetkisi olmadığını belirtir. Google API Konsolu'na gidin ve kullandığınız API anahtarının uygulamanızın paket kimliğinin beyaz listeye eklenip eklenmediğini kontrol edin.
FIRAuthErrorCodeKeychainError Anahtarlık 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 hatanın meydana geldiğini gösterir. Lütfen hatayı tüm NSError nesnesiyle NSError .

Yönteme özgü hata kodları

FIRAuth

fetchProvidersForEmail: tamamlama:

kod anlam
FIRAuthErrorCodeInvalidEmail E-posta adresinin hatalı biçimlendiğini gösterir.

signInWithEmail: şifre: tamamlama:

kod anlam
FIRAuthErrorCodeOperationNotAllowed E-posta ve şifre hesaplarının etkin olmadığını gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.
FIRAuthErrorCodeInvalidEmail E-posta adresinin hatalı biçimlendiğini 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 Verilen kimlik bilgisinin geçersiz olduğunu gösterir. Bu, süresi dolmuş veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini belirtir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcısı olan hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse Kimlik bilgileri tarafından belirtilen e-postanın (örneğin, bir Facebook erişim belirtecindeki e-posta), bu oturum açma yöntemiyle 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 geri dönen oturum açma sağlayıcılarından herhangi biriyle oturum fetchProvidersForEmail . Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "Her e-posta adresi için bir hesap" ayarı etkinleştirilmişse 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.

signInAnonymouslyWithCompletion:

kod anlam
FIRAuthErrorCodeOperationNotAllowed Anonim hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.

signInWithCustomToken: tamamlama:

kod anlam
FIRAuthErrorCodeInvalidCustomToken Özel belirteçle ilgili bir doğrulama hatası olduğunu gösterir.
FIRAuthErrorCodeCustomTokenMismatch Hizmet hesabını ve API anahtarını farklı projelere ait gösterir.

createUserWithEmail: şifre: tamamlama:

kod anlam
FIRAuthErrorCodeInvalidEmail E-posta adresinin hatalı biçimlendiğini gösterir.
FIRAuthErrorCodeEmailAlreadyInUse Kaydolma girişimi için kullanılan e-postanın zaten var olduğunu gösterir. Kullanıcının hangi oturum açma mekanizmalarını kullandığını kontrol etmek için fetchProvidersForEmail arayın ve kullanıcıdan bunlardan fetchProvidersForEmail oturum fetchProvidersForEmail .
FIRAuthErrorCodeOperationNotAllowed E-posta ve şifre hesaplarının etkin olmadığını 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 belirtir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklama içerecektir.

oturumu Kapat:

kod anlam
FIRAuthErrorCodeKeychainError Anahtarlık erişilirken bir hata oluştuğunu belirtir. 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çan kullanıcının oturum bilgilerini içeren yenileme simgesinin geçersiz olduğunu gösterir. 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 Verilen kimlik bilgisinin geçersiz olduğunu gösterir. Bu, süresi dolmuş veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini belirtir.
FIRAuthErrorCodeWrongPassword Kimlik bilgisi EmailPasswordAuthCredential , kullanıcının yanlış bir parolayla yeniden kimlik doğrulaması girişiminde bulunduğunu belirtir.
FIRAuthErrorCodeUserMismatch Geçerli kullanıcı olmayan bir kullanıcıyla yeniden kimlik doğrulaması yapılmaya çalışıldığını gösterir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcısına sahip hesapların etkin olmadığını gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse Kimlik bilgileri tarafından belirtilen e-postanın (örneğin, bir 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 geri dönen oturum açma sağlayıcılarından herhangi biriyle oturum fetchProvidersForEmail . Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "Her e-posta adresi için bir hesap" ayarı etkinleştirilmişse atılır.
FIRAuthErrorCodeUserDisabled Kullanıcının hesabının devre dışı bırakıldığını gösterir.

updateEmail: tamamlanmasından:

kod anlam
FIRAuthErrorCodeEmailAlreadyInUse E-postanın başka bir hesap tarafından zaten kullanıldığını gösterir.
FIRAuthErrorCodeInvalidEmail E-posta adresinin hatalı biçimlendiğini gösterir.
FIRAuthErrorCodeRequiresRecentLogin Bir kullanıcının e-postasını güncellemek, kullanıcıdan en son oturum açmayı gerektiren güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yeterince yakın bir zamanda oturum açmadığını gösterir. Çözümlemek için, FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .

updatePassword: tamamlama:

kod anlam
FIRAuthErrorCodeOperationNotAllowed Belirtilen kimlik sağlayıcısıyla oturum devre dışı bırakılmış yöneticiyi belirtir.
FIRAuthErrorCodeRequiresRecentLogin Bir kullanıcının parolasını güncellemek, kullanıcıdan son oturum açmayı gerektiren güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yeterince yakın bir zamanda oturum açmadığını gösterir. Çözümlemek için FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .
FIRAuthErrorCodeWeakPassword Çok zayıf kabul edilen bir parola belirleme girişimini belirtir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklama içerecektir.

linkWithCredential: tamamlama:

kod anlam
FIRAuthErrorCodeProviderAlreadyLinked Bu hesaba zaten bağlı bir türde bir sağlayıcıyı bağlama girişimini gösterir.
FIRAuthErrorCodeCredentialAlreadyInUse Zaten farklı bir Firebase hesabına bağlanmış bir kimlik bilgisiyle bağlantı kurma girişimini gösterir.
FIRAuthErrorCodeOperationNotAllowed Kimlik bilgileriyle temsil edilen kimlik sağlayıcısına sahip hesapların etkin olmadığını gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.

Bu yöntem, aynı zamanda ilişkili hata kodları döndürebilir updateEmail:completion: ve updatePassword:completion: ilgili FIRUser .

unlinkFromProvider: tamamlanmasından:

kod anlam
FIRAuthErrorCodeNoSuchProvider Hesaba bağlı olmayan bir sağlayıcının bağlantısını kaldırma girişimini belirtir.
FIRAuthErrorCodeRequiresRecentLogin E-postayı güncellemek, kullanıcıdan son zamanlarda oturum açmayı gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yeterince yakın bir zamanda oturum açmadığını gösterir. Çözümlemek için 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ı silmek, kullanıcıdan son oturum açmayı gerektiren, güvenliğe duyarlı bir işlemdir. Bu hata, kullanıcının yeterince yakın bir zamanda oturum açmadığını gösterir. Çözümlemek için FIRUser reauthenticateWithCredential:completion: FIRUser çağırarak kullanıcıyı yeniden FIRUser .