Dart 例外処理
例外とは、プログラムの実行中に発生するエラーイベントです。
適切な例外処理により、プログラムはエラーに遭遇した際に直接クラッシュするのではなく、優雅に機能を低下させることができます。
この章では、Dart の try/catch/finally、throw による例外スロー、on による指定型のキャッチ、rethrow による再スローを紹介します。
try / catch / finally の基本
try ブロックには例外をスローする可能性のあるコードを置き、catch ブロックは例外をキャッチして処理し、finally ブロックは例外の有無にかかわらず実行されます。
例
// 基本的な try-catch
try {
int result = 10 ~/ 0; // ゼロ除算は例外をスローする
print('結果: $result'); // この行は実行されない
} catch (e) {
// e は例外オブジェクト
print('例外をキャッチ: $e');
}
// 例外とスタック情報を取得する
try {
List<int> numbers = [1, 2, 3];
print(numbers[10]); // 範囲外インデックスにアクセス
} catch (e, stackTrace) {
// e は例外、stackTrace はコールスタック
print('サンプル 例外: $e');
print('スタック情報:\n$stackTrace');
}
// finally: 例外の有無にかかわらず実行される
try {
print('操作を実行しています...');
int result = 5 ~/ 0;
print('この行は実行されません: $result');
} catch (e) {
print('エラー: $e');
} finally {
// finally ブロックのコードは常に実行され、リソースのクリーンアップに使用される
print('リソースのクリーンアップ完了(finally は常に実行される)');
}
}
捕获到异常: IntegerDivisionByZeroException サンプル 异常: RangeError (index): Invalid value: Not in inclusive range 0..2: 10 堆栈信息: #0 List.[] (dart:core-patch/growable_array.dart:264) #1 main (file:///...) ... 尝试执行操作... 出错: IntegerDivisionByZeroException 清理资源完成(finally 总是执行)
finally ブロックはリソースのクリーンアップに最適です。ファイルのクローズやデータベース接続の解放などに使用します。try または catch 内に return 文がある場合でも、finally は必ず実行されます。
throw で例外をスローする
throw キーワードを使用すると、能動的に例外をスローできます。
Dart では例外として任意のオブジェクトをスローできます(Exception のサブクラスだけでなく)。ただし、ベストプラクティスは Exception または Error のサブクラスをスローすることです。
例
class InvalidAgeException implements Exception {
final int age;
final String message;
InvalidAgeException(this.age)
: message = '無効な年齢: $age(年齢は0から150の間である必要があります)';
@override
String toString() => 'InvalidAgeException: $message';
}
// カスタム例外を使用する関数
void validateAge(int age) {
if (age < 0) {
throw InvalidAgeException(age);
}
if (age > 150) {
throw InvalidAgeException(age);
}
print('年齢 $age は検証に合格しました');
}
// 組み込み例外をスローする
int divide(int a, int b) {
if (b == 0) {
throw ArgumentError('除数は0にできません'); // 組み込み例外を使用する
}
return a ~/ b;
}
void main() {
// カスタム例外をテストする
try {
validateAge(-5);
} catch (e) {
print(e);
}
try {
validateAge(200);
} catch (e) {
print(e);
}
validateAge(25); // 正常なケース
// 組み込み例外のスローをテストする
try {
divide(10, 0);
} catch (e) {
print('サンプル エラー: $e');
}
}
InvalidAgeException: 无效的年龄: -5(年龄必须在 0 到 150 之间) InvalidAgeException: 无效的年龄: 200(年龄必须在 0 到 150 之间) 年龄 25 验证通过 サンプル 错误: Invalid argument(s): 除数不能为 0
Exception と Error の違い: Exception は予測可能で、プログラムが処理できるエラーです(例: ネットワークタイムアウト、ファイルが存在しない)。Error は予測不可能で、通常はプログラムのバグを示す問題です(例: 型エラー、ヌルポインタ)。コードでは Error ではなく Exception をキャッチすべきです。
on で指定型をキャッチする
on キーワードを使うと、例外の型ごとにキャッチでき、エラー処理をより細かく行えます。
例
// 型に応じて異なる例外をキャッチする
try {
// 異なるタイプの例外をシミュレートする
int result = performOperation('divide_by_zero');
print('結果: $result');
} on IntegerDivisionByZeroException {
// ゼロ除算例外のみキャッチする
print('サンプル エラー: ゼロで割れません');
} on FormatException catch (e) {
// フォーマット例外をキャッチし、同時に例外情報を取得する
print('サンプル フォーマットエラー: ${e.message}');
} on RangeError {
// 範囲エラーのみキャッチする
print('サンプル エラー: インデックスが範囲外');
} catch (e) {
// フォールバック: その他のすべての例外をキャッチする
print('未知のエラー: $e');
} finally {
print('操作終了\n');
}
// 順番にマッチングする例
print('--- 異なる操作をテスト ---');
for (var op in ['divide_by_zero', 'parse_error', 'out_of_range', 'normal']) {
try {
performOperation(op);
} on IntegerDivisionByZeroException {
print('$op -> ゼロ除算例外');
} on FormatException {
print('$op -> フォーマット例外');
} on RangeError {
print('$op -> 範囲例外');
} catch (e) {
print('$op -> その他の例外: $e');
}
}
}
int performOperation(String operation) {
switch (operation) {
case 'divide_by_zero':
return 10 ~/ 0; // IntegerDivisionByZeroException をスローする
case 'parse_error':
int.parse('not_a_number'); // FormatException をスローする
return 0;
case 'out_of_range':
var list = [1, 2, 3];
return list[100]; // RangeError をスローする
case 'normal':
return 42;
default:
throw Exception('未知の操作');
}
}
サンプル 错误: 不能除以零 操作结束 --- 测试不同的操作 --- divide_by_zero -> 除零异常 parse_error -> 格式异常 out_of_range -> 范围异常
on と catch の並び順は重要です。Dart は上から下の順に例外型をマッチングします。より具体的な例外型は前に、より汎用的なものは後ろに置く必要があります。catch (e) を一番前に置くと、後ろの on は決して実行されません。
rethrow で再スローする
例外をキャッチした後に何らかの処理(例: ログ記録)を行い、その後で例外を上位へ伝播させ続けたい場合があります。
rethrow キーワードは、現在キャッチした例外を再スローし、元のスタック情報を保持するために使います。
例
void databaseOperation() {
print(' データベースに接続しています...');
throw Exception('サンプル データベース接続失敗');
}
void serviceLayer() {
try {
print(' サービス層: データベース操作を呼び出し');
databaseOperation();
} catch (e) {
// 最初にログを記録し、その後再スローする
print(' [ログ] データベース操作例外: $e');
rethrow; // 元の例外とスタックを保持し、上位へ伝播し続ける
}
}
void controllerLayer() {
try {
print('コントローラー層: リクエストを処理');
serviceLayer();
} catch (e, stackTrace) {
// 最外層でキャッチして処理する
print('コントローラー層が例外をキャッチ');
print('エラー情報: $e');
print('ユーザーに返す: "サービスは一時的に利用できません。後でもう一度お試しください"');
}
}
void main() {
controllerLayer();
print('\n'--- rethrow と throw e の違い ---');
// rethrow と throw e の違いをデモする
try {
try {
throw FormatException('元の例外');
} catch (e) {
// throw e: スタック情報がリセットされ、元の呼び出し位置が失われる
print('throw e を使用(元のスタックが失われる)...');
throw e; // スタックはここから始まる
}
} catch (e, stack) {
print('キャッチ: $e');
print('スタックはここを指す(元の位置ではない):\n$stack');
}
}
控制器层: 处理请求 服务层: 调用数据库操作 正在连接数据库... [日志] 数据库操作异常: Exception: サンプル 数据库连接失败 控制器层捕获到异常 错误信息: Exception: サンプル 数据库连接失败 给用户返回: "服务暂时不可用,请稍后重试" --- rethrow vs throw e 的区别 --- 使用 throw e(丢失原始堆栈)... 捕获: FormatException: 原始异常 堆栈指向这里(不是原始位置): ...
rethrow と throw e の違いは非常に重要です。rethrow は元の例外のすべてのスタック情報を保持し、問題の根本を特定しやすくします。throw e はスタックをリセットし、現在の位置から再開します。ログ記録後に例外を伝播させ続ける必要がある場合は、rethrow を使用してください。
例外処理のベストプラクティス
| 実践 | 説明 |
|---|---|
| 処理できる例外のみキャッチする | 「エラーを出さない」ためだけに盲目的にすべての例外を catch しないでください。処理方法がわからない場合は、上位に伝播させましょう |
| 型ごとにキャッチする | on で例外型を指定し、1つの catch で全例外を飲み込まないようにする |
| finally でリソースをクリーンアップ | ファイルやネットワーク接続などのリソースは finally でクローズする |
| 例外を飲み込まない | 例外をキャッチしたのに何もしない(空の catch ブロック)のは危険です。少なくともログを記録しましょう |
| rethrow を使用する | ログ記録後に例外を伝播させ続ける必要がある場合は、throw e ではなく rethrow を使う |
| 例外メッセージは具体的に | throw Exception('データベース接続失敗: 192.168.1.1:3306') は throw Exception('エラーが発生しました') よりも有用です |