טיפול בשגיאות

ערכות ה-SDK לאימות ב-Firebase מספקות דרך פשוטה לזהות את השגיאות השונות שעלולות להתרחש, שיטות אימות. ערכות ה-SDK של Flutter חושפים את השגיאות האלה דרך FirebaseAuthException בכיתה.

code ו-message הם המאפיינים המינימליים שצריך לספק, אבל במקרים מסוימים צריך לספק גם מאפיינים נוספים כמו כתובת אימייל ופרטי כניסה. לדוגמה, אם המשתמש מנסה להיכנס באמצעות כתובת אימייל וסיסמה, אפשר לתפוס באופן מפורש את כל השגיאות שהושלחו:

try {
  await FirebaseAuth.instance.signInWithEmailAndPassword(
    email: "[e-mail]",
    password: "SuperSecretPassword!"
  );
} on FirebaseAuthException catch  (e) {
  print('Failed with error code: ${e.code}');
  print(e.message);
}

כל שיטה מספקת הודעות וקודי שגיאה שונים בהתאם לסוג הפעלת האימות. ב-Reference API מפורטים פרטים עדכניים על השגיאות בכל שיטה.

יכול להיות שיופיעו שגיאות אחרות כמו too-many-requests או operation-not-allowed אם תגיעו למכסת האימות ב-Firebase, או אם לא הפעלתם ספק אימות ספציפי.

טיפול בשגיאות מסוג account-exists-with-different-credential

אם הפעלתם את ההגדרה 'חשבון אחד לכל כתובת אימייל' במסוף Firebase, כשמשתמש ינסה להיכנס לחשבון אצל ספק (כמו Google) באמצעות כתובת אימייל שכבר קיימת אצל ספק של משתמש אחר ב-Firebase (כמו Facebook), תוצג השגיאה auth/account-exists-with-different-credential יחד עם סיווג AuthCredential (אסימון מזהה של Google). כדי להשלים את תהליך הכניסה לספק המיועד, המשתמש צריך קודם להיכנס לספק הקיים (לדוגמה: Facebook) ואז לבצע קישור לספק הקודם AuthCredential (אסימון מזהה של Google).

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