Flutter/Dart中Try/Catch指定类型异常捕获未生效问题

你遇到的on 具体异常类型分支不生效、异常直接落到通用catch块的问题，90%以上是以下原因导致，按优先级排查即可：

• 异常类型导入不一致（最高发）
  Dart的类型匹配严格依赖类的导入来源，即使两个类名字、代码完全一致，如果导入路径不同，运行时会被判定为完全不同的类型，无法被on分支匹配。
  你需要核对两处的UserDoesNotExistsException导入路径：
  1. 实现getUser方法、抛出该异常的文件中的导入语句
  2. 编写getOrCreateUser方法、写on UserDoesNotExistsException捕获逻辑的文件中的导入语句

  常见错误场景：一个文件从package:xxx/src/xxx.dart这类内部路径导入异常类，另一个文件从库的公开入口（比如package:xxx/exceptions.dart，内部通过export导出了src下的异常类）导入，就会出现类型不匹配。
  快速验证方法：把通用catch块改成下面的代码，运行看打印结果：

  catch (e) {
    print('异常实际runtimeType: ${e.runtimeType}');
    print('e is UserDoesNotExistsException: ${e is UserDoesNotExistsException}');
    rethrow;
  }
  

  如果打印结果里e is UserDoesNotExistsException为false，直接统一所有用到该异常类的文件的导入路径，全部从同一个入口导入即可解决。
• 异常跨Isolate传递未做类型兼容
  如果你的getUser方法内部用了compute、新建了独立Isolate做数据库操作，异常从子Isolate传递到主Isolate时，如果子Isolate没有和主Isolate用完全一致的路径导入异常类，也会出现类型识别失败，解决方式同样是统一所有Isolate中对该异常类的导入路径。
• 异常类继承/重写问题（极低概率）
  如果你自定义的UserDoesNotExistsException重写了runtimeType属性，或者做了复杂的mixin、继承改造导致类型判定逻辑异常，也会导致匹配失效，这类问题可以通过新建一个最简单的异常类替换测试快速定位。

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