Обработка исключений в Dart
Исключение — это событие ошибки, возникающее во время выполнения программы.
Хорошая обработка исключений позволяет программе плавно деградировать при возникновении ошибок, а не падать сразу.
В этой главе рассматриваются try/catch/finally в Dart, выброс исключений с помощью 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 EXAMPLE 异常: 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 验证通过 EXAMPLE 错误: Invalid argument(s): 除数不能为 0
Разница между Exception и Error: Exception — это предсказуемая ошибка, которую программа может обработать (например, тайм-аут сети, файл не найден); Error — это непредсказуемая проблема, которая обычно указывает на ошибку в программе (например, ошибки типов, нулевой указатель). Ваш код должен перехватывать Exception, а не Error.
on: Перехват указанного типа
Ключевое слово on позволяет перехватывать исключения по типу, делая обработку ошибок более детальной.
Пример
// Перехват разных исключений по типу
try {
// Имитация разных типов исключений
int result = performOperation('divide_by_zero');
print(Результат: $result);
} on IntegerDivisionByZeroException {
// Перехватывать только исключение деления на ноль
print(ПРИМЕР ошибки: нельзя делить на ноль);
} on FormatException catch (e) {
// Перехват исключения формата и получение информации об исключении
print('ПРИМЕР ошибки формата: ${e.message}');
} on RangeError {
// Перехватывать только ошибки диапазона
print('EXAMPLE error: index out of range');
} 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('Unknown operation');
}
}
EXAMPLE 错误: 不能除以零 操作结束 --- 测试不同的操作 --- divide_by_zero -> 除零异常 parse_error -> 格式异常 out_of_range -> 范围异常
Порядок on и catch важен: Dart сопоставляет типы исключений сверху вниз. Более конкретные типы исключений должны быть размещены первыми, а более общие — последними. Если catch (e) разместить в начале, последующие on-блоки никогда не будут выполнены.
rethrow: Повторно выбросить исключение
Иногда после перехвата исключения нужно выполнить некоторую обработку (например, логирование), а затем позволить исключению продолжить распространяться вверх.
Ключевое слово rethrow используется для повторного выброса текущего перехваченного исключения с сохранением исходной информации о стеке.
Пример
void databaseOperation() {
print(' Connecting to database...');
throw Exception('EXAMPLE database connection failed');
}
void serviceLayer() {
try {
print(' Service layer: calling database operation');
databaseOperation();
} catch (e) {
// Сначала залогировать, затем пробросить
print(' [Log] исключение при операции с базой данных: $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: EXAMPLE 数据库连接失败 控制器层捕获到异常 错误信息: Exception: EXAMPLE 数据库连接失败 给用户返回: "服务暂时不可用,请稍后重试" --- rethrow vs throw e 的区别 --- 使用 throw e(丢失原始堆栈)... 捕获: FormatException: 原始异常 堆栈指向这里(不是原始位置): ...
Разница между rethrow и throw e имеет решающее значение: rethrow сохраняет полную трассировку стека исходного исключения, что упрощает поиск первопричины; throw e сбрасывает стек и начинает заново с текущей позиции. Когда нужно продолжить распространение исключения после логирования, используйте rethrow.
Лучшие практики обработки исключений
| Практика | Описание |
|---|---|
| Перехватывайте только те исключения, которые вы можете обработать. | Не перехватывайте вслепую все исключения только для того, чтобы «избежать ошибок». Если вы не знаете, как обработать исключение, позвольте ему распространиться вверх. |
| Перехват по типу | ⟦0◧Используйте on, чтобы указать тип исключения, избегая единственного catch, который проглатывает все исключения. |
| ⟦0◧finally: очистка ресурсов | ⟦0◧Такие ресурсы, как файлы и сетевые соединения, должны закрываться в finally. |
| ⟦0◧Не проглатывайте исключения | ⟦0◧Перехватывать исключение и ничего не делать (пустой блок catch) — опасно; как минимум залогируйте его. |
| ⟦0◧Используйте rethrow | ⟦0◧Когда нужно залогировать и продолжить распространение исключения, используйте rethrow вместо throw e. |
| ⟦0◧Сообщения об исключениях должны быть конкретными | ⟦0◧throw Exception('Database connection failed: 192.168.1.1:3306') полезнее, чем throw Exception('An error occurred') |