Стенд сбоев обмена: проверить HTTP-обмен 1С на задержку, ошибку сервиса и обрыв ответа
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
HTTP-обмен 1С обычно проверяют, когда сервис доступен и отвечает быстро. Так не видно главного: что будет, если сервис сохранил заказ, а 1С не получила ответ. Обмен показывает ошибку, пользователь или регламентное задание отправляет заказ ещё раз, и на стороне сервиса появляется дубль. Приложение воспроизводит такие ситуации на тестовом обмене заранее: задержку, ошибку 500, ответ 429 и обрыв ответа на середине.
Что делает
- Встаёт между 1С и тестовым сервисом: 1С отправляет запрос на локальный адрес, приложение передаёт его сервису и возвращает ответ.
- На следующий подходящий запрос применяет выбранный сбой: задерживает отправку, само отвечает 500 или 429 с Retry-After, или передаёт только начало ответа и обрывает соединение.
- Показывает в журнале, что произошло с каждым запросом: какой сбой назначен, дошёл ли запрос до сервиса, какой статус вернул сервис, сколько байт получил клиент.
- Само запросы не повторяет, не переходит по редиректам и не распаковывает ответ: обмен получает то, что вернул сервис, плюс выбранный сбой.
- Работает как отдельная программа Windows. В базу ничего устанавливать не нужно, конфигурацию и данные приложение не трогает.
Главный пример: ответ потерян, а запись есть
Кнопка "Попробовать на примере" запускает встроенный учебный сервис с вымышленными данными, база 1С для этого не нужна. "1. Создать запись": сервис сохраняет запись, ответ обрывается, клиент получает ошибку передачи, а счётчик сервиса показывает одну запись. "2. Повторить тот же запрос": клиент получает полный ответ, записей становится две.
Это и есть цена повторной отправки без защиты от дублей. Ошибка получения ответа не означает, что операция не выполнена.
Как подключить свой обмен
- Запустить
ExchangeFaultLab.exeна той машине, где выполняется HTTP-запрос: для клиентского кода это компьютер пользователя, для серверного кода тестовый сервер 1С. - Вписать адрес тестового сервиса, только сервер, например
https://api.example.test. Путь и параметры придут из запроса 1С. - Нажать "Запустить". Появится адрес для обмена, например
http://127.0.0.1:18080. - В тестовой настройке обмена заменить адрес сервера этим адресом, путь запроса оставить прежним.
- Выбрать сбой и выполнить обычную отправку из 1С. После проверки вернуть исходный адрес.
Если соединение создаётся в коде, достаточно поменять сервер и порт и убрать защищённое соединение: на входе приложение принимает HTTP, а к сервису само пойдёт по HTTPS, если его адрес начинается с https://.
// Было: Новый HTTPСоединение("api.example.test", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL); Соединение = Новый HTTPСоединение("127.0.0.1", 18080, , , , 30); Запрос = Новый HTTPЗапрос("/orders"); Ответ = Соединение.ОтправитьДляОбработки(Запрос);
Какие сбои есть
| Сбой | Что происходит | Что проверить в обмене |
|---|---|---|
| Без сбоя | запрос уходит сервису, ответ передаётся целиком | что подключение через приложение работает |
| Задержать ответ | пауза перед отправкой сервису, по умолчанию 5 секунд | тайм-аут и сообщение пользователю |
| Ошибка сервера 500 | отвечает приложение, сервис не вызывается | обработку отказа и порядок повторов |
| Слишком много запросов 429 | отвечает приложение с заголовком Retry-After, сервис не вызывается | выдерживает ли обмен период ожидания |
| Оборвать ответ | сервис получает запрос и выполняет его, клиент получает только начало ответа | проверку результата операции и защиту от дублей |
По умолчанию сбой срабатывает один раз, следующие запросы идут обычно. В дополнительных настройках задаются число применений, HTTP-метод, точный путь (можно кириллицей), длительность задержки, значение Retry-After, сколько байт отдать до обрыва и порт. Запрос, который не подошёл под фильтр, сбой не расходует.
Журнал
По каждому запросу: время, метод, путь, сбой, результат и длительность. В подробностях видно, назначен ли сбой этому запросу, установлено ли соединение с сервисом, какой HTTP-статус вернул сервис и какой получил клиент, сколько байт ответа отдано из заявленных.
Тела запросов, заголовки авторизации, cookie и параметры после ? в журнал не попадают. Журнал сохраняется в JSON, перед сохранением открывается просмотр текста, который уйдёт в файл.
Ограничения
- Только локальный вход. Приложение принимает запросы на
127.0.0.1, поэтому запускается на той же машине, где выполняется HTTP-код. Доступа по сети в этой версии нет. - Протокол. HTTP/1.1, один тестовый сервис по HTTP или HTTPS, сертификат сервиса проверяется обычным способом. Нет HTTP/2, WebSocket, SSE, NTLM/Kerberos и перехвата TLS.
- Обрыв. Нужен ответ с Content-Length длиннее выбранного начала, по умолчанию 64 байта. Ответы HEAD, 204, 304, короткие и без Content-Length проходят целиком, журнал называет причину.
- Пределы. Запрос до 8 МБ, ответ до 16 МБ, 16 запросов одновременно, 60 секунд на запрос вместе с задержкой. Сверх предела приложение само отвечает 413, 502, 503 или 504 и отмечает это в журнале.
- Факт операции. Приложение показывает сетевой результат. Сохранил ли документ ваш сервис, проверяется на самом сервисе.
Что нужно для запуска
Windows x64, проверено на Windows 10 22H2. Установка не нужна: среда .NET уже внутри EXE, ставить .NET, Java, Docker или Python не требуется, права администратора не нужны. Интерфейс на русском, внутри вкладка "Помощь" с 21 ответом на частые вопросы, работает без интернета. Вызовы через приложение проверены из платформы 1С 8.3.27.
В архиве: ExchangeFaultLab.exe, краткая инструкция, вопросы и ответы, пример вызова на встроенном языке, контрольная сумма EXE и лицензии включённых компонентов .NET. Файл не подписан сертификатом издателя, поэтому при первом запуске Windows может показать предупреждение SmartScreen.
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.22.67
Вступайте в нашу телеграмм-группу Инфостарт