توفر حزم 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...
}
}