Отладка на сервере 1С 8.3: как подключить debug по HTTP

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

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

Ниже разобран полный цикл: включение отладки на сервере, выбор протокола HTTP, подключение предметов отладки в конфигураторе, проверка результата и типичные ошибки. Инструкции применимы к серверу 1С под Windows и Linux с незначительными отличиями в способе указания параметров.

Какие режимы отладки существуют в платформе 8.3

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

HTTP-отладка работает через сервер отладки (dbgs), который запускается в составе кластера. Конфигуратор обращается к нему по единому адресу, а сервер отладки уже маршрутизирует команды к нужным рабочим процессам. Такой подход совместим с публикацией базы на веб-сервере и удобен для отладки веб-сервисов, HTTP-сервисов и фоновых заданий.

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

Включение отладки на сервере под Windows

На Windows-сервере параметры запуска агента сервера 1С хранятся в реестре, в параметре службы. Стандартный путь — ветка HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services, подраздел службы агента сервера 1С конкретной версии (имя обычно содержит номер версии платформы, например «1C:Enterprise 8.3 Server Agent»).

Найдите параметр ImagePath и дополните строку запуска ключами -debug -http. Фрагмент строки будет выглядеть примерно так: ...ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -debug -http. Важно не удалить существующие параметры и не нарушить кавычки вокруг пути к исполняемому файлу.

1. 1
   Откройте редактор реестра и найдите раздел службы агента сервера 1С нужной версии.
2. 2
   В параметре ImagePath добавьте в строку запуска ключи -debug -http.
3. 3
   Перезапустите службу агента сервера 1С через оснастку services.msc.
4. 4
   Убедитесь, что служба запустилась без ошибок и кластер доступен.
5. 5
   Проверьте в консоли кластера, что сервер отладки активен.

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

Включение отладки на сервере под Linux

На Linux параметры запуска агента задаются в скрипте или unit-файле службы. В зависимости от способа установки это может быть файл /etc/sysconfig/1c-enterprise (в нём задаётся переменная с параметрами запуска) или секция ExecStart в systemd-юните. Точное расположение зависит от дистрибутива и способа установки платформы.

Добавьте к параметрам запуска -debug -http и перезапустите службу командой вида systemctl restart srv1cv83 (имя службы может отличаться). После перезапуска полезно проверить список процессов и убедиться, что ragent запущен с новыми параметрами — это видно в выводе ps aux | grep ragent.

ps aux | grep ragent   # проверить, что в строке запуска есть -debug -http

Если служба не стартует после правки, проверьте синтаксис строки запуска: лишний пробел внутри пути, потерянная кавычка или опечатка в имени ключа приводят к аварийному завершению агента сразу после старта. Журнал ошибок смотрите через journalctl -u имя_службы или в технологическом журнале платформы, если он настроен.

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

На стороне разработчика откройте конфигуратор и перейдите в меню «Сервис → Параметры». На вкладке, отвечающей за отладку, установите протокол отладки «HTTP». Там же указывается адрес сервера отладки — обычно это имя или IP-адрес сервера 1С, порт сервера отладки по умолчанию 1550.

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

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

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

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

Дополнительный признак корректной работы — наличие процесса сервера отладки (dbgs) среди процессов кластера. Его отсутствие означает, что HTTP-отладка не активирована, даже если ключ -debug присутствует: без ключа -http сервер отладки работает в режиме TCP.

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

Типичные ошибки и ограничения

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

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

FAQ