Fehlerbehandlung

Die Firebase Authentication SDKs bieten eine einfache Möglichkeit, die verschiedenen Fehler zu erfassen, die bei der Verwendung von Authentifizierungsmethoden auftreten können. Die SDKs für Flutter zeigen diese Fehler über die Klasse FirebaseAuthException an.

Es werden mindestens code und message angegeben. In einigen Fällen werden auch zusätzliche Properties wie eine E-Mail-Adresse und Anmeldedaten angegeben. Wenn der Nutzer beispielsweise versucht, sich mit einer E-Mail-Adresse und einem Passwort anzumelden, können alle geworfenen Fehler explizit abgefangen werden:

try {
  await FirebaseAuth.instance.signInWithEmailAndPassword(
    email: "barry.allen@example.com",
    password: "SuperSecretPassword!"
  );
} on FirebaseAuthException catch  (e) {
  print('Failed with error code: ${e.code}');
  print(e.message);
}

Je nach Authentifizierungsaufruftyp werden für jede Methode verschiedene Fehlercodes und -meldungen ausgegeben. Die Referenz-API enthält aktuelle Details zu den Fehlern für jede Methode.

Andere Fehler wie too-many-requests oder operation-not-allowed können auftreten, wenn Sie das Kontingent für die Firebase-Authentifizierung erreichen oder keinen bestimmten Authentifizierungsanbieter aktiviert haben.

Umgang mit account-exists-with-different-credential-Fehlern

Wenn Sie in der Firebase Console die Einstellung „Ein Konto pro E-Mail-Adresse“ aktiviert haben und ein Nutzer versucht, sich bei einem Anbieter (z. B. Google) mit einer E-Mail-Adresse anzumelden, die bereits für den Anbieter eines anderen Firebase-Nutzers (z. B. Facebook) vorhanden ist, wird der Fehler auth/account-exists-with-different-credential zusammen mit einer AuthCredential-Klasse (Google-ID-Token) ausgelöst. Um die Anmeldung beim gewünschten Anbieter abzuschließen, muss sich der Nutzer zuerst beim bestehenden Anbieter (z. B. Facebook) anmelden und dann eine Verknüpfung zum ehemaligen AuthCredential (Google ID-Token) herstellen.

FirebaseAuth auth = FirebaseAuth.instance;

// Create a credential from a Google Sign-in Request
var googleAuthCredential = GoogleAuthProvider.credential(accessToken: 'xxxx');

try {
  // Attempt to sign in the user in with Google
  await auth.signInWithCredential(googleAuthCredential);
} on FirebaseAuthException catch (e) {
  if (e.code == 'account-exists-with-different-credential') {
    // The account already exists with a different credential
    String email = e.email;
    AuthCredential pendingCredential = e.credential;

    // Fetch a list of what sign-in methods exist for the conflicting user
    List<String> userSignInMethods = await auth.fetchSignInMethodsForEmail(email);

    // If the user has several sign-in methods,
    // the first method in the list will be the "recommended" method to use.
    if (userSignInMethods.first == 'password') {
      // Prompt the user to enter their password
      String password = '...';

      // Sign the user in to their account with the password
      UserCredential userCredential = await auth.signInWithEmailAndPassword(
        email: email,
        password: password,
      );

      // Link the pending credential with the existing account
      await userCredential.user.linkWithCredential(pendingCredential);

      // Success! Go back to your application flow
      return goToApplication();
    }

    // Since other providers are now external, you must now sign the user in with another
    // auth provider, such as Facebook.
    if (userSignInMethods.first == 'facebook.com') {
      // Create a new Facebook credential
      String accessToken = await triggerFacebookAuthentication();
      var facebookAuthCredential = FacebookAuthProvider.credential(accessToken);

      // Sign the user in with the credential
      UserCredential userCredential = await auth.signInWithCredential(facebookAuthCredential);

      // Link the pending credential with the existing account
      await userCredential.user.linkWithCredential(pendingCredential);

      // Success! Go back to your application flow
      return goToApplication();
    }

    // Handle other OAuth providers...
  }
}