معالجة الأخطاء

توفّر حِزم تطوير البرامج (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);
}

توفّر كل طريقة رموز خطأ ورسائل مختلفة استنادًا إلى نوع نوع طلب المصادقة. توفر واجهة برمجة التطبيقات المرجعية تفاصيل حديثة عن الأخطاء لكل طريقة.

قد يتم طرح أخطاء أخرى، مثل too-many-requests أو operation-not-allowed، إذا وصلت إلى حصة مصادقة Firebase أو لم تفعِّل موفِّر مصادقة معيّنًا.

التعامل مع أخطاء account-exists-with-different-credential

إذا فعّلت الإعداد حساب واحد لكل عنوان بريد إلكتروني في Firebase console, فعندما يحاول مستخدم تسجيل الدخول إلى موفِّر (مثل 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...
  }
}