Как остановить выполнение процедуры в 1С

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

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

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

Оператор Возврат: штатный выход из процедуры

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

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

Процедура ПровестиДокумент(ДокументСсылка)

Если ДокументСсылка.Пустая() Тогда
Возврат; // нечего обрабатывать
КонецЕсли;

Если ДокументСсылка.Проведен Тогда
Возврат; // уже проведён, повторная обработка не нужна
КонецЕсли;

// основная логика проведения
...

КонецПроцедуры

В функциях оператор используется с возвращаемым значением: Возврат Результат;. Если в функции написать просто Возврат; без значения, функция вернёт Неопределено, что часто становится источником ошибок в вызывающем коде.

Прервать и Продолжить: управление циклами

Если нужно остановить не всю процедуру, а только цикл внутри неё, используется оператор Прервать. Он немедленно завершает ближайший вложенный цикл (Для, Для Каждого или Пока), и выполнение продолжается с первого оператора после КонецЦикла.

Для Каждого Строка Из ТаблицаДокументов Цикл
Если Строка.Сумма < 0 Тогда
Прервать; // дальнейшая обработка бессмысленна
КонецЕсли;
ОбработатьСтроку(Строка);
КонецЦикла;

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

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

// Выход из вложенного цикла через функцию
Функция НайтиСтроку(Таблица, ИскомоеЗначение)
	Для Каждого Строка Из Таблица Цикл
		Если Строка.Код = ИскомоеЗначение Тогда
			Возврат Строка; // выходит из функции целиком
		КонецЕсли;
	КонецЦикла;
	Возврат Неопределено;
КонецФункции

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

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

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

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

Остановка выполнения при отладке

Во время отладки остановить выполнение можно в любой момент, не меняя код. В конфигураторе для этого служат кнопка «Остановить» на панели отладки и сочетание клавиш завершения отладки (Shift+F9 в типовой раскладке). Исполнение кода прерывается, отлаживаемый сеанс освобождается.

Если нужно прервать выполнение в конкретной точке, ставится точка останова (F9), либо в код временно добавляется оператор ПрерватьИсполнение — он работает только при включённой отладке и в обычном режиме игнорируется. Это безопасный способ «закладки» даже в коде, который может попасть в рабочую базу: пользователи его не заметят.

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

1. 1
   Переключитесь в конфигуратор, где запущена отладка
2. 2
   Нажмите кнопку «Остановить» на панели отладки или Shift+F9
3. 3
   Дождитесь завершения сеанса отладки
4. 4
   Проверьте, что в списке активных сеансов не осталось фонового процесса отладки
5. 5
   Если сеанс завис — завершите его через консоль кластера

Остановка фоновых заданий и зависших сеансов

Код, запущенный фоновым заданием (обмены, обработки, регламентные операции), нельзя остановить оператором извне — нужны административные инструменты. В клиент-серверном варианте фоновое задание отменяется через консоль кластера: в списке сеансов находится нужный, и выполняется «Завершить сеанс». Также доступен программный метод Отменить() у объекта фонового задания, если у вас есть его уникальный идентификатор.

В файловом варианте фоновое задание выполняется в отдельном процессе или сеансе того же клиента. Остановка возможна завершением соответствующего сеанса через пункт «Администрирование — Активные пользователи» либо закрытием породившего его клиентского приложения.

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

Риски, проверка результата и типичные ошибки

Главный риск при принудительной остановке — прерывание посередине транзакции или длительной записи данных. Завершение сеанса в консоли кластера в момент записи может оставить данные в несогласованном состоянии, а в отдельных случаях — привести к необходимости тестирования и исправления базы. Перед аварийной остановкой проверьте, не выполняет ли сеанс запись: в консоли кластера видно длительность текущего вызова СУБД.

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

Частые вопросы