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

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