使用Dart Future.timeout()时无法捕获异常的解决方法咨询

问题出在timeout方法的行为逻辑上：当超时触发后，timeout返回的新Future会通过onTimeout的结果立即完成，但原resultFuture会继续在后台执行。由于你的代码没有监听原resultFuture的后续异常（既没有await它，也没有添加错误处理），当_innerComplexAsyncTask延迟抛出异常时，这个异常会成为未捕获的异步异常，无法被main函数的try-catch块捕获（该块仅覆盖了await timeoutFuture的过程）。

以下两种方案均无需修改下划线开头的包内代码，仅修改main函数即可：

方案1：直接处理原Future的异常 #

在创建resultFuture后，给它添加错误处理逻辑，确保延迟抛出的异常不会变成未捕获异常：

Future<void> main() async {
  try {
    var resultFuture = _complexAsyncTask();
    // 处理原Future的延迟异常，避免未捕获
    resultFuture.catchError((e) {
      print("catched late exception: $e");
    });

    var timeoutFuture = resultFuture.timeout(const Duration(seconds: 1), onTimeout: () {
      print("timeout");
      return "timeout return";
    });

    final String result = await timeoutFuture;
    print(result);
  } catch (e) {
    print("catched exception: $e");
  }
}

方案2：用Completer整合超时与原Future异常 #

如果希望把原Future的延迟异常也纳入main函数的try-catch捕获范围，可以用Completer手动控制Future的完成逻辑：

Future<void> main() async {
  try {
    var resultFuture = _complexAsyncTask();
    final completer = Completer<String>();

    // 监听原Future的结果与异常
    resultFuture.then((value) {
      if (!completer.isCompleted) {
        completer.complete(value);
      } else {
        print("task completed after timeout: $value");
      }
    }).catchError((e) {
      if (!completer.isCompleted) {
        completer.completeError(e);
      } else {
        // 超时后抛出的异常也会被try-catch捕获
        completer.completeError(e);
      }
    });

    // 触发超时逻辑
    Future.delayed(const Duration(seconds: 1), () {
      if (!completer.isCompleted) {
        print("timeout");
        completer.complete("timeout return");
      }
    });

    final String result = await completer.future;
    print(result);
  } catch (e) {
    print("catched exception: $e");
  }
}

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