跨平台开发 / 系统课时

处理异常与失败路径

处理异常与失败路径

异常处理的目标不是“把错误都抓住”,而是让失败沿着可解释的路径流动:当前层能恢复就恢复,需要补充业务语义就转换,无法负责就继续向上传播。本篇用 on、catch、finally 和 rethrow 建立一套可直接套用的处理顺序。

学习目标

  • 使用 throw、on、catch 和 finally 组织异常处理与资源清理
  • 判断异常应该在当前层恢复、转换为更合适的异常,还是继续传播
  • 使用 rethrow 保留原异常语义并交给上层处理

先把正常路径和失败路径分开

Dart 使用 throw 抛出异常。try 中代码正常完成时继续执行后续逻辑;一旦抛出异常,会寻找第一个匹配的处理分支。on SomeException 用于按异常类型筛选,catch (e, st) 用于取得异常对象和可选堆栈信息。

下面的可运行示例把“端口解析失败”当作可在当前层处理的输入问题,并让 finally 无论成功或失败都执行清理逻辑。

dart
int parsePort(String raw) {
  final port = int.tryParse(raw);

  // 解析失败或越界都统一转成明确的格式异常。
  if (port == null || port < 1 || port > 65535) {
    throw const FormatException('port must be an integer from 1 to 65535');
  }

  return port;
}

void startService(String rawPort) {
  try {
    final port = parsePort(rawPort);
    print('start:$port');
  } on FormatException catch (e) {
    // 当前层知道如何向用户解释配置问题,因此在这里恢复。
    print('invalid:${e.message}');
  } finally {
    print('cleanup');
  }
}

void main() {
  startService('8080');
  startService('bad');
}

预期输出

text
start:8080
cleanup
invalid:port must be an integer from 1 to 65535
cleanup

finally 适合关闭文件、释放锁、撤销临时状态等必须执行的清理动作,但不要把“业务成功”逻辑放进去,因为它在异常路径上同样会运行。

按责任决定恢复、转换或传播

处理异常前先问“这一层是否知道怎样正确继续”。如果答案是肯定的,例如用户输入可以重新提示,就在当前层捕获并恢复。如果只能补充上下文,而真正决策应由更高层完成,可以转换为更贴近当前领域的异常。

片段示例:下面代码依赖上文的 parsePort,它把底层格式错误转换为配置错误,供更高层统一处理。

dart
class ConfigException implements Exception {
  final String message;

  const ConfigException(this.message);

  @override
  String toString() => 'ConfigException: $message';
}

int readConfiguredPort(String raw) {
  try {
    return parsePort(raw);
  } on FormatException catch (e) {
    throw ConfigException('invalid service port: ${e.message}');
  }
}

转换异常时应保留足够的原因信息,但不要在每一层都重复记录同一个失败,否则日志会充满重复堆栈。真正负责向用户、任务调度器或接口层做决策的地方再统一记录通常更清晰。

无法处理时继续向上传播

如果当前层只想补充日志或局部清理,但并不知道怎样恢复,应让异常继续传播。已经进入 catch 后,使用 rethrow 可以把当前异常继续交给上层,同时保留原异常的传播语义。

片段示例:下面代码依赖上文的 parsePort。

dart
int parseAndReport(String raw) {
  try {
    return parsePort(raw);
  } on FormatException catch (e) {
    print('parse failed: ${e.message}');
    rethrow;
  }
}

与“捕获后什么都不做”相比,rethrow 不会把失败伪装成成功。只有当调用方明确接受某个回退值时,才应该在 catch 中返回默认值。

异常从抛出到恢复、转换或继续传播的处理路径

用固定顺序检查异常代码

阅读或编写异常处理代码时,可以按“异常类型是否足够具体 → 当前层是否真的能恢复 → 是否需要转换语义 → 清理是否放在 finally → 无法处理时是否继续传播”的顺序检查。

异常边界应与责任边界一致:谁能决定下一步,谁就处理;谁只能补充上下文,就转换或记录后继续传播。这样正常路径保持简洁,失败也不会在中间层被静默丢失。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理异常与失败路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通