You need to enable JavaScript to run this app. Android使用AWS Amplify如何识别Auth.signIn()错误以自定义用户提示
优惠活动
大模型
产品
解决方案
定价
更多

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存储的字符串资源实现多语言提示:

  1. 调整LiveData的存储类型,从原来的存提示文本,改为存储字符串资源ID
  2. 在错误回调中通过异常类型匹配对应的资源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
}
  1. 在Snackbar的触发位置,直接读取LiveData中存储的资源ID加载提示文本,自动适配当前系统语言。

注意事项

不要通过匹配异常的message文本判断错误类型,不同SDK版本、不同后端配置下的错误文本可能变动,直接判断异常子类的方式不会受版本更新影响,稳定性更高。

内容的提问来源于stack exchange,提问作者chrisdottel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 07:36:03