Как включить отладку на сервере 1С: когда это нужно, как подготовиться и что проверить

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

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

При этом включать отладку на рабочем сервере 1С нужно осторожно. Это не обычная пользовательская настройка и не универсальный способ “посмотреть, что происходит”. Отладка может влиять на производительность, останавливать выполнение кода на точках останова, затрагивать рабочие сеансы пользователей и создавать дополнительные риски безопасности.

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

Когда нужна отладка на сервере 1С

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

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

Типичные ситуации

• ошибка появляется при проведении документа;
• не выполняется серверная процедура общего модуля;
• непонятно, какие данные приходят в серверный метод;
• фоновое задание завершается с ошибкой;
• обмен с сайтом, CRM или другой системой работает неправильно;
• регламентное задание зависает или выполняется слишком долго;
• отчет формируется с неверными данными;
• серверная часть расширения работает не так, как ожидалось;
• ошибка воспроизводится только в клиент-серверной базе;
• нужно проверить поведение кода под конкретным пользователем.

Что можно увидеть в отладчике

• последовательность выполнения процедур и функций;
• значения переменных;
• параметры серверного вызова;
• стек вызовов;
• условия, по которым код пошел в одну ветку, а не в другую;
• момент, когда возникает исключение;
• поведение фонового или регламентного задания;
• взаимодействие клиентского и серверного кода.

Когда отладка не лучший первый шаг

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

Сначала стоит собрать:

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

Клиентская и серверная отладка: в чем разница

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

Клиентская отладка

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

Она нужна, если проблема связана с:

• формой документа или справочника;
• нажатием кнопки;
• клиентской проверкой;
• отображением данных;
• командами интерфейса;
• клиентским кодом расширения.

Серверная отладка

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

Она нужна, если проблема связана с:

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

Как понять, где выполняется код

В конфигурации 1С это обычно видно по директивам и свойствам модулей. Например, код может быть помечен как выполняемый на клиенте или на сервере. Если точка останова не срабатывает, возможно, она поставлена не в том контексте или предмет отладки не подключен.

Что подготовить перед включением отладки

Перед тем как включать отладку на сервере 1С, нужно подготовить среду. Главная рекомендация — по возможности отлаживать не рабочую базу, а копию или тестовую среду, где остановка кода не повлияет на пользователей.

Лучше использовать тестовую базу

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

Тестовая среда особенно важна, если:

• ошибка связана с проведением документов;
• нужно проверять обмены и регламентные задания;
• есть несколько активных пользователей;
• работает клиент-серверная база с MS SQL;
• используются расширения или доработки;
• планируется перезапуск службы сервера 1С;
• нужно ставить точки останова в часто вызываемом коде.

Сделайте резервную копию

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

Проверьте:

• когда была создана последняя копия;
• что именно попадает в backup;
• можно ли восстановить базу;
• есть ли копия конфигурации;
• сохранены ли расширения;
• не выполняется ли параллельно важный обмен или закрытие периода.

Согласуйте время работ

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

Перед работами нужно предупредить:

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

Проверьте версию платформы

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

Проверьте:

• версию платформы на сервере 1С;
• версию конфигуратора у разработчика;
• совпадают ли версии платформы;
• используется ли новый механизм отладки по HTTP;
• какая архитектура: файловая база или клиент-серверная;
• операционная система сервера: Windows или Linux;
• как запущена служба сервера 1С.

Общая схема серверной отладки 1С

В клиент-серверной базе отладчик, сервер 1С и предметы отладки должны “увидеть” друг друга. Недостаточно просто поставить точку останова в модуле: сервер должен быть запущен с поддержкой отладки, а нужный сеанс, фоновое задание или рабочий процесс должен быть подключен к отладчику.

Как это выглядит

        Конфигуратор 1С
        отладчик разработчика
                │
                ▼
          Сервер отладки
          HTTP-механизм
                │
      ┌─────────┼─────────┐
      ▼         ▼         ▼
 клиентский   серверный   фоновое
 сеанс        код 1С      задание
                │
                ▼
        Кластер сервера 1С
        рабочие процессы

Что такое предметы отладки

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

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

Почему точка останова может не сработать

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

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

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

Шаг 1. Проверьте, что это клиент-серверная база

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

Проверьте:

• как подключена информационная база;
• есть ли сервер 1С;
• какой кластер используется;
• какая СУБД используется;
• какая версия платформы установлена на сервере;
• есть ли доступ администратора к серверу.

Шаг 2. Остановите службу сервера 1С в согласованное окно

Если изменение параметров запуска требует перезапуска службы, сначала нужно завершить пользовательские сеансы или согласовать простой. Не стоит перезапускать рабочий сервер 1С без предупреждения пользователей.

На Windows службу можно проверять через оснастку служб или PowerShell. Название службы зависит от версии платформы и установки.

Get-Service *1C*

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

Шаг 3. Добавьте параметры запуска отладки

Для нового HTTP-механизма отладки сервер 1С запускают с параметрами отладки. В документации и материалах 1С для клиент-серверного варианта встречается пример:

ragent.exe -debug -http

На практике параметры указывают в настройках запуска службы сервера 1С. Способ зависит от версии платформы и того, как именно установлена служба. На Windows это может быть изменение параметров службы, а на Linux — изменение скрипта запуска.

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

Шаг 4. Запустите службу сервера 1С

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

Проверьте:

• служба сервера 1С запущена;
• кластер доступен;
• информационная база открывается;
• в журнале событий нет ошибок запуска;
• сервер отладки доступен;
• конфигуратор видит нужную базу.

Шаг 5. Включите отладку в конфигураторе

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

Общая логика:

1. Откройте информационную базу в конфигураторе.
2. Проверьте, что конфигурация соответствует серверной базе.
3. Откройте настройки отладки.
4. Выберите нужный механизм отладки.
5. При необходимости укажите сервер отладки.
6. Перезапустите конфигуратор, если платформа этого требует.
7. Откройте список предметов отладки.
8. Подключите нужный сеанс или контекст.

Шаг 6. Подключите предметы отладки

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

Проверьте:

• виден ли нужный предмет отладки;
• подключен ли он к отладчику;
• не подключен ли случайно другой пользователь;
• не выполняется ли код в фоновом задании;
• активна ли точка останова;
• совпадает ли версия конфигурации.

Шаг 7. После работ отключите режим отладки

После завершения диагностики сервер 1С лучше вернуть в обычный режим. Для этого нужно убрать параметры отладки из запуска службы, перезапустить сервер в согласованное окно и проверить работу базы.

Не оставляйте рабочий сервер в режиме отладки без необходимости. Это лишний риск и для производительности, и для безопасности.

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

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

Фоновые и регламентные задания

Фоновое задание может запускаться не в момент, когда разработчик ждет точку останова. Поэтому перед отладкой нужно понять расписание, условия запуска и пользователя, под которым выполняется задание.

Проверьте:

• как называется регламентное задание;
• по какому расписанию оно запускается;
• можно ли запустить его вручную в тестовой базе;
• какой пользователь выполняет задание;
• какие права нужны этому пользователю;
• какие параметры передаются в обработку;
• попадает ли задание в список предметов отладки;
• есть ли записи в журнале регистрации.

Серверные вызовы из клиентского кода

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

В таком сценарии полезно ставить точки останова:

• в клиентском обработчике;
• в серверной процедуре;
• в общем модуле;
• в месте обработки результата;
• в обработчиках ошибок.

Обмены и интеграции

При отладке обменов важно не только поймать точку останова, но и сохранить исходные данные запроса или файла. Иначе ошибка может не воспроизвестись.

Перед отладкой обмена подготовьте:

• пример входящего файла или сообщения;
• параметры HTTP-запроса, если используется веб-сервис;
• лог обмена;
• пользователя, под которым выполняется обмен;
• тестовую копию базы;
• информацию о времени запуска;
• версию внешней системы.

Безопасность и риски серверной отладки

Серверная отладка дает разработчику глубокий доступ к выполнению кода. Это полезно для диагностики, но в рабочей среде требует аккуратности.

Основные риски

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

Как снизить риски

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

Что лучше не делать на рабочей базе

Типичные ошибки при включении отладки

Если отладка не работает, не нужно сразу менять все настройки подряд. Лучше пройти проверку по шагам: сервер, конфигуратор, версия платформы, предметы отладки, права, firewall и конкретный сценарий воспроизведения.

Практический чек-лист диагностики

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

Заключение

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

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

После завершения диагностики сервер 1С нужно вернуть в обычный режим, убрать параметры отладки и проверить работу пользователей. Не стоит оставлять режим отладки включенным “на всякий случай”.

Что почитать дальше

Если вы занимаетесь серверной инфраструктурой 1С, полезно также посмотреть связанные материалы:

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

Когда стоит обратиться к специалистам

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

IPWAY помогает с сопровождением 1С, серверной инфраструктурой, обновлениями платформы, диагностикой ошибок, настройкой Windows VPS/VDS под 1С и разбором проблем в клиент-серверных базах. Если нужно не просто включить отладку, а безопасно найти причину ошибки в рабочей системе, лучше проводить диагностику по регламенту.

Кратко

• Серверная отладка 1С нужна для кода, который выполняется на сервере, в фоновых заданиях, обменах и рабочих процессах кластера.
• Клиентская и серверная отладка — разные контексты.
• Если точка останова не срабатывает, возможно, подключен не тот предмет отладки.
• Перед работами лучше подготовить тестовую базу.
• Перед отладкой рабочей базы нужна резервная копия и согласованное окно работ.
• Для серверной отладки сервер 1С должен быть запущен с поддержкой режима отладки.
• В новом механизме может использоваться HTTP-отладка и сервер отладки.
• Фоновые задания нужно отлаживать отдельно, с учетом расписания и пользователя запуска.
• После завершения работ режим отладки нужно отключить.
• Не стоит оставлять рабочий сервер 1С в режиме отладки без необходимости.