PlatformDispatcher.instance.onError与runZonedGuarded使用场景解析

两者都是Flutter中处理未捕获异步异常的工具，但作用范围和适用场景完全不同：

一、优先用 runZonedGuarded 的场景 #

• 局部异步代码的异常隔离处理：如果你只需要处理某一段特定异步逻辑（比如某个业务模块的Future、Timer任务）的未捕获异常，用runZonedGuarded包裹这段代码，能把异常控制在局部范围内，避免影响全局。
• 自定义模块级异常策略：不同业务模块需要不同的异常处理逻辑（比如特定的日志上报格式、错误提示文案）时，给每个模块单独套runZonedGuarded，各自处理异常即可。
• 避免全局异常处理器被无关异常干扰：把明确归属于某块代码的异常在runZonedGuarded里处理掉，不让它们流入全局兜底逻辑，减少全局处理器的负担。

示例代码：

runZonedGuarded(() {
  // 这里放需要单独处理异常的异步代码
  Future.delayed(const Duration(seconds: 1), () {
    throw Exception("模块内部异步异常");
  });
}, (error, stackTrace) {
  // 模块专属的异常处理逻辑
  print("捕获到模块异常: $error");
  // 比如上报模块特定日志、展示模块内错误提示
});

二、必须用 PlatformDispatcher.instance.onError 的场景 #

• 全局兜底捕获未处理异常：作为最后一道防线，捕获所有逃出runZonedGuarded（比如第三方库内部的异步任务、未被包裹的全局异步逻辑）的未捕获异步异常，防止应用因未处理异常崩溃。
• 捕获引擎层面的跨边界异常：比如Flutter原生通道（MethodChannel）的调用异常、某些跨线程的异步任务异常，这类异常无法被普通Zone捕获，只能通过PlatformDispatcher.instance.onError拦截。

示例代码：

void main() {
  PlatformDispatcher.instance.onError = (error, stackTrace) {
    // 全局兜底处理逻辑
    print("全局捕获未处理异常: $error");
    // 比如统一上报崩溃日志、展示全局错误弹窗
    return true; // 返回true表示已处理，不会再向上抛
  };

  runApp(const MyApp());
}

三、两者的优先级关系 #

如果同时使用，runZonedGuarded会优先捕获自己包裹范围内的异常；只有当异常逃出所有Zone的处理范围时，才会触发PlatformDispatcher.instance.onError的全局处理逻辑。

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