Что такое очередь задач — и почему твой бот отвечает дважды

Твой бот получил одно сообщение — а ответил на него два раза. Иногда три. Ты лезешь в код искать лишний вызов, но его там нет.
Вот в чём дело: лишний вызов сделал не ты. Его сделал сервис, который прислал событие. Ты не ответил ему достаточно быстро, он решил, что сообщение потерялось, и прислал то же самое ещё раз. И ещё. А твой код честно обработал каждое.
Лечится это не костылём в обработчике, а одной архитектурной штукой — очередью задач.
Отправитель события не ждёт долго
Когда пользователь пишет боту, Telegram (или Stripe, или GitHub) шлёт тебе вебхук — HTTP-запрос с событием. И ждёт короткого ответа: «принял».
Ждёт он секунды, не минуты. Не дождался — считает доставку неудачной и повторяет её. Это не баг, а защита от потери событий: лучше прислать дважды, чем не прислать вовсе.
А теперь наложи на это реальность ИИ-приложений. Модель с рассуждением думает 30–90 секунд. Генерация картинки — до минуты. Видео — минуты. Всё это время твой обработчик молчит, потому что послушно ждёт ответа модели.
Дальше два сценария, оба плохие:
- Отправитель устал ждать → повторная доставка → пользователь получает дубли.
- Платформа убила функцию по таймауту. У бессерверных функций есть жёсткий потолок времени — от десятков секунд до нескольких минут, смотря где ты хостишься. Ответ обрывается на полпути, пользователь не получает ничего.
Именно поэтому «просто дождаться модели прямо в вебхуке» — не вариант. Не потому что медленно (это отдельная тема), а потому что ждать тебе никто не даст.
Очередь — это гардеробный номерок
Представь гардероб в театре. Ты сдаёшь пальто, получаешь номерок и уходишь. Гардеробщик не держит тебя у стойки, пока вешает пальто.
Очередь задач работает так же и состоит из трёх частей.
- Приёмщик. Твой обработчик вебхука. Он делает три вещи: проверяет событие, записывает задачу в очередь, отвечает
200 OK. Всё, что дольше секунды, ему запрещено. - Сама очередь. Хранилище задач: строка в таблице базы данных, Redis, готовый сервис вроде QStash, Inngest или Trigger.dev. Она помнит порядок и то, что уже взято в работу.
- Воркер. Отдельный процесс, который берёт задачу, спокойно ждёт модель хоть три минуты и отправляет результат пользователю сам — отдельным сообщением.
Пользователь при этом видит не тишину, а мгновенное «Принял, работаю» — и через минуту готовый ответ. Субъективно это быстрее, чем минута молчания, хотя по секундомеру то же самое.
Что очередь даёт бесплатно
Кроме снятия таймаутов, ты получаешь три вещи, которые пришлось бы писать руками.
Повторы при сбое. Модель вернула ошибку или упал интернет — очередь вернёт задачу в работу через минуту. Пользователь не потеряет запрос из-за одной неудачной секунды.
Защиту от дублей. Записывай в задачу идентификатор события (у Telegram это update_id, у Stripe — id события). Пришло второе такое же — ты видишь, что оно уже есть, и молча отвечаешь «принял». Дубли исчезают.
Ровную нагрузку. Пришло 500 сообщений разом — очередь отдаст их воркеру по мере сил, а не положит твой лимит на API модели. Это то же успокоение всплесков, что и у задач по расписанию, только по событиям.
Когда очередь не нужна
Честно: не всегда. Если бот отвечает за полсекунды готовым текстом, очередь — лишний слой.
Заводи её, когда есть хоть один пункт:
- задача дольше пары секунд (ИИ, генерация картинок, отчёты, рассылки);
- задачу нельзя потерять (оплата, заказ);
- бывают всплески нагрузки;
- ты уже видел дубли ответов или обрывы по таймауту.
Начинать можно предельно просто: таблица jobs в базе и отдельный процесс, который раз в несколько секунд забирает из неё новые строки. Полей нужно всего шесть:
id— свой номер задачи;event_id— идентификатор исходного события, тот самый ключ от дублей;payload— данные события в JSON;status—new / running / done / failed;attempts— счётчик попыток, чтобы вечно падающая задача не крутилась бесконечно;created_at— когда пришла.
Это уже настоящая очередь. Но помни: воркеру нужно место, где он живёт постоянно — на ноутбуке он умрёт вместе с крышкой, про это отдельный разбор.
Очередь и cron — это одно и то же?
Нет. Cron запускает работу по времени: «каждый день в 9:00». Очередь запускает по событию: «пришло сообщение — обработай». Часто их используют вместе: cron будит воркер, воркер разбирает очередь.
Сколько воркеров нужно?
Начни с одного. Один воркер обрабатывает задачи по очереди — и этого хватает почти любому проекту на старте. Второй добавляй, когда увидишь, что очередь растёт быстрее, чем разбирается.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





