Содержание статьи
- Откуда берутся дубли при обмене с 1С
- Какие данные собрать для диагностики
- Пример: ответ потерялся после создания заказа
- Почему «сначала найти, потом создать» недостаточно
- Как разделить состояния и правила повторов
- Как поступить с уже созданными дублями
- Как отличить дубль от допустимого повторного документа
- Как выбирать ключ идемпотентности
- Содержимое запроса и конфликт под прежним ключом
- Конкурентная обработка и неопределённый исход
- Как наблюдать проблему после исправления
- Как проверить исправление
- Источники и дата проверки
Откуда берутся дубли при обмене с 1С
Типовой сбой выглядит так: получатель создал документ, но отправитель не дождался ответа и повторил запрос. Если повтор обрабатывается как новая операция, появляется второй документ. Отключение повторов уберёт часть дублей, но создаст риск потерянных операций. Нужен контракт, который различает повтор и новое действие.
Другие причины — два параллельных обработчика, ручной и автоматический импорт одного источника, потерянные соответствия ID и неверная логика обновлений. Сначала установите причину по журналам; похожий номер документа ещё не доказывает, что записи являются дублями.
Какие данные собрать для диагностики
| Поле | Для чего |
|---|---|
| Система и область источника | Различить одинаковые ID разных баз |
| ID бизнес-объекта | Связать исходный заказ с документом 1С |
| ID операции и номер попытки | Отличить новое действие от повторной доставки |
| ID корреляции и временные метки | Проследить путь запроса и потерю ответа |
| Версия и контрольный отпечаток содержимого | Выявить изменённый запрос под старым ключом |
| ID результата 1С и статус | Понять, завершилась ли запись до таймаута |
ID корреляции для трассировки может меняться от попытки к попытке, а ключ повторяемой операции должен сохраняться. Не складывайте в открытые логи полные документы, токены и персональные данные: для диагностики обычно достаточно идентификаторов, статусов и ограниченного набора полей.
Пример: ответ потерялся после создания заказа
Учебное событие: CRM sales-main просит создать заказ ORD-417. Сервер создал документ 1С DOC-900, после чего соединение оборвалось. Отправитель повторяет запрос с тем же ключом crm:sales-main:create-order:ORD-417. Правильный результат повтора — тот же DOC-900, а не DOC-901.
{
"operation_key": "crm:sales-main:create-order:ORD-417",
"source_object_id": "ORD-417",
"operation": "create_order",
"version": 1
}Это пример собственного контракта, не встроенные поля API 1С. Отпечаток значимого содержимого вычисляет сервер по согласованному представлению. Если под тем же ключом пришла другая сумма или состав, запрос нельзя молча принять как прежний: верните диагностируемый конфликт и потребуйте отдельную операцию изменения.
Почему «сначала найти, потом создать» недостаточно
Два обработчика могут одновременно не найти документ и оба перейти к созданию. Проверка до записи без атомарной защиты не закрывает гонку. В принимающем контуре нужна уникальность ключа операции, сериализация обработки или другой механизм, который не допускает два независимых результата.
Если журнал операции и создаваемый документ находятся в одной системе, постарайтесь фиксировать результат и связь с ключом в одной транзакционной границе поддерживаемыми средствами. Уникальное ограничение в отдельной PostgreSQL не делает запись в 1С частью той же транзакции. Для внешнего получателя критична его собственная защита или механизм восстановления результата по исходному ID.
Если 1С не позволяет ни атомарно сохранить ключ с документом, ни однозначно найти завершённый результат после сбоя, нельзя честно обещать отсутствие дублей при любом аварийном сценарии. Такая операция требует адаптера в принимающем контуре или ручной сверки неопределённого состояния до повторной записи.
Как разделить состояния и правила повторов
| Состояние | Что делать |
|---|---|
| Операция не найдена | Начать по правилам атомарного захвата ключа |
| Выполняется | Не запускать вторую запись; ожидать или вернуть статус |
| Завершена | Проверить содержимое и вернуть сохранённый результат |
| Ошибка в данных | Исправить причину; не крутить бесконечный retry |
| Результат неизвестен после сбоя | Сначала восстановить результат по ID или сверить вручную |
| Тот же ключ, другое содержимое | Отклонить конфликт; отдельная операция изменения |
Отдельно определите срок хранения ключей: он должен покрывать допустимое окно повторной доставки, восстановления из резервной копии и ручного переотправления. Удалённый слишком рано ключ позволяет старому событию снова стать «новым». Для изменений используйте версию или отдельный ID операции; позднее событие не должно перезаписывать более новое состояние.
Как поступить с уже созданными дублями
- Ограничьте проблемный поток, сохранив сообщения и историю. Не запускайте массовую повторную загрузку вслепую.
- Сгруппируйте кандидатов по источнику и бизнес-ID, сверьте состав, суммы и связанные операции.
- Проверьте проведение, отгрузки, оплаты и внешние документы. Одинаковые номера могут быть допустимыми в разных организациях.
- Согласуйте исправление с владельцем учёта и выполните его поддерживаемыми средствами на тестовой копии.
- Восстановите соответствия, исправьте причину и повторно проверьте поток.
Удалять проведённые документы SQL-запросом по совпадению номера нельзя считать процедурой очистки. Внешние последствия не исчезают при удалении строки: могли уйти уведомления, задания на склад или электронные документы.
Как отличить дубль от допустимого повторного документа
Одинаковый номер не является достаточным признаком. Нумерация может повторяться по организациям, годам и типам объектов. Два документа могут иметь одинаковую сумму, но относиться к разным отгрузкам. Сначала восстановите происхождение: система, область базы, бизнес-объект и тип действия. Только после этого сравнивайте состав, даты и связанные операции. Очистка по одному внешнему номеру может удалить законную хозяйственную запись.
Разделите дубль карточки, дубль операции и дубль внешнего последствия. В базе может быть один документ, но дважды отправленное уведомление или задание складу. Возможна обратная ситуация: две карточки созданы, но проведена только одна. Диагностика должна охватывать весь путь действия. Проверка количества строк в одном журнале не доказывает отсутствие повторной отгрузки или отправки электронного документа.
Для каждого подозрительного случая заведите короткую временную линию: получение запроса, начало обработки, запись, подтверждение и следующая попытка. Сопоставьте время по нескольким журналам, учитывая часовые пояса и возможное расхождение часов. Не делайте вывод о порядке только по строкам одного интерфейса. Устойчивые идентификаторы и причинные связи надёжнее приблизительного совпадения секунд.
Как выбирать ключ идемпотентности
Ключ должен обозначать одно намерение выполнить действие. Он отличается от случайного ID каждой HTTP-попытки и от постоянного ID объекта. Один заказ может сначала создаваться, затем изменяться и отменяться. Если использовать только номер заказа, законное изменение будет ошибочно принято за повтор создания. Добавьте вид операции и версию либо отдельный стабильный ID события по контракту.
Ключ должен сохраняться при техническом повторе. Если клиент генерирует новый UUID после каждого таймаута, сервер не узнает прежнюю операцию. Сохраните ключ до отправки вместе с состоянием исходного задания. Для ручного переотправления используйте тот же идентификатор, если намерение не изменилось. Новая операция требует явного решения, а не случайного обновления поля в форме повторного запуска.
Определите область уникальности. ID ORD-417 может существовать у двух источников или клиентов. Включите систему и область базы либо используйте подтверждённый глобальный идентификатор. При этом не помещайте секреты и персональные данные в ключ: он часто попадает в журналы. Ключ должен быть диагностируемым и стабильным, но не раскрывать лишние сведения сотрудникам технической поддержки.
Содержимое запроса и конфликт под прежним ключом
Сравнение отпечатка требует канонического представления значимых данных. Разный порядок JSON-полей не обязан означать другую операцию. Но изменение количества, валюты или склада почти наверняка меняет смысл. Перечислите поля, участвующие в сравнении, и правила нормализации. Не вычисляйте случайный хеш от всего сетевого сообщения вместе с датой повторной отправки: техническая попытка тогда всегда будет отличаться.
Суммы сравнивайте в согласованной точности, а ссылки — после разрешённого сопоставления. Строки «1.0» и «1.00» могут быть одним количеством, но два одинаковых названия контрагентов не обязательно одним объектом. При конфликте сохраняйте оба описания в защищённой диагностике и возвращайте понятную причину. Молчаливая замена прежнего результата новым содержимым нарушает обещание идемпотентной операции.
Не пытайтесь использовать один ключ для всех редакций документа. После согласованного изменения создаётся операция обновления с собственным состоянием и проверкой версии. Если обновление пришло раньше создания, нужен порядок ожидания или контролируемый отказ. Автоматическое создание из любого события изменения может обойти необходимые проверки исходного процесса и породить ещё один источник дублей.
Конкурентная обработка и неопределённый исход
Состояние «выполняется» должно иметь правила владения и восстановления. Если обработчик упал, запись не должна остаться навсегда заблокированной. Но истечение времени ожидания само по себе не доказывает, что 1С ничего не записала. Перед повторной работой выясните, можно ли восстановить результат по ключу. Слепой захват просроченного задания другим worker опасен на границе внешней транзакции.
Для принимающей системы предпочтителен механизм, который объединяет создание результата и фиксацию связи с ключом. Если эти действия разделены, опишите аварийное окно между ними. Внешний журнал полезен, но не превращает два независимых сервиса в одну транзакцию. Неопределённость нужно показать оператору и ограничить автоматические действия, а не скрыть бесконечным повтором с надеждой на удачный ответ.
После восстановления из резервной копии также требуется сверка. Отправитель может помнить успешную операцию, а получатель восстановиться до её выполнения; возможна и обратная ситуация. Согласуйте источник подтверждения и процедуру повторного применения. Обещание «ровно один раз» должно относиться к проверяемому бизнес-результату в описанных условиях, а не к рекламному свойству используемого брокера.
Как наблюдать проблему после исправления
Считайте не только отказы уникальности, но и возвращённые прежние результаты, конфликты содержимого и неопределённые операции. Рост повторов может указывать на задержки сети, слишком короткий таймаут или перегрузку получателя. Защита от дублей сохраняет данные, но не делает такую эксплуатацию нормальной. Нужно устранить источник лишних попыток и проверить время полного выполнения.
Приёмочный отчёт должен показывать набор сценариев, исходные ключи и конечные документы. Для параллельного теста зафиксируйте число попыток и ожидаемый единственный результат. После испытания проверьте движения и внешние действия, затем воспроизведите те же проверки после изменения обработчика. Это защищает от возврата ошибки при добавлении нового типа документа или другого источника.
Как проверить исправление
Проведите один и тот же тест с несколькими последовательными повторами и параллельными попытками. Затем имитируйте потерю ответа после записи, перезапуск обработчика и повтор старого сообщения. Каждый раз сверяйте документ, движения и внешние действия, а не только HTTP-ответ.
Критерий примера: один ORD-417 связан с одним DOC-900, повтор не создаёт новых движений и заданий, изменённое содержимое под старым ключом даёт конфликт, неопределённое состояние видно оператору. Измеряйте число бизнес-дублей, неопределённых операций и время восстановления.
При повторяющихся сбоях транспорта полезно пересмотреть выбор шины или сервиса интеграции. Если дублируются не документы, а товары и контрагенты, начните с правил управления НСИ.
Отдельное упражнение: отправьте один ключ с исходным количеством, затем с изменённым. Второй запрос должен дать конфликт, а прежний документ остаться неизменным. После этого оформите разрешённую отдельную операцию обновления. Так проверяется различие технического повтора и нового намерения, которое нельзя увидеть в тесте из двух полностью одинаковых запросов.
Источники и дата проверки
Проверено . Amazon Builders’ Library: безопасные повторы и идемпотентные API; PostgreSQL: ограничения уникальности.