1C-Code → Основы 1С → Ошибки и исключения

Ошибки и исключения

Попытка, Исключение, ВызватьИсключение. Когда ловить ошибку, когда дать ей упасть и почему пустой блок Исключение — худшее, что можно написать.

Глава 35 из 36 · чтение примерно 24 минут

Код падает. Файла нет, сервис не ответил, в строке вместо числа буквы. Вопрос не в том, как этого избежать, — избежать нельзя, — а в том, что делать, когда случилось.

Как это выглядит

Попытка
	Число = Число(Строка);
Исключение
	ЗаписьЖурналаРегистрации("Загрузка", УровеньЖурналаРегистрации.Ошибка,,, ОписаниеОшибки());
	Число = 0;
КонецПопытки;

Когда ловить, а когда не ловить

Ловят там, где знают, что делать. Не ответил сервис — записать в журнал и попробовать позже. Не разобралась строка — пропустить эту строку файла и продолжить с остальными.

Не ловят там, где продолжать нельзя. Если без этих данных дальнейшая работа бессмысленна, ошибка должна упасть: упавшая операция честнее операции, сделанной наполовину.

Особенно это верно при проведении: там падение откатывает транзакцию целиком, и это правильное поведение.

Своё исключение

ВызватьИсключение "Не заполнен склад" — способ прервать работу со своим текстом.

Текст пишут для того, кто будет разбираться, а не для машины. «Ошибка» — плохой текст. «Не удалось загрузить прайс: в строке 42 вместо цены текст» — хороший: по нему сразу видно, что чинить.

Внутри блока Исключение можно перебросить ошибку дальше — ВызватьИсключение без параметров. Так делают, когда надо записать в журнал, но обработать всё же не здесь.

Что происходит, когда код падает

Исключение не останавливает программу на месте. Оно выбрасывает выполнение вверх по цепочке вызовов, пока не найдёт ближайшую Попытку.

Это важнее, чем кажется. Ошибка, случившаяся глубоко внутри — в функции, которую вызвала функция, которую вызвали вы, — прилетит в ваш блок Исключение. Всё, что было между, не доработает: строки после упавшего вызова не выполнятся ни в одной из этих функций.

Куда попадёт ошибка

Процедура Загрузить()
	Попытка
		РазобратьФайл();      // <- падает где-то внутри
		Сообщить("Готово");   // <- НЕ выполнится
	Исключение
		Сообщить("Не загрузилось");
	КонецПопытки;
КонецПроцедуры

Транзакции: место, где это важнее всего

Транзакция — «или всё, или ничего»: несколько записей в базу, которые должны применяться вместе. Проведение документа, групповая обработка, загрузка.

Пара НачатьТранзакцию — ЗафиксироватьТранзакцию обязана сойтись. Если между ними упало, а фиксация не выполнилась — транзакция остаётся открытой, и дальше ломается уже всё подряд. Поэтому транзакцию всегда пишут вместе с Попыткой.

Каркас, который пишут всегда одинаково

НачатьТранзакцию();
Попытка
	ЗаписатьВсёЧтоНадо();
	ЗафиксироватьТранзакцию();
Исключение
	ОтменитьТранзакцию();
	ЗаписьЖурналаРегистрации("Загрузка",
		УровеньЖурналаРегистрации.Ошибка, , , ОписаниеОшибки());
	ВызватьИсключение;
КонецПопытки;

Поймать можно всё, разобрать — почти ничего

Исключение ловит любую ошибку: и деление на ноль, и отсутствующий файл, и обрыв связи. Отдельных блоков по видам ошибок, как в других языках, в 1С нет.

Из этого следует неприятное: узнать, что именно случилось, почти невозможно. Есть текст ошибки — и разбирать его поиском подстроки очень плохая идея: текст зависит от версии платформы и от языка интерфейса, и такая проверка однажды перестаёт работать молча.

Что делают вместо этого: оборачивают в Попытку ровно ту строку, ошибка которой ожидается. Тогда вид ошибки известен заранее — по тому, что внутри блока, — и разбирать текст не нужно.

Не падать на первой строке — и не молчать

Пустой Исключение в упражнении выше — компромисс: мы посчитали удачные, но не сказали, что сломалось. В настоящей загрузке так нельзя: человек должен узнать, какие строки файла не прошли.

Правильная схема — копить ошибки, а не падать и не молчать: пройти всё до конца, собрать список проблемных строк и показать его одним сообщением. Одно понятное сообщение про пятнадцать строк лучше, чем пятнадцать всплывающих окон или одно «не удалось».

Отказ вместо исключения

Есть места, где ВызватьИсключение — неправильный инструмент, хотя и работает. Это обработчики событий: ПередЗаписью, ОбработкаПроведения, ОбработкаЗаполнения.

У них есть параметр Отказ. Поставить Отказ = Истина — значит сказать платформе «эту операцию делать не надо». Платформа сама откатит транзакцию, сама вернёт форму в рабочее состояние и сама покажет накопленные сообщения.

Исключение в том же месте сделает то же самое грубее: человек увидит техническое окно вместо понятного сообщения у поля.

Процедура ОбработкаПроведения(Отказ, Режим)
	Если Не ЗначениеЗаполнено(Склад) Тогда
		ВызватьИсключение "Не заполнен склад";
	КонецЕсли;
КонецПроцедуры

Процедура ОбработкаПроведения(Отказ, Режим)
	Если Не ЗначениеЗаполнено(Склад) Тогда
		Сообщение = Новый СообщениеПользователю;
		Сообщение.Текст = "Не заполнен склад";
		Сообщение.Поле = "Склад";
		Сообщение.Сообщить();
		Отказ = Истина;
	КонецЕсли;
КонецПроцедуры

Короткий свод

Ловят там, где знают, что делать; не ловят там, где продолжать нельзя. Пустой блок Исключение — способ спрятать поломку и встретить её позже в другом месте. Оборачивают минимальный кусок, а не весь код. Человеку — понятный текст, в журнал — ОписаниеОшибки(). Там, где можно проверить заранее, проверяют, а не ловят.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

← Таблица значений
→ Отладка: как искать причину