跳到主要内容
目录

错误处理

目录

异常

#

你的 Dart 代码可以抛出和捕获异常。异常是表示发生了意外情况的错误。如果异常未被捕获，抛出异常的隔离区 (isolate) 将被挂起，通常该隔离区及其程序也会终止。

与 Java 不同，Dart 的所有异常都是非检查异常。方法不会声明它们可能抛出哪些异常，并且你无需捕获任何异常。

Dart 提供了 Exception 和 Error 类型，以及许多预定义的子类型。当然，你可以定义自己的异常。然而，Dart 程序可以抛出任何非空对象作为异常，而不仅仅是 Exception 和 Error 对象。

抛出

#

这是一个抛出（或引发）异常的例子

dart
throw FormatException('Expected at least 1 section');

你也可以抛出任意对象

dart
throw 'Out of llamas!';

因为抛出异常是一个表达式，所以你可以在 => 语句以及任何允许表达式的地方抛出异常

dart
void distanceTo(Point other) => throw UnimplementedError();

捕获

#

捕获异常可以阻止异常传播（除非你重新抛出异常）。捕获异常让你有机会处理它

dart
try {
  breedMoreLlamas();
} on OutOfLlamasException {
  buyMoreLlamas();
}

要处理可能抛出多种类型异常的代码，可以指定多个 catch 子句。第一个匹配抛出对象类型的 catch 子句会处理该异常。如果 catch 子句没有指定类型，该子句可以处理任何类型的抛出对象

dart
try {
  breedMoreLlamas();
} on OutOfLlamasException {
  // A specific exception
  buyMoreLlamas();
} on Exception catch (e) {
  // Anything else that is an exception
  print('Unknown exception: $e');
} catch (e) {
  // No specified type, handles all
  print('Something really unknown: $e');
}

如前面的代码所示，你可以使用 on 或 catch，或两者都用。当你需要指定异常类型时使用 on。当你的异常处理器需要异常对象时使用 catch。

你可以为 catch() 指定一个或两个参数。第一个是被抛出的异常，第二个是堆栈跟踪（一个 StackTrace 对象）。

dart
try {
  // ···
} on Exception catch (e) {
  print('Exception details:\n $e');
} catch (e, s) {
  print('Exception details:\n $e');
  print('Stack trace:\n $s');
}

要部分处理异常，同时允许其继续传播，请使用 rethrow 关键字。

dart
void misbehave() {
  try {
    dynamic foo = true;
    print(foo++); // Runtime error
  } catch (e) {
    print('misbehave() partially handled ${e.runtimeType}.');
    rethrow; // Allow callers to see the exception.
  }
}

void main() {
  try {
    misbehave();
  } catch (e) {
    print('main() finished handling ${e.runtimeType}.');
  }
}

Finally

#

为了确保无论是否抛出异常都运行某些代码，请使用 finally 子句。如果没有 catch 子句匹配该异常，异常会在 finally 子句运行后传播。

dart
try {
  breedMoreLlamas();
} finally {
  // Always clean up, even if an exception is thrown.
  cleanLlamaStalls();
}

finally 子句在任何匹配的 catch 子句之后运行

dart
try {
  breedMoreLlamas();
} catch (e) {
  print('Error: $e'); // Handle the exception first.
} finally {
  cleanLlamaStalls(); // Then clean up.
}

要了解更多信息，请查阅核心库异常文档。

断言

#

在开发期间，使用 assert 语句 — assert(<condition>, <optionalMessage>); — 如果布尔条件为假，则中断正常执行。

dart
// Make sure the variable has a non-null value.
assert(text != null);

// Make sure the value is less than 100.
assert(number < 100);

// Make sure this is an https URL.
assert(urlString.startsWith('https'));

要为断言附加消息，请将一个字符串作为 assert 的第二个参数（可选地带上尾随逗号）

dart
assert(
  urlString.startsWith('https'),
  'URL ($urlString) should start with "https".',
);

assert 的第一个参数可以是任何解析为布尔值的表达式。如果表达式的值为 true，断言成功并继续执行。如果为 false，断言失败并抛出异常（一个 AssertionError）。

断言到底何时起作用？这取决于你使用的工具和框架

在生产代码中，断言会被忽略，并且不会评估 assert 的参数。

除非另有说明，本网站文档反映 Dart 3.8.1。页面最后更新于 2025-05-05。 查看源码 或 报告问题。