FutureBuilder内Future抛未捕获异常是设计特性还是用法错误？

这是Flutter框架与Dart异步机制的正常设计表现，对应场景下FutureBuilder的使用方式不存在错误。

现象原理解释 #

• Dart异步异常的调度机制决定了：async函数内抛出异常的瞬间，异常会先被标记为未捕获状态投递到异步事件队列，此时调试器默认开启的「未捕获异步异常」断点会直接触发暂停。这个触发时机早于Future上注册的错误回调（包括FutureBuilder内部用于监听future结果、错误的处理逻辑）的执行时机，因此你会看到"未捕获异常"的提示，但该异常后续会被FutureBuilder正常接收，不会泄漏造成应用崩溃。
• 你尝试通过Future.delay()增加执行延迟没有改变现象，是因为无论Future延迟多久执行，只要异常抛出的瞬间还未走到对应错误回调的处理步骤，调试断点就会触发，这一现象和builder回调的注册时机无关。
• 官方文档在线运行环境没有抛出异常提示，是因为在线沙箱默认关闭了异步异常调试断点，同时沙箱的全局异常处理会静默接管这类已被框架后续逻辑处理的异常，不会打印错误信息打断运行。你在本地调试时点击继续执行后，应用可以正常显示"Got an error"的错误提示，就证明FutureBuilder已经正确捕获到异常，你写的错误分支逻辑完全生效。

标准实现参考 #

你当前的写法就是FutureBuilder处理异步请求、加载态、错误态的标准用法，参考实现如下：

class MyWidgetState extends State<MyWidget> {

  Future<String> getSomeText() async {
    // 抛出异常模拟网络请求错误
    throw Exception("Network error");
  }

  @override
  Widget build(BuildContext context) => FutureBuilder(
    future: getSomeText(),
    builder: (context, AsyncSnapshot<String> snapshot) {
      if (snapshot.connectionState == ConnectionState.done) {
        if (snapshot.hasError) {
          return Text("Got an error");
        }
        return Text(snapshot.data ?? '');
      }
      return const CircularProgressIndicator();
    }
  );
}

调试优化建议 #

如果不想每次调试都被这类正常的业务异常断住，可以在VSCode的调试断点配置面板，取消勾选「未捕获的异步异常」选项，仅保留同步未捕获异常断点即可，该调整不会影响你排查真正未被处理的异常问题。

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