Fehlerbehandlung

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

Mindestens ein code und message werden bereitgestellt. In einigen Fällen werden jedoch auch zusätzliche Eigenschaften wie eine E-Mail-Adresse und Qualifikation angegeben. Wenn sich der Nutzer beispielsweise mit einer E-Mail-Adresse und einem Passwort anmelden möchte, können alle ausgelösten 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 bietet je nach Art des Authentifizierungsaufrufs verschiedene Fehlercodes und ‑meldungen. 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 Firebase Authentication-Kontingent erreichen oder einen bestimmten Authentifizierungsanbieter nicht aktiviert haben.

Fehler account-exists-with-different-credential beheben

Wenn Sie in der Firebase Konsole 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 bestehenden Anbieter (z. B. Facebook) anmelden und dann eine Verknüpfung zum vorherigen 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...
  }
}