Flutter中FlutterError.onError与PlatformDispatcher.instance.onError核心差异解析
核心差异（本质是同步/异步Dart代码的错误边界）
- FlutterError.onError：仅捕获Flutter框架调用栈内的同步Dart未捕获错误。比如在
build()、initState()这类Widget生命周期方法里同步抛出的异常，或者主线程同步执行的Dart代码错误。这类错误会直接中断Flutter渲染流程，框架默认行为是在Debug模式下显示红色错误界面。 - PlatformDispatcher.instance.onError：负责捕获所有异步Dart代码的未捕获错误，包括Future未处理的异常、async/await中未捕获的错误、Isolate抛出的未处理错误。这类错误不在Flutter渲染的同步调用栈内，无法被Flutter框架直接拦截，由Dart VM层面的调度器处理。
关于你提到的官方文档描述歧义：早期文档可能混淆了"Flutter代码"和"同步Dart代码"的概念——因为Flutter框架核心流程（如Widget构建）都是同步执行的，才会有"Flutter代码错误"的说法，但实际触发逻辑完全基于Dart代码的同步/异步属性。
另外，Java/Swift的原生异常确实不会触发这两个回调，因为Flutter和原生是独立运行时环境，原生异常在各自VM里处理，需要在原生端单独配置捕获逻辑（比如Android的UncaughtExceptionHandler、iOS的NSSetUncaughtExceptionHandler）。
分设机制的意义
职责拆分，精准处理
Flutter框架相关的同步错误（如Widget构建失败）和UI渲染强相关，FlutterError.onError可提供框架级处理能力——比如Debug模式下展示错误详情界面，Release模式下替换为兜底Widget；而异步错误多属于业务逻辑层面（如网络请求失败未处理），PlatformDispatcher.instance.onError适合做通用的错误上报、日志记录，与UI渲染逻辑解耦。错误上下文差异适配
触发FlutterError.onError时，能拿到完整的Flutter框架上下文（如Widget树信息、渲染栈），可输出更精准的错误定位信息；异步错误通常无直接UI上下文，只需通用错误处理逻辑，无需绑定Flutter框架细节。历史与架构兼容
Flutter早期错误处理仅覆盖框架同步流程，异步错误原本由Dart VM单独处理，后来整合到PlatformDispatcher中。分设两个回调是为了保留框架层和VM层错误处理的独立性，避免逻辑耦合，同时兼容旧代码的错误处理逻辑。
内容的提问来源于stack exchange，提问作者Nerdy Bunz
