Flutter Firebase Auth：如何获取全部身份验证错误码以搭建完备UI响应

当前项目的注册功能实现参考 #

try {
  UserCredential userCredential = await FirebaseAuth.instance.createUserWithEmailAndPassword(
    email: "barry.allen@example.com",
    password: "SuperSecretPassword!"
  );
} on FirebaseAuthException catch (e) {
  if (e.code == 'weak-password') {
    print('The password provided is too weak.');
  } else if (e.code == 'email-already-in-use') {
    print('The account already exists for that email.');
  }
} catch (e) {
  print(e);
}

当前开发面临的问题 #

捕获FirebaseAuthException异常时，e.code会根据具体错误场景返回对应字符串形式的错误码，但无法定位完整的错误码清单，导致无法针对所有错误场景实现完备的UI交互反馈，需要明确全量错误码的查询渠道，支撑分支判断逻辑的补全。

全量错误码的获取方法 #

• 直接查阅本地项目依赖的插件源码：当通过pub安装了和项目版本完全匹配的firebase_auth插件后，可以直接在本地pub缓存路径下定位到插件源码中的auth_exception.dart文件，该文件内会枚举当前SDK版本支持的所有FirebaseAuthException错误码常量，拿到的错误码和项目实际运行的版本完全匹配，不会出现版本不一致导致的错误码偏差。
• 借助SDK内置的错误码常量定义：插件本身为了避免开发者硬编码字符串写错错误码，在异常类中暴露了所有错误码对应的静态常量，写分支逻辑时可以直接引用常量值，不需要手动记忆字符串拼写，从根源上减少拼写错误导致的判断失效问题。

createUserWithEmailAndPassword 接口的常见可适配错误码清单 #

当前使用的注册接口，实际触发的错误码范围是有限的，不需要把所有Auth模块的错误码都塞进注册流程的判断里，常见可适配的场景包括：

• invalid-email：传入的邮箱格式不合法
• weak-password：输入的密码长度或强度不满足要求
• email-already-in-use：目标邮箱已经注册过账号
• operation-not-allowed：Firebase控制台未开启邮箱密码注册的授权开关
• network-request-failed：设备网络异常，身份验证请求无法正常发出

需要特别说明的是，你提到的user-not-found这类错误不会在注册流程触发，它属于登录、找回密码这类针对存量账号操作的返回错误，不需要加入当前注册逻辑的分支判断，避免无意义的冗余分支。

分支逻辑的优化建议 #

• 不要追求对所有错误码做完全穷举的if/else匹配：不同SDK版本的错误码会随功能迭代调整，完全穷举的逻辑很容易因为版本升级出现适配漏项，反而增加维护成本
• 匹配逻辑可以做分层设计：优先对用户可感知、影响操作流程的常见错误做精准的交互提示，剩下未命中的错误统一走通用兜底提示，同时把原始异常码、异常信息记录到日志体系，后续线上遇到漏匹配的场景再补充对应分支即可
• 写判断条件时不要硬编码错误码字符串，直接引用SDK提供的错误码常量，避免因为手动输入拼写错误导致判断失效

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