Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los SDK de Firebase Authentication te permiten detectar fácilmente los diversos errores que pueden ocurrir y usar
métodos de autenticación. Los SDK para Flutter exponen estos errores a través de la clase
FirebaseAuthException.
Como mínimo, se proporcionan code y message. Sin embargo, en algunos casos, también se proporcionan propiedades adicionales, como una dirección de correo electrónico
y una credencial. Por ejemplo, si el usuario intenta acceder con un correo electrónico y una contraseña,
cualquier error que aparezca se puede detectar de forma explícita:
try{awaitFirebaseAuth.instance.signInWithEmailAndPassword(email:"barry.allen@example.com",password:"SuperSecretPassword!");}onFirebaseAuthExceptioncatch(e){print('Failed with error code: ${e.code}');print(e.message);}
Cada método proporciona varios códigos de error y mensajes según el tipo de invocación de autenticación. La
API de referencia proporciona detalles actualizados sobre los errores de cada método.
Es posible que se produzcan otros errores, como too-many-requests o operation-not-allowed, si alcanzas la cuota de Firebase Authentication
o si no habilitaste un proveedor de autenticación específico.
Maneja los errores account-exists-with-different-credential
Si habilitaste la configuración Una cuenta por dirección de correo electrónico en Firebase console,
aparecerá el error auth/account-exists-with-different-credential junto con una clase AuthCredential (token de ID de Google) cuando un usuario trate de acceder a un proveedor
(como Google) con un correo electrónico que ya está vinculado al proveedor de otro usuario de Firebase (como Facebook).
Para completar el flujo de acceso con el proveedor deseado, el usuario primero deberá acceder al proveedor existente (p. ej., Facebook) y, luego, vincularlo con la AuthCredential
anterior (token de ID de 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...}}
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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 }"]]