Fehlerbehandlung

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

Es werden mindestens ein code und message bereitgestellt, in einigen Fällen werden jedoch auch zusätzliche Eigenschaften wie eine E-Mail-Adresse und Anmeldeinformationen bereitgestellt. Wenn der Benutzer beispielsweise versucht, sich mit einer E-Mail-Adresse und einem Passwort anzumelden, können alle ausgegebenen 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);
}

Jede Methode stellt abhängig von der Art des Authentifizierungsaufrufs verschiedene Fehlercodes und Meldungen bereit. Die Referenz-API bietet 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 Firebase-Authentifizierungskontingent erreichen oder keinen bestimmten Authentifizierungsanbieter aktiviert haben.

Behandeln von account-exists-with-different-credential Fehlern

Wenn Sie die Einstellung „Ein Konto pro E-Mail-Adresse“ in der Firebase-Konsole aktiviert haben und ein Benutzer versucht, sich bei einem Anbieter (z. B. Google) mit einer E-Mail-Adresse anzumelden, die bereits für den Anbieter eines anderen Firebase-Benutzers (z. B. Facebook) vorhanden ist, wird der Fehler angezeigt auth/account-exists-with-different-credential wird zusammen mit einer AuthCredential Klasse (Google-ID-Token) ausgelöst. Um den Anmeldevorgang beim vorgesehenen Anbieter abzuschließen, muss sich der Benutzer zunächst beim bestehenden Anbieter (z. B. Facebook) anmelden und dann eine Verknüpfung mit dem früheren 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...
  }
}