Android使用AWS Amplify如何识别Auth.signIn()错误以自定义用户提示
Amplify Android 登录流程错误处理与自定义提示实现
两类核心回调的触发边界
Amplify的Auth.signIn()回调没有模糊的触发场景,所有分支都有明确定义:
- 成功回调分支
- 当
result.isSignInComplete = true:登录流程全部走完,用户已经被设置为当前登录态,和现有代码逻辑一致。 - 当
result.isSignInComplete = false:不属于密码错误等登录失败场景。这个分支仅对应需要补充额外信息才能完成登录的中间步骤,比如MFA验证码校验、强制重置临时密码、自定义认证挑战等。可通过result.nextStep.signInStep判断具体需要执行的操作,引导用户跳转对应页面即可,不需要弹出登录失败提示。
- 当
- 失败回调分支
所有校验不通过、后端拒绝的登录错误都会统一走到这个分支,不需要靠解析错误文本猜测场景,可通过直接判断异常类型100%匹配对应场景。
可直接识别的常见登录异常类型
Amplify Auth的所有错误都继承自AuthException,常见的登录相关异常子类包括:
AuthUserNotFoundException:输入的用户名在关联的用户池中不存在AuthNotAuthorizedException:密码校验不通过、账号无登录权限等被后端直接拒绝的场景AuthUserNotConfirmedException:用户完成注册但未做邮箱/手机号验证,无法正常登录AuthTooManyAttemptsException:连续输错密码次数触发限流,被临时禁止登录AuthInvalidPasswordException:账号当前密码不符合用户池配置的密码强度策略AuthValidationException:本地入参校验不通过,比如用户名为空、密码为空等场景
多语言自定义提示的落地实现
不需要直接使用error.recoverySuggestion作为面向用户的提示,这类SDK内置提示不支持多语言、话术也无法匹配产品定位。可通过判断异常类型,匹配本地XML存储的字符串资源实现多语言提示:
- 调整LiveData的存储类型,从原来的存提示文本,改为存储字符串资源ID
- 在错误回调中通过异常类型匹配对应的资源ID:
{ error -> Timber.tag(UserLogin.TAG).e(error, "Sign in failed") val tipResId = when (error) { is AuthUserNotFoundException -> R.string.error_login_user_not_found is AuthNotAuthorizedException -> R.string.error_login_wrong_password is AuthUserNotConfirmedException -> R.string.error_login_account_unverified is AuthTooManyAttemptsException -> R.string.error_login_attempts_limit is AuthValidationException -> R.string.error_login_invalid_input else -> R.string.error_login_unknown } authenticationRecoveryMessage.value = tipResId }
- 在Snackbar的触发位置,直接读取LiveData中存储的资源ID加载提示文本,自动适配当前系统语言。
注意事项
不要通过匹配异常的message文本判断错误类型,不同SDK版本、不同后端配置下的错误文本可能变动,直接判断异常子类的方式不会受版本更新影响,稳定性更高。
内容的提问来源于stack exchange,提问作者chrisdottel
相关产品推荐
相关产品推荐

