Отладка HTTP в 1С: как включить и использовать

HTTP-запросы в 1С используются повсеместно: обмен с сайтом, интеграция с REST API, веб-сервисы, загрузка курсов валют. Когда обмен перестаёт работать, стандартное сообщение «Ошибка при вызове метода контекста» мало о чём говорит. Чтобы понять, что именно уходит на сервер и что возвращается, нужно включить отладку HTTP-обмена.

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

Материал ориентирован на разработчиков и администраторов 1С, которым нужно диагностировать ошибки HTTPСоединение, HTTPЗапрос, HTTPСервисы или фоновые обмены данными по HTTP.

Какие инструменты отладки HTTP доступны в 1С

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

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

Включение технологического журнала для диагностики HTTP

Технологический журнал — главный встроенный способ увидеть, что происходит с HTTP-вызовами на уровне платформы. Он включается через конфигурационный файл logcfg.xml, который размещается в каталоге conf рядом с исполняемыми файлами платформы (например, C:\Program Files\1cv8\<версия>\bin\conf) или в каталоге, заданном настройками кластера.

Минимальная конфигурация для сбора исключений и сетевых событий выглядит так:

<config xmlns="http://v8.1c.ru/v8/tech-log">
  <log location="C:\1clogs" history="24">
    <event><eq property="name" value="EXCP"/></event>
    <event><eq property="name" value="CONN"/></event>
    <property name="all"/>
  </log>
</config>

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

В собранных логах ищите события EXCP с текстом, содержащим HTTPСоединение, Получить, ОтправитьДляОбработки или коды ответов сервера. Там же видно, на каком этапе произошёл сбой — при установке соединения, отправке запроса или чтении ответа.

Отладка кода HTTP-обмена в конфигураторе

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

Полезные места для точек останова: создание объекта HTTPСоединение, формирование HTTPЗапрос (заголовки, тело), вызов методов Получить/ОтправитьДляОбработки/Записать, чтение кода состояния из HTTPОтвет. В табло или через «Вычислить выражение» проверьте КодСостояния, заголовки ответа и тело через ПолучитьТелоКакСтроку().

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

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

1. 1
   Откройте конфигуратор и включите отладку нужного типа сеанса
2. 2
   Поставьте точку останова перед созданием HTTPСоединение
3. 3
   Добавьте точку после вызова метода отправки запроса
4. 4
   Воспроизведите ошибку и проверьте КодСостояния, заголовки и тело ответа
5. 5
   Сравните фактически отправляемый запрос с документацией API

Перехват HTTP-трафика внешними инструментами

Когда нужно увидеть именно сетевой уровень — реальные заголовки, редиректы, тело запроса в том виде, в каком оно ушло, — платформенных средств недостаточно. Здесь помогают прокси-анализаторы: Fiddler Classic, Fiddler Everywhere или mitmproxy.

Для перехвата настройте в 1С использование прокси: в объекте HTTPСоединение есть параметр, принимающий объект ИнтернетПрокси, либо прокси задаётся системно. Укажите адрес и порт, на котором слушает Fiddler (по умолчанию 127.0.0.1:8888). После этого весь трафик обмена появится в списке сессий анализатора.

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

Логирование на стороне веб-сервера

Если 1С выступает серверной стороной (HTTP-сервисы, публикация на IIS или Apache), дополнительно включите журналы веб-сервера. В IIS это стандартное логирование W3C, в Apache — access.log и error.log. Сопоставление записей веб-сервера с событиями технологического журнала 1С позволяет понять, дошёл ли запрос до публикации и как его обработала платформа.

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

Большинство проблем при диагностике HTTP-обмена связаны не с самим обменом, а с неверной настройкой инструментов. Ниже — то, что встречается чаще всего.

Отдельно стоит упомянуть ошибки самого обмена, которые маскируются под «не работает отладка»: неверный таймаут соединения, отсутствие заголовка Content-Type при отправке JSON, неправильная кодировка тела запроса и попытка читать тело ответа после закрытия соединения. Все они хорошо видны именно при комбинации отладчика и перехвата трафика.

Проверка результата: как понять, что диагностика удалась

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

FAQ