跨平台开发 / 系统课时
处理异常与失败路径
处理异常与失败路径
异常处理的目标不是“把错误都抓住”,而是让失败沿着可解释的路径流动:当前层能恢复就恢复,需要补充业务语义就转换,无法负责就继续向上传播。本篇用 on、catch、finally 和 rethrow 建立一套可直接套用的处理顺序。
学习目标
- 使用
throw、on、catch和finally组织异常处理与资源清理 - 判断异常应该在当前层恢复、转换为更合适的异常,还是继续传播
- 使用
rethrow保留原异常语义并交给上层处理
先把正常路径和失败路径分开
Dart 使用 throw 抛出异常。try 中代码正常完成时继续执行后续逻辑;一旦抛出异常,会寻找第一个匹配的处理分支。on SomeException 用于按异常类型筛选,catch (e, st) 用于取得异常对象和可选堆栈信息。
下面的可运行示例把“端口解析失败”当作可在当前层处理的输入问题,并让 finally 无论成功或失败都执行清理逻辑。
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');
}预期输出
start:8080
cleanup
invalid:port must be an integer from 1 to 65535
cleanupfinally 适合关闭文件、释放锁、撤销临时状态等必须执行的清理动作,但不要把“业务成功”逻辑放进去,因为它在异常路径上同样会运行。
按责任决定恢复、转换或传播
处理异常前先问“这一层是否知道怎样正确继续”。如果答案是肯定的,例如用户输入可以重新提示,就在当前层捕获并恢复。如果只能补充上下文,而真正决策应由更高层完成,可以转换为更贴近当前领域的异常。
片段示例:下面代码依赖上文的 parsePort,它把底层格式错误转换为配置错误,供更高层统一处理。
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。
int parseAndReport(String raw) {
try {
return parsePort(raw);
} on FormatException catch (e) {
print('parse failed: ${e.message}');
rethrow;
}
}与“捕获后什么都不做”相比,rethrow 不会把失败伪装成成功。只有当调用方明确接受某个回退值时,才应该在 catch 中返回默认值。

用固定顺序检查异常代码
阅读或编写异常处理代码时,可以按“异常类型是否足够具体 → 当前层是否真的能恢复 → 是否需要转换语义 → 清理是否放在 finally → 无法处理时是否继续传播”的顺序检查。
异常边界应与责任边界一致:谁能决定下一步,谁就处理;谁只能补充上下文,就转换或记录后继续传播。这样正常路径保持简洁,失败也不会在中间层被静默丢失。