Dart中try-catch无法捕获FileSystemException异常的问题排查

问题核心原因很明确：你调用的file.readAsString()是异步方法，它返回一个Future对象，不会立即执行文件读取操作。当前的同步try/catch块只能捕获同一代码流中同步抛出的异常，根本覆盖不到异步操作后续抛出的异常。当文件读取失败时，异常会被封装在返回的Future里，而非直接在当前代码流中抛出，所以你的try/catch完全捕获不到，最终变成未处理的全局异常。

两种可行的解决方法 #

方案1：用Future的catchError处理异步异常 #

直接在readAsString()返回的Future上链式调用catchError，专门处理异步操作的异常：

void main() {
  print(1);
  try {
    File file = File('random_path.txt');
    print(2);
    var contents = file.readAsString();
    print(3);
    contents.then((value) => print(value))
            .catchError((e) {
              if (e is FileSystemException) {
                print(5);
                print(e);
              } else {
                print(6);
                print(e);
              }
            });
    print(4);
  } finally {
    print(7);
  }

  print(8);
}

方案2：用async/await简化异步代码（推荐） #

把main方法标记为异步，用await等待异步操作完成，这样try/catch就能像处理同步代码一样捕获异步异常：

void main() async { // 标记为异步方法
  print(1);
  try {
    File file = File('random_path.txt');
    print(2);
    var contents = await file.readAsString(); // await等待操作完成
    print(3);
    print(contents);
    print(4);
  } on FileSystemException catch (e) {
    print(5);
    print(e);
  } catch (e) {
    print(6);
    print(e);
  } finally {
    print(7);
  }

  print(8);
}

这种写法让异步代码逻辑和同步代码保持一致，异常处理更直观，代码可读性更高。

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