Как отладить фоновое задание в 1С

Фоновое задание в 1С выполняется в отдельном сеансе на сервере, поэтому обычная точка останова в конфигураторе на него не срабатывает. Разработчик ставит точку останова в общем модуле, запускает отладку — а код фонового задания проходит мимо. Это стандартная ситуация: по умолчанию отладчик подключён только к интерактивному сеансу, и фоновые процессы нужно подключать к отладке отдельно.

Существует несколько рабочих способов: включить автоматическое подключение фоновых заданий в настройках отладки, принудительно запустить задание из консоли кода с отладкой, подключиться к уже работающему фоновому сеансу через список активных сеансов или временно заменить фоновое выполнение синхронным вызовом. Выбор зависит от режима работы базы (файловая или клиент-серверная) и от того, запускаете вы задание сами или оно стартует по расписанию.

Почему точка останова не срабатывает в фоновом задании

Когда вы запускаете отладку в конфигураторе, отладчик подключается к конкретному сеансу — тому, в котором работаете вы. Фоновое задание создаёт новый сеанс на сервере (или в отдельном потоке для файловой базы), и этот сеанс не связан с вашим отладочным. Платформа просто не знает, что его нужно останавливать.

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

Подготовка: включение серверной отладки

Для клиент-серверной базы сервер 1С должен быть запущен в режиме отладки. Это параметр -debug в строке запуска агента сервера (для Windows — в параметрах службы «Агент сервера 1С:Предприятия», для Linux — в скрипте запуска srv1cv8). Без этого флага сервер не принимает подключения отладчика вовсе, и никакие настройки конфигуратора не помогут.

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

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

Способ 1: автоматическое подключение фоновых заданий

Основной способ — настроить конфигуратор так, чтобы он сам подхватывал фоновые сеансы. Откройте меню «Отладка → Автоматическое подключение» и установите флажки напротив «Фоновые задания» (и при необходимости — «HTTP-сервисы», «Веб-сервисы»). После этого любой фоновый процесс, запущенный после включения настройки, попадёт под отладчик.

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

1. 1
   Убедитесь, что сервер запущен с параметром -debug (для клиент-серверной базы)
2. 2
   В конфигураторе откройте Отладка → Автоматическое подключение и отметьте «Фоновые задания»
3. 3
   Запустите отладку (F5) и поставьте точку останова в коде общего модуля
4. 4
   Запустите фоновое задание из режима предприятия
5. 5
   Дождитесь остановки на точке и пройдите код по шагам (F10/F11)
6. 6
   Проверьте результат: состояние задания и данные, которые оно должно было изменить

Способ 2: подключение к уже работающему фоновому сеансу

Если задание выполняется долго и уже запущено, перезапускать его не обязательно. Откройте «Отладка → Подключение» — конфигуратор покажет список доступных предметов отладки. Найдите среди них сеанс с типом «Фоновое задание» (можно сориентироваться по имени задания и времени начала) и подключитесь кнопкой «Подключить».

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

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

Способ 3: замена фонового вызова на синхронный

Для файловой базы или тестовой копии часто быстрее всего временно обойтись без фонового задания. Вместо ФоновыеЗадания.Выполнить("МойМодуль.МояПроцедура", Параметры) вызовите процедуру напрямую: МойМодуль.МояПроцедура(Параметр1). Код выполнится в вашем сеансе, и обычная точка останова сработает сразу.

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

// Вместо фонового запуска временно вызываем напрямую для отладки:
// ФоновыеЗадания.Выполнить("ОбменДанными.ВыполнитьЗагрузку", Параметры);
ОбменДанными.ВыполнитьЗагрузку(Параметры[0]);

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

Отладка регламентных заданий по расписанию

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

В файловой базе регламентные задания выполняются только при запущенном сеансе, выполняющем обработку заданий (параметр запуска /ExecuteScheduledJobs или отдельно запущенное предприятие). Если задание в файловой базе «не стартует» — сначала проверьте, есть ли процесс, который его обслуживает.

Диагностика через журнал регистрации и состояние задания

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

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

Типичные ошибки при отладке фоновых заданий

Чаще всего разработчик забывает включить автоматическое подключение и ждёт остановки, которая никогда не произойдёт. Вторая по частоте причина — сервер без флага -debug: в этом случае не работает ни автоматическое подключение, ни ручное. Третья — точка останова стоит в клиентском коде, а проблемный код выполняется в серверной процедуре общего модуля.

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

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