如何处理Amplify.Auth.signIn()抛出的AuthException？——错误信息解读与精准提示提取

我来帮你逐个拆解这三个问题：

这个提示其实是Amplify对Cognito返回的NotAuthorizedException做的通用模糊封装，它的实际意思根本不是“用户没有权限”——在你的场景里，就是用户名/密码不匹配导致的凭证验证失败（你已经确认用户名正确，那就是密码错了）。

Cognito会用NotAuthorizedException覆盖多种凭证验证失败的场景，Amplify没有做更细的区分，所以给出了这个容易让人误解的通用提示。

在Flutter Amplify中，AuthException携带了底层Cognito返回的异常细节，你可以通过两种方式获取更精准的错误信息：

方式一：通过错误码直接映射（推荐） #

不需要解析字符串，直接用e.code判断错误类型，然后给用户展示友好提示：

static Future<void> signIn(String username, String password) async {
  try {
    final signInResult = await Amplify.Auth.signIn(username: username, password: password);
  } on AuthException catch (e) {
    String userFriendlyMsg;
    switch(e.code) {
      case 'NotAuthorizedException':
        userFriendlyMsg = '用户名或密码错误，请重试';
        break;
      // 可以扩展其他常见错误类型
      case 'UserNotFoundException':
        userFriendlyMsg = '该用户不存在，请检查用户名';
      default:
        userFriendlyMsg = e.message;
    }
    print(userFriendlyMsg);
    // 这里把msg展示给用户，比如用SnackBar或Toast
  }
}

方式二：解析底层异常的原始信息 #

如果你确实需要拿到Cognito返回的原始字符串，可以通过e.underlyingException获取底层异常对象，再解析它的内容：

static Future<void> signIn(String username, String password) async {
  try {
    final signInResult = await Amplify.Auth.signIn(username: username, password: password);
  } on AuthException catch (e) {
    String userFriendlyMsg = e.message;
    // 检查底层异常
    if (e.underlyingException != null) {
      final rawExceptionStr = e.underlyingException.toString();
      // 用正则匹配原始错误信息
      final match = RegExp(r'Incorrect username or password\.').firstMatch(rawExceptionStr);
      if (match != null) {
        userFriendlyMsg = match.group(0)!;
      }
    }
    print(userFriendlyMsg);
  }
}

这里有几个实用的优化方向：

• 按错误类型精细化提示：像上面的例子一样，针对不同的Auth错误码（比如UserNotConfirmedException用户未验证、InvalidParameterException参数无效等）给出精准的用户提示，避免模糊的通用错误信息。
• 封装统一的错误处理工具：把Auth错误处理抽成单独的函数，在所有需要处理Auth异常的地方复用，避免重复代码：

  String getAuthUserFriendlyMsg(AuthException e) {
    switch(e.code) {
      case 'NotAuthorizedException':
        return '用户名或密码错误';
      case 'UserNotFoundException':
        return '未找到该用户';
      case 'UserNotConfirmedException':
        return '请先验证你的邮箱/手机号';
      default:
        return '操作失败：${e.message}';
    }
  }
  

• 兜底捕获所有异常：除了AuthException，还要捕获通用的Exception作为兜底，避免未处理的异常导致APP崩溃。
• 结合UI反馈：把错误信息展示在界面上（比如Flutter的SnackBar、AlertDialog），而不是只打印日志，让用户清楚知道哪里出了问题。

优化后的完整示例：

String getAuthUserFriendlyMsg(AuthException e) {
  switch(e.code) {
    case 'NotAuthorizedException':
      return '用户名或密码错误，请重试';
    case 'UserNotFoundException':
      return '未找到该用户，请检查用户名';
    case 'UserNotConfirmedException':
      return '请先验证你的邮箱或手机号';
    case 'InvalidParameterException':
      return '输入格式不正确，请检查';
    default:
      return '登录失败：${e.message}';
  }
}

static Future<void> signIn(String username, String password) async {
  try {
    final signInResult = await Amplify.Auth.signIn(username: username, password: password);
    // 登录成功逻辑，比如跳转主页
    if (signInResult.isSignedIn) {
      // Navigator.pushNamed(context, '/home');
    }
  } on AuthException catch (e) {
    final errorMsg = getAuthUserFriendlyMsg(e);
    // 展示错误给用户，比如用SnackBar
    // ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text(errorMsg)));
    print(errorMsg);
  } catch (e) {
    // 兜底处理未知异常
    print('发生未知错误：$e');
    // ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text('登录失败，请稍后重试')));
  }
}

内容的提问来源于stack exchange，提问作者user18420394