Как отладить веб-сервис в 1С: практическое руководство

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

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

Материал охватывает оба типа сервисов платформы 1С:Предприятие — классические SOAP веб-сервисы и HTTP-сервисы (REST-подобные). Подходы к их отладке во многом совпадают, но есть отличия в публикации и тестировании, которые разобраны ниже.

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

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

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

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

Для клиент-серверного варианта работы отладка включается на уровне службы агента сервера. Нужно остановить службу агента сервера 1С, добавить в параметры её запуска ключ отладки и снова запустить службу. В Windows это делается через реестр в параметре ImagePath соответствующей службы, в Linux — в скрипте запуска.

"C:\Program Files\1cv8\<версия>\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo" -debug

Ключ -debug разрешает отладку по протоколу TCP. Если планируется отладка по HTTP (актуально для современных версий платформы), дополнительно указывается параметр -debugHTTP и настраивается публикация отладчика. После перезапуска службы проверьте, что сервер запустился без ошибок — ошибка в строке параметров приводит к тому, что служба не стартует вообще.

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

Публикация веб-сервиса и её проверка

Веб-сервис становится доступен только после публикации на веб-сервере (IIS или Apache). В конфигураторе откройте «Администрирование — Публикация на веб-сервере», укажите имя публикации, каталог и отметьте нужные типы сервисов: веб-сервисы, HTTP-сервисы или оба варианта. После публикации перезапустите веб-сервер, чтобы он подхватил изменения.

Проверить доступность SOAP веб-сервиса можно, открыв в браузере URL вида http://server/base/ws/ИмяСервиса?wsdl. Если в ответ приходит XML-описание (WSDL), публикация работает. Для HTTP-сервиса проверка зависит от шаблона URL: откройте адрес вида http://server/base/hs/корневойURL/путь — даже ошибка 405 или ответ обработчика подтверждают, что запрос доходит до 1С.

Подключение конфигуратора к сеансу веб-сервиса

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

Нюанс в том, что сеанс веб-сервиса живёт недолго — пока выполняется запрос. Если код обработчика короткий, вы можете не успеть подключиться. Практический приём: поставьте точку останова заранее и в параметрах отладки включите автоматическое подключение к новым сеансам нужного типа (веб-сервис, HTTP-сервис). Тогда отладчик подхватит сеанс сам при первом же запросе.

1. 1
   Включите режим отладки на сервере и перезапустите службу
2. 2
   Обновите публикацию веб-сервиса и перезапустите веб-сервер
3. 3
   В конфигураторе откройте Отладка — Подключение и настройте автоматическое подключение к сеансам веб/HTTP-сервисов
4. 4
   Поставьте точку останова в модуле сервиса
5. 5
   Отправьте тестовый запрос из SoapUI, Postman или браузера
6. 6
   Убедитесь, что выполнение остановилось на точке останова

Тестирование SOAP веб-сервиса через SoapUI

Для SOAP-сервисов удобнее всего использовать SoapUI: создайте проект, указав URL WSDL, и инструмент сам построит шаблоны запросов для всех операций. Заполните параметры, отправьте запрос — и, если отладчик подключён, выполнение остановится на точке останова в модуле веб-сервиса.

При тестировании обращайте внимание на аутентификацию. Если публикация настроена с проверкой подлинности, в SoapUI нужно указать логин и пароль пользователя 1С (Basic-аутентификация). Ошибка 401 означает, что запрос отклонён ещё до входа в код сервиса — отлаживать там нечего, сначала решите вопрос с доступом.

Типичные ошибки SOAP-запросов

Ошибка вида «Операция не найдена» означает, что имя операции в запросе не совпадает с именем в конфигурации. Ошибки сериализации (невозможно преобразовать параметр) возникают при несовпадении типов XDTO — проверьте пакеты XDTO в конфигурации и фактическую структуру XML в запросе. Текст faultstring в ответе SOAP обычно содержит точное описание проблемы.

Отладка HTTP-сервисов

HTTP-сервисы отлаживаются по той же схеме: отладка на сервере, публикация, подключение к сеансу. Различие в тестировании: запросы удобно отправлять из Postman, curl или даже браузера (для GET-методов). В модуле HTTP-сервиса точка останова ставится в функции-обработчике шаблона URL, например в ПолучитьДанныеGET.

Функция ПолучитьДанныеGET(Запрос)
	Ответ = Новый HTTPСервисОтвет(200);
	Параметры = Запрос.ПараметрыЗапроса;
	// точка останова здесь — можно посмотреть содержимое Запрос
	Ответ.УстановитьТелоИзСтроки("{}");
	Возврат Ответ;
КонецФункции

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

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

Не всегда есть возможность включить отладку — например, на продуктивном сервере. В этом случае основные инструменты — журнал регистрации и логи веб-сервера. В коде обработчика добавьте запись в журнал регистрации через ЗаписьЖурналаРегистрации с ключевыми данными запроса: параметрами, этапом выполнения, текстом ошибки из ОписаниеОшибки().

Логи IIS (каталог inetpub\logs) или Apache (access.log, error.log) показывают, дошёл ли запрос до веб-сервера и с каким HTTP-кодом он завершился. Если в логах веб-сервера запроса нет — проблема на уровне сети, брандмауэра или неверного URL, и к 1С она отношения не имеет. Технологический журнал платформы (при его включении) даёт самую детальную картину, включая тексты запросов к СУБД и исключения.

Частые ошибки и их признаки

Ошибка 500 без внятного описания чаще всего означает необработанное исключение в коде обработчика. Оберните логику в Попытка/Исключение и возвращайте осмысленный ответ с кодом и текстом ошибки — это упростит диагностику и для вас, и для потребителей сервиса. Ошибка 404 — неверный URL публикации, имя сервиса или шаблон HTTP-сервиса. Ошибка 401/403 — проблемы аутентификации и прав доступа.

Отдельный класс проблем — тайм-ауты. Если обработчик выполняет тяжёлый запрос к базе, веб-сервер может оборвать соединение раньше, чем 1С вернёт ответ. В отладчике такой код выглядит зависшим на длинной операции. Решение — оптимизация запроса или увеличение тайм-аутов на веб-сервере, но второе — паллиатив.

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