Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
SDK xác thực Firebase cung cấp một cách đơn giản để phát hiện nhiều lỗi khác nhau có thể xảy ra mà sử dụng
xác thực. Các SDK dành cho Flutter hiển thị các lỗi này thông qua FirebaseAuthException
.
Tối thiểu, bạn phải cung cấp code và message. Tuy nhiên, trong một số trường hợp, các thuộc tính bổ sung như địa chỉ email
và chứng chỉ danh tính cũng được cung cấp. Ví dụ: nếu người dùng đang cố đăng nhập bằng email và mật khẩu,
bất kỳ lỗi nào được gửi đều có thể được phát hiện rõ ràng:
try{awaitFirebaseAuth.instance.signInWithEmailAndPassword(email:"barry.allen@example.com",password:"SuperSecretPassword!");}onFirebaseAuthExceptioncatch(e){print('Failed with error code: ${e.code}');print(e.message);}
Mỗi phương thức cung cấp nhiều mã lỗi và thông báo tuỳ thuộc vào loại lệnh gọi xác thực. Chiến lược phát hành đĩa đơn
Reference API cung cấp thông tin mới nhất về lỗi của mỗi phương thức.
Các lỗi khác như too-many-requests hoặc operation-not-allowed có thể được gửi nếu bạn đạt đến hạn mức Xác thực Firebase,
hoặc chưa bật một nhà cung cấp dịch vụ xác thực cụ thể.
Xử lý account-exists-with-different-credential lỗi
Nếu bạn đã bật chế độ cài đặt Một tài khoản cho mỗi địa chỉ email trong bảng điều khiển của Firebase,
khi người dùng cố gắng đăng nhập vào một nhà cung cấp (chẳng hạn như Google) bằng một email đã tồn tại cho nhà cung cấp của một nhà cung cấp khác của người dùng Firebase
(chẳng hạn như Facebook), lỗi auth/account-exists-with-different-credential được gửi cùng với lớp AuthCredential (mã thông báo mã nhận dạng Google).
Để hoàn tất quy trình đăng nhập vào nhà cung cấp mong muốn, trước tiên người dùng phải đăng nhập vào nhà cung cấp hiện tại (ví dụ: Facebook) rồi liên kết với nhà cung cấp cũ
AuthCredential (Mã thông báo giá trị nhận dạng của Google).
FirebaseAuthauth=FirebaseAuth.instance;// Create a credential from a Google Sign-in RequestvargoogleAuthCredential=GoogleAuthProvider.credential(accessToken:'xxxx');try{// Attempt to sign in the user in with Googleawaitauth.signInWithCredential(googleAuthCredential);}onFirebaseAuthExceptioncatch(e){if(e.code=='account-exists-with-different-credential'){// The account already exists with a different credentialStringemail=e.email;AuthCredentialpendingCredential=e.credential;// Fetch a list of what sign-in methods exist for the conflicting userList<String>userSignInMethods=awaitauth.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 passwordStringpassword='...';// Sign the user in to their account with the passwordUserCredentialuserCredential=awaitauth.signInWithEmailAndPassword(email:email,password:password,);// Link the pending credential with the existing accountawaituserCredential.user.linkWithCredential(pendingCredential);// Success! Go back to your application flowreturngoToApplication();}// 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 credentialStringaccessToken=awaittriggerFacebookAuthentication();varfacebookAuthCredential=FacebookAuthProvider.credential(accessToken);// Sign the user in with the credentialUserCredentialuserCredential=awaitauth.signInWithCredential(facebookAuthCredential);// Link the pending credential with the existing accountawaituserCredential.user.linkWithCredential(pendingCredential);// Success! Go back to your application flowreturngoToApplication();}// Handle other OAuth providers...}}
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Error Handling\n\n\u003cbr /\u003e\n\nThe Firebase Authentication SDKs provide a simple way for catching the various errors which may occur which using\nauthentication methods. The SDKs for Flutter expose these errors via the `FirebaseAuthException`\nclass.\n\nAt a minimum, a `code` and `message` are provided, however in some cases additional properties such as an email address\nand credential are also provided. For example, if the user is attempting to sign in with an email and password,\nany errors thrown can be explicitly caught: \n\n try {\n await FirebaseAuth.instance.signInWithEmailAndPassword(\n email: \"barry.allen@example.com\",\n password: \"SuperSecretPassword!\"\n );\n } on FirebaseAuthException catch (e) {\n print('Failed with error code: ${e.code}');\n print(e.message);\n }\n\nEach method provides various error codes and messages depending on the type of authentication invocation type. The\n[Reference API](https://pub.dev/documentation/firebase_auth/latest/) provides up-to-date details on the errors for each method.\n\nOther errors such as `too-many-requests` or `operation-not-allowed` may be thrown if you reach the Firebase Authentication quota,\nor have not enabled a specific auth provider.\n\nHandling `account-exists-with-different-credential` Errors\n----------------------------------------------------------\n\nIf you enabled the One account per email address setting in the [Firebase console](https://console.firebase.google.com/project/_/authentication/providers),\nwhen a user tries to sign in a to a provider (such as Google) with an email that already exists for another Firebase user's provider\n(such as Facebook), the error `auth/account-exists-with-different-credential` is thrown along with an `AuthCredential` class (Google ID token).\nTo complete the sign-in flow to the intended provider, the user has to first sign in to the existing provider (e.g. Facebook) and then link to the former\n`AuthCredential` (Google ID token). \n\n FirebaseAuth auth = FirebaseAuth.instance;\n\n // Create a credential from a Google Sign-in Request\n var googleAuthCredential = GoogleAuthProvider.credential(accessToken: 'xxxx');\n\n try {\n // Attempt to sign in the user in with Google\n await auth.signInWithCredential(googleAuthCredential);\n } on FirebaseAuthException catch (e) {\n if (e.code == 'account-exists-with-different-credential') {\n // The account already exists with a different credential\n String email = e.email;\n AuthCredential pendingCredential = e.credential;\n\n // Fetch a list of what sign-in methods exist for the conflicting user\n List\u003cString\u003e userSignInMethods = await auth.fetchSignInMethodsForEmail(email);\n\n // If the user has several sign-in methods,\n // the first method in the list will be the \"recommended\" method to use.\n if (userSignInMethods.first == 'password') {\n // Prompt the user to enter their password\n String password = '...';\n\n // Sign the user in to their account with the password\n UserCredential userCredential = await auth.signInWithEmailAndPassword(\n email: email,\n password: password,\n );\n\n // Link the pending credential with the existing account\n await userCredential.user.linkWithCredential(pendingCredential);\n\n // Success! Go back to your application flow\n return goToApplication();\n }\n\n // Since other providers are now external, you must now sign the user in with another\n // auth provider, such as Facebook.\n if (userSignInMethods.first == 'facebook.com') {\n // Create a new Facebook credential\n String accessToken = await triggerFacebookAuthentication();\n var facebookAuthCredential = FacebookAuthProvider.credential(accessToken);\n\n // Sign the user in with the credential\n UserCredential userCredential = await auth.signInWithCredential(facebookAuthCredential);\n\n // Link the pending credential with the existing account\n await userCredential.user.linkWithCredential(pendingCredential);\n\n // Success! Go back to your application flow\n return goToApplication();\n }\n\n // Handle other OAuth providers...\n }\n }"]]