Flutter异步读取配置文件时异常处理的疑问

问题原因分析 #

你遇到的两个问题，根源通常是以下两种情况：

1. FileSystemException泄漏到Zone：Flutter的默认Zone会自动捕获未被妥善处理的异步异常并打印，哪怕你已经捕获了异常，若原异常没有被正确拦截或自定义异常抛出时带了原异常栈，可能会导致控制台打印原始错误。
2. 重复捕获/重复调用：要么是loadSettings被调用了两次，要么是异常在函数内部和调用处被两次捕获并打印信息。

修正后的代码示例 #

1. 定义自定义异常 #

class SettingsLoadingException implements Exception {
  final String message;
  SettingsLoadingException(this.message);
}

2. 重构loadSettings函数 #

精准捕获文件系统异常，避免原异常泄漏，同时只在一处打印提示：

import 'dart:convert';
import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<Map<String, dynamic>> loadSettings() async {
  final dir = await getApplicationDocumentsDirectory();
  final settingsFile = File('${dir.path}/settings.json');

  try {
    // 先检查文件存在性，提前抛出自定义异常（可选，也可以直接读取）
    if (!await settingsFile.exists()) {
      throw SettingsLoadingException("配置文件不存在");
    }
    final content = await settingsFile.readAsString();
    return jsonDecode(content);
  } on FileSystemException catch (_) {
    // 仅捕获文件系统相关异常，避免捕获其他错误
    print("No settings file!");
    throw SettingsLoadingException("加载配置失败：文件系统错误");
  } catch (e) {
    // 处理其他未知异常
    print("加载配置时出现未知错误：$e");
    throw SettingsLoadingException("加载配置失败：未知错误");
  }
}

3. 调用时统一异常处理 #

选择一种方式处理，不要同时混用try-catch和.catchError：

方式一：async-await调用

void initSettings() async {
  try {
    final settings = await loadSettings();
    // 正常使用配置
  } on SettingsLoadingException catch (e) {
    // 创建新配置文件
    print(e.message);
    await createNewSettings();
  }
}

方式二：链式调用（.then/.catchError）

void initSettings() {
  loadSettings()
      .then((settings) {
        // 正常使用配置
      })
      .catchError((e) {
        if (e is SettingsLoadingException) {
          print(e.message);
          createNewSettings();
        }
      }, test: (e) => e is SettingsLoadingException); // 只处理自定义异常
}

排查建议 #

• 验证loadSettings是否被重复调用：在函数开头加print("loadSettings 被调用了")，看控制台输出次数。
• 统一打印逻辑：要么在loadSettings内部打印提示，要么在调用处打印，不要两边都输出相同内容。
• 避免异常栈泄漏：抛出自定义异常时，不要将原FileSystemException作为参数传递（除非你需要保留栈信息），防止Zone捕获并打印原始异常。

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