Если выключенный принтер A останавливает печать на B, проблема обычно не в драйвере B, а в общей очереди: один worker ждёт сетевой timeout и не берёт следующее задание. Разделите планирование по `printer_id`; состояние одного физического устройства не должно владеть глобальной блокировкой.
Второй риск — слепой retry. Печать неидемпотентна: соединение могло оборваться уже после того, как spooler принял документ. Поэтому `timeout` означает «результат неизвестен», пока приложение не сверило сохранённый внешний job ID или оператор не разрешил повтор.
У принтера и задания разные автоматы
| Объект | Состояния | Что решает |
|---|---|---|
| printer | idle / processing / stopped / unknown | можно ли планировать новые задания |
| job в приложении | queued / dispatching / submitted / reconciling / final | где находится бизнес-задание |
| IPP job | pending / processing / processing-stopped / completed / aborted | что знает print service |
| worker lease | free / held / expired | кто сейчас двигает очередь устройства |
RFC 8011 отдельно определяет `printer-state`, `printer-state-reasons` и `printer-is-accepting-jobs`. Принтер может принимать новые jobs, даже находясь в stopped, или наоборот отвергать их при другом состоянии. Один boolean `online` теряет эту информацию.
Очередь шардируется по printer_id
claimNext(printerId):
acquire lease print:{printerId}
job = oldest QUEUED job for printerId
if printer not accepting: schedule probe; release lease
else mark DISPATCHING and submit
workers may process printer A and printer B concurrently
only one worker preserves FIFO inside each printerLease имеет срок и heartbeat, чтобы падение процесса не заморозило очередь навсегда. Транзакция выбора использует блокировку строки или эквивалентный механизм. Глобальный лимит concurrency допустим для ресурсов сервера, но слот offline-устройства должен быстро освобождаться, а не ждать минуты.
IPP-атрибуты заменяют догадки по сокету
- Перед отправкой запросите `printer-is-accepting-jobs`, `printer-state` и `printer-state-reasons`.
- После принятия сохраните `job-id`/`job-uri`, который вернул print service.
- Опрашивайте `job-state` и `job-state-reasons`, не парсите локализованный message как API.
- Состояние `processing-stopped` оставляет возможность продолжения после устранения причины.
- Если шлюз потерял связь со spooler, показывайте unknown, а не выдуманный failed.
Успешный ответ Print-Job доказывает принятие задания сервисом, но не физический лист в лотке. Финальный `completed` тоже интерпретируется в рамках конкретной цепочки печати; для критичных чеков может понадобиться подтверждение устройства или оператора.
Retry имеет предел и режим сверки
| Сбой | Автоматическое действие | Повтор безопасен? |
|---|---|---|
| printer not accepting jobs | пауза очереди и probe | да, задание ещё не принято |
| ошибка до передачи тела | backoff с лимитом | обычно да |
| timeout после отправки | reconciling по job ID | неизвестно |
| IPP aborted | по политике/ручная проверка | зависит от причины |
| completed | финализировать | нет, повтор создаст дубликат |
CUPS предлагает политики `abort-job`, `retry-job`, `retry-current-job` и `stop-printer`; выберите их осознанно для конкретной очереди. Приложение не должно бесконечно добавлять собственные повторы поверх бесконечных повторов spooler.
Idempotency key не отменяет физический дубль
Внутренний `document_id + copy_no` защищает от двух записей в вашей БД, но внешний принтер не обязан понимать этот ключ. Храните hash payload, target printer, момент submit и внешний job ID. При неопределённом исходе сначала ищите job в spooler; если история уже недоступна, переводите задание в ручную сверку, особенно для чеков, этикеток и юридически значимых форм.
Проверка с двумя принтерами выявляет блокировку
- Очистить тестовые очереди и включить лог correlation ID для job.
- Выключить A, оставить B доступным, отправить A1, B1, A2, B2.
- Убедиться, что B1 и B2 завершились по FIFO без ожидания timeout A.
- Включить A и проверить продолжение A1/A2 без перестановки.
- Оборвать соединение сразу после submit и проверить переход в reconciling без автоматического дубля.
- Перезапустить worker во время lease и убедиться, что очередь восстановилась после срока.
- Проверить метрики queue age, attempts и stopped printers раздельно.
В инцидент приложите внутренний job ID, printer ID, внешний spooler job ID, состояния и причины до/после, policy retry и временные метки. Сам документ с персональными данными не нужен. Критерий исправления прост: недоступность одного устройства увеличивает возраст только его очереди.