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 geben 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. Versucht der Nutzer beispielsweise, sich mit einer E-Mail-Adresse und einem Passwort anzumelden, alle gemeldeten Fehler können explizit abgefangen werden:

try {
  await FirebaseAuth.instance.signInWithEmailAndPassword(
    email: "[e-mail]",
    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 Die Reference API bietet aktuelle Details zu den Fehlern für jede Methode.

Andere Fehler wie too-many-requests oder operation-not-allowed können ausgegeben werden, wenn Sie das Firebase Authentication-Kontingent 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 den Anmeldevorgang beim gewünschten Anbieter abzuschließen, muss sich der Nutzer zuerst beim vorhandenen Anbieter (z.B. Facebook) anmelden und dann eine Verknüpfung mit dem vorherigen Anbieter erstellen AuthCredential (Google-ID-Token).

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...
  }
}