Как прописать debug на сервере 1С 8.3

Отладка серверного кода в 1С 8.3 не работает «из коробки»: по умолчанию кластер серверов запускается без поддержки отладки, и конфигуратор не может подключиться к серверным процедурам. Чтобы точки останова в серверных модулях начали срабатывать, нужно запустить агент сервера с ключом -debug и правильно настроить предметы отладки в конфигураторе.

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

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

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

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

Механизм отладки строится на взаимодействии трёх компонентов: конфигуратора (отладчика), агента сервера (ragent) и рабочих процессов кластера (rphost), в которых исполняется код. Ключ -debug указывает агенту принимать подключения отладчика и передавать управление рабочим процессам. Без этого ключа агент просто игнорирует запросы на отладку.

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

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

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

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

Включение отладки через службу Windows

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

Откройте редактор реестра и перейдите в ветку HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services. Найдите подраздел службы агента сервера — его имя содержит версию платформы, например 1C:Enterprise 8.3 Server Agent с номером версии и портом. В параметре ImagePath хранится полная строка запуска ragent.exe.

Добавьте в конец строки запуска ключ -debug. Для протокола HTTP дополнительно укажите -debug -http (в ряде версий платформы HTTP-отладка на сервере включается именно так). Сохраните изменение, затем перезапустите службу: через оснастку «Службы» или командой net stop / net start с именем службы.

1. 1
   Остановите службу агента сервера 1С через оснастку services.msc
2. 2
   Откройте реестр и найдите ветку службы агента в HKLM\SYSTEM\CurrentControlSet\Services
3. 3
   В параметре ImagePath добавьте в конец строки запуска ключ -debug (для HTTP-отладки — также флаг протокола HTTP)
4. 4
   Сохраните изменения и запустите службу заново
5. 5
   В конфигураторе выберите протокол отладки и включите предметы отладки
6. 6
   Проверьте подключение: запустите отладку и убедитесь, что серверные точки останова активны

Обратите внимание на кавычки в ImagePath: путь к ragent.exe заключён в кавычки, а ключи идут после закрывающей кавычки. Не нарушайте структуру строки — при ошибке служба просто не запустится.

Включение отладки на Linux и при запуске из командной строки

На Linux-сервере агент обычно запускается через systemd-юнит или скрипт. Параметры запуска задаются в файле юнита (директива ExecStart) или в переменных окружения, которые подхватывает скрипт запуска. Добавьте -debug в строку запуска ragent и перезапустите юнит: systemctl restart с именем службы агента.

Если сервер запускается вручную из командной строки (что типично для тестовых стендов), достаточно добавить ключ в команду запуска:

/opt/1cv8/x86_64/current/ragent -debug

Для тестового контура удобно держать отдельный скрипт запуска с отладкой, чтобы не менять основной. При ручном запуске помните, что процесс привязан к сессии — при закрытии терминала агент остановится, если не использовать nohup или screen.

systemctl edit srv1cv8 --full  # добавить -debug в ExecStart, затем: systemctl daemon-reload && systemctl restart srv1cv8

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

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

При использовании протокола HTTP укажите адрес отладки в настройках информационной базы или в параметрах конфигуратора. Для базы, опубликованной на веб-сервере, это адрес публикации с суффиксом отладочного ресурса. Убедитесь, что в свойствах публикации разрешена отладка (параметр debug в файле default.vrd).

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

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

Быстрая проверка: откройте конфигуратор, поставьте точку останова в серверной процедуре общего модуля и запустите отладку (F5). Вызовите эту процедуру из клиентского приложения. Если исполнение остановилось на точке — серверная отладка работает.

Дополнительно проверьте список подключённых предметов отладки: меню «Отладка» → «Подключение». В списке должны присутствовать процессы с типом «Сервер». Если список пуст или содержит только клиентский процесс — ключ не применился или протокол настроен неверно.

Риски, ограничения и типичные ошибки

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

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

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

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