رسیدگی به خطا

Firebase Authentication SDK یک راه ساده برای کشف خطاهای مختلفی که ممکن است رخ دهد با استفاده از روش های احراز هویت ارائه می دهد. 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 جزئیات به روزی را در مورد خطاهای هر روش ارائه می دهد.

اگر به سهمیه Firebase Authentication برسید یا ارائه‌دهنده احراز هویت خاصی را فعال نکرده باشید، ممکن است خطاهای دیگری مانند too-many-requests یا operation-not-allowed ایجاد شود.

Handling account-exists-with-different-credential Errors

اگر تنظیمات یک حساب برای هر آدرس ایمیل را در کنسول Firebase فعال کرده باشید، وقتی کاربر سعی می‌کند با ایمیلی که از قبل برای ارائه‌دهنده کاربر Firebase دیگر (مانند Facebook) وجود دارد به یک ارائه‌دهنده (مانند Google) وارد شود، این خطا وجود دارد. auth/account-exists-with-different-credential همراه با یک کلاس AuthCredential (توکن Google ID) پرتاب می شود. برای تکمیل جریان ورود به سیستم ارائه‌دهنده مورد نظر، کاربر باید ابتدا وارد ارائه‌دهنده موجود (مثلا فیس‌بوک) شود و سپس به AuthCredential قبلی (توکن Google ID) پیوند دهد.

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