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

توفر حزم SDK لمصادقة Firebase طريقة بسيطة لاكتشاف الأخطاء المتنوعة التي قد تحدث باستخدام طرق المصادقة. تعرض مجموعات SDK الخاصة بـ Flutter هذه الأخطاء عبر فئة FirebaseAuthException .

كحد أدنى، يتم توفير code message ، ولكن في بعض الحالات يتم أيضًا توفير خصائص إضافية مثل عنوان البريد الإلكتروني وبيانات الاعتماد. على سبيل المثال، إذا كان المستخدم يحاول تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور، فيمكن اكتشاف أي أخطاء يتم إجراؤها بوضوح:

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);
}

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

قد يتم طرح أخطاء أخرى، مثل 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...
  }
}