Amplify.Swift iOS：如何捕获AuthError并提取友好错误描述

核心原因 #

Amplify.Swift抛出的认证错误往往不会直接以AuthError类型抛出，而是被包装在AmplifyError中（通过其underlyingError属性），导致你的第一个catch块无法匹配到目标类型。

解决方案步骤 #

1. 先排查错误实际类型
   在通用catch块中打印错误的具体类型，确认错误的真实形态：

   catch {
       print("错误实际类型：\(type(of: $0))")
       print("错误详情：\($0)")
   }
   

2. 调整catch块顺序，优先捕获AmplifyError
   先捕获AmplifyError，再从中提取内部的AuthError；同时保留直接捕获AuthError的分支，覆盖所有可能的情况：

   func signIn(username: String, password: String) async {
       do {
           let signInResult = try await Amplify.Auth.signIn(username: username, password: password)
           if signInResult.isSignedIn {
               print("登录成功")
               // 处理登录成功逻辑
           }
       } catch let amplifyError as AmplifyError {
           // 处理Amplify包装的错误，提取内部AuthError
           if let authError = amplifyError.underlyingError as? AuthError {
               let friendlyMsg = authError.errorDescription ?? "登录失败，请检查账号密码"
               print(friendlyMsg)
               // 更新UI展示友好提示
           } else {
               print("Amplify服务错误：\(amplifyError.message)")
           }
       } catch let authError as AuthError {
           // 处理直接抛出的AuthError（部分场景可能出现）
           let friendlyMsg = authError.errorDescription ?? "登录失败，请重试"
           print(friendlyMsg)
       } catch {
           // 兜底处理其他未知错误
           print("未知错误：\(error.localizedDescription)")
       }
   }
   

3. 检查Amplify版本
   确保使用最新版的Amplify.Swift，旧版本可能存在错误抛出逻辑的bug，升级后可解决部分类型匹配问题。

4. 排除自定义代码的干扰
   检查是否有自定义的错误处理逻辑（比如封装的Amplify调用工具类），不小心将AuthError转换为了通用Error类型。

内容的提问来源于stack exchange，提问作者javeria taj bijly