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 machen diese Fehler über die Klasse FirebaseAuthException verfügbar.

Mindestens code und message werden angegeben. In einigen Fällen werden jedoch auch zusätzliche Eigenschaften wie eine E-Mail-Adresse und Anmeldedaten angegeben. Wenn der Nutzer sich beispielsweise mit einer E‑Mail-Adresse und einem Passwort anmelden möchte, 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 bietet verschiedene Fehlercodes und ‑meldungen, je nach Art des Authentifizierungsaufrufs. Die Referenz-API enthält aktuelle Informationen 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.

account-exists-with-different-credential-Fehler beheben

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