Dart 和 Flutter 错误处理指南 | 最佳实践全解析
视频
https://www.bilibili.com/video/BV1gx4y1z7p2/
前言
原文 https://ducafecat.com/blog/flutter-and-dart-error-handling-guide
深入探索 Dart 和 Flutter 中的错误处理技术，从编译时错误到运行时异常，带你学习如何优雅地处理应用程序中的各种意外情况。了解最佳实践，让你的应用程序稳如磐石，用户体验持续优化！
Dart, Flutter, 错误处理, 异常, try-catch, 最佳实践, 编译时错误, 运行时错误, 异步操作, 异常捕获, 优雅处理
参考
https://dart.dev/language/error-handling
https://docs.flutter.dev/cookbook
https://docs.sentry.io/platforms/flutter/
*重要: 记录错误日志
先说最重要的，把你的错误记录下来先。
sentry 支持私有化部署，开发版可免费使用。
https://docs.sentry.io/platforms/flutter/
集成代码
import 'package:flutter/widgets.dart';
import 'package:sentry_flutter/sentry_flutter.dart';
Future<void> main() async {
await SentryFlutter.init(
(options) {
options.dsn = 'https://examplePublicKey@o0.ingest.sentry.io/0';
// Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
// We recommend adjusting this value in production.
options.tracesSampleRate = 1.0;
},
appRunner: () => runApp(MyApp()),
);
// or define SENTRY_DSN via Dart environment variable (--dart-define)
}
理解 Dart 中的错误
在我们深入研究错误处理策略之前，先来了解一下 Dart 应用程序中可能会遇到的几种错误类型：
- 编译时错误：这类错误在代码编译阶段就出现，直接阻止了代码执行。举个例子，就是那些语法错误和类型错误。
- 运行时错误：这些错误是在程序运行时才冒出来的。比如，空指针异常、除零错误以及越界异常都是运行时错误的常客。
- 异常：Dart 使用异常来处理运行时错误和程序异常情况。异常可以通过
throw关键字明确地抛出，也可以通过内置函数和方法暗地里抛出。
Dart 中的错误处理技术
在 Dart 的世界里，有几种处理错误的技术，每一种都有其特定的应用场景和目的：
try-catch 块
try-catch 块就像是一个捕网，用来捕获和处理其范围内的异常。看这个示例，如果在 try 块里有异常抛出，它就会被 catch 块给“捉”住并处理掉。
try {
// 可能会抛出异常的代码
throw Exception('An error occurred');
} catch (e) {
print('Caught exception: $e');
}
on 子句
Dart 的 on 子句允许你捕获特定类型的异常，这在处理不同的错误场景时非常有用。在这个例子里，第一个 catch 块捕获类型为 Exception 的异常，而第二个 catch 块则捕获其他类型的异常。
try {
// 可能会抛出异常的代码
} on Exception catch (e) {
print('Exception caught: $e');
} catch (e) {
print('Unknown error: $e');
}
finally 最终块
finally 块像一位“后勤保障”，无论发生什么异常，它总是会执行。这对于做一些清理工作非常有用，比如关闭文件或者释放资源。无论异常与否，finally 块中的代码都会被执行。
try {
// 可能会抛出异常的代码
} catch (e) {
print('Exception caught: $e');
} finally {
print('Cleanup tasks');
}
throw 抛出关键字
Dart 的 throw 关键字用来明确地抛出异常。这让开发人员可以处理异常情况，并在代码中发出错误信号。在下面这个例子中，如果 amount 参数小于等于零，就会抛出 ArgumentError 异常。
void depositMoney(double amount) {
if (amount <= 0) {
throw ArgumentError('Amount must be greater than zero');
}
// 存款逻辑
}
Flutter 中的错误处理
在 Flutter 中，错误处理通常涉及到处理异步操作，比如网络请求和文件 I/O。Flutter 提供了一些有效处理异步代码中错误的机制：
Future 错误处理
处理 Future 对象时，你可以使用 then() 方法来处理成功的结果，使用 catchError() 方法来处理错误。
fetchUserData().then((data) {
// 处理成功的结果
}).catchError((error) {
// 处理错误
print('Error fetching user data: $error');
});
async 异步 / await 等待
Dart 的 async 和 await 关键字提供了一种更易读的方式来处理异步代码。你可以在 async 函数中使用 try-catch 块来优雅地处理错误。
Future<void> fetchData() async {
try {
// 可能会抛出异常的异步代码
var data = await fetchDataFromServer();
// 处理数据
} catch (e) {
// 处理错误
print('Error fetching data: $e');
}
}
stream 流错误处理
在处理流时，你可以使用 listen() 方法来分别处理数据和错误。
stream.listen(
(data) {
// 处理数据
},
onError: (error) {
// 处理错误
print('Error in stream: $error');
},
onDone: () {
// 流关闭
},
);
全局错误处理
当在 Flutter 应用程序中发生错误时，可以使用 FlutterError.onError 方法来定义一个全局的错误处理函数。以下是一个示例：
import 'package:flutter/material.dart';
void main() {
FlutterError.onError = (FlutterErrorDetails details) {
// 在此处处理错误，例如将错误日志发送到远程服务器或显示错误信息给用户
print('Flutter Error: ${details.exception}');
print('Stack trace:\n${details.stack}');
};
// FlutterError.onError 方法应在应用程序的入口点调用（例如 main 函数），以确保它在应用程序运行之前被设置。
runApp(MyApp());
}
class MyApp extends StatelessWidget {
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Error Handling',
home: MyHomePage(),
);
}
}
class MyHomePage extends StatelessWidget {
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Flutter Error Handling'),
),
body: Center(
child: RaisedButton(
child: Text('Trigger Error'),
onPressed: () {
// 模拟触发错误的场景
throw Exception('This is a sample error.');
},
),
),
);
}
}
错误处理建议
想要确保在 Dart 和 Flutter 应用程序中进行有效的错误处理？那就得遵循以下最佳实践：
- 尽早失败：最好在错误产生的地方就处理掉它们，这样可以防止它们在程序中蔓延。
- 使用特定的异常：抛出异常时，最好使用能准确表示错误条件的特定异常类型。
- 提供有意义的错误消息：错误消息应该能够帮助开发者快速诊断和解决问题。
- 优雅处理错误：尽量避免让应用程序崩溃。给用户一个信息丰富的错误提示，同时记录详细的错误信息以便后续排查。
- 日志记录：在应用程序中添加适当的日志记录，这有助于跟踪错误发生的上下文，并且可以在排查问题时提供有用的信息。
- 测试错误情况：编写针对可能出现错误情况的测试用例，以确保你的错误处理机制能够按预期工作。
小结
在软件开发中，错误处理是至关重要的一环。无论是在 Dart 还是 Flutter 中，有效地处理错误可以提高应用程序的稳定性和用户体验。通过理解不同类型的错误、掌握错误处理技术以及遵循最佳实践，你可以让你的应用程序在面对意外情况时表现得像一位优雅的舞者，从容不迫地应对挑战。愿你的代码永远自由于错误，愿你的用户永远享受到流畅无缺的体验！
感谢阅读本文
如果有什么建议，请在评论中让我知道。我很乐意改进。
flutter 学习路径
- Flutter 优秀插件推荐 https://flutter.ducafecat.com
- Flutter 基础篇1 - Dart 语言学习 https://ducafecat.com/course/dart-learn
- Flutter 基础篇2 - 快速上手 https://ducafecat.com/course/flutter-quickstart-learn
- Flutter 实战1 - Getx Woo 电商APP https://ducafecat.com/course/flutter-woo
- Flutter 实战2 - 上架指南 Apple Store、Google Play https://ducafecat.com/course/flutter-upload-apple-google
- Flutter 基础篇3 - 仿微信朋友圈 https://ducafecat.com/course/flutter-wechat
- Flutter 实战3 - 腾讯 tim 即时通讯开发 https://ducafecat.com/course/flutter-tim
? 猫哥
ducafecat.com
end
