Как подключить отладку на сервере 1С 8.3

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

Подключение отладки сводится к запуску агента сервера с параметром -debug и выбору протокола отладки — TCP или HTTP. Для файловых баз действует отдельный, более простой механизм. Ниже разобраны оба сценария, настройка конфигуратора, подключение к серверным вызовам и типичные проблемы.

Когда нужна серверная отладка и какие есть варианты

Клиент-серверный режим разделяет исполнение кода: управляемые формы и клиентские процедуры работают на компьютере пользователя, а обращения к данным, запросы и бизнес-логика — на сервере 1С. Отладчик конфигуратора по умолчанию подключается только к клиентскому процессу, поэтому серверные процедуры остаются «невидимыми».

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

Включение отладки через параметр -debug в службе агента

Основной способ — добавить ключ -debug в параметры запуска службы «Агент сервера 1С:Предприятия». Откройте оснастку «Службы» (services.msc), найдите службу агента нужной версии платформы и остановите её. Затем откройте реестр и перейдите к разделу HKLM\SYSTEM\CurrentControlSet\Services\1C:Enterprise 8.3 Server Agent (имя может отличаться в зависимости от разрядности и порта).

В параметре ImagePath находится полная строка запуска. Добавьте в неё ключ -debug, а при использовании отладки по HTTP — также -http. Пример итоговой строки:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo" -debug -http

Сохраните изменения и запустите службу. Альтернатива правке реестра — команда sc config с параметром binPath, но при ошибке в строке служба может не запуститься, поэтому перед изменением сохраните исходное значение ImagePath.

Выбор протокола отладки: TCP или HTTP

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

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

Настройка конфигуратора для подключения к серверу

После перезапуска агента откройте конфигуратор и перейдите в «Сервис → Параметры → Отладка». Установите нужный протокол, убедитесь, что сервер отладки определяется автоматически или укажите имя сервера вручную. Для HTTP-отладки дополнительно проверьте адрес сервера отладки.

Затем откройте «Отладка → Подключение» и настройте автоматическое подключение. Включите флажки для типов предметов отладки, которые нужно перехватывать: «Сервер», «Фоновое задание», «HTTP-сервис», «Веб-сервис». Без этих флажков отладчик подключится только к клиентскому сеансу, и серверные точки останова не сработают.

1. 1
   Остановите службу агента сервера 1С и сохраните текущую строку запуска
2. 2
   Добавьте в ImagePath ключи -debug и -http, запустите службу
3. 3
   В конфигураторе выберите протокол отладки (TCP или HTTP)
4. 4
   В окне «Подключение» включите автоматическое подключение к серверным вызовам и фоновым заданиям
5. 5
   Запустите отладку, поставьте точку останова в серверном модуле и выполните действие в базе

Отладка фоновых заданий, веб-сервисов и файловых баз

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

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

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

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

Признак успешной настройки — в окне «Отладка → Подключение» появляются серверные предметы отладки, а выполнение кода останавливается на точке останова в серверном модуле. Если точка останова отображается с признаком недоступности (пустой кружок), отладчик не подключился к серверному процессу.

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

Часто задаваемые вопросы