Ошибка terminated by other getUpdates request прилетает в лог бота с кодом 409, и причина у неё одна: токен одновременно слушают два процесса. Telegram отдаёт обновления только одному клиенту, который держит long polling, и как только приходит второй запрос getUpdates с тем же токеном, первый обрывается с этим сообщением. Дальше они по очереди выбивают друг друга, бот отвечает через раз, а в логах сыпется Conflict. Ниже я собрал порядок поиска второго экземпляра, в том порядке, в каком сам его проверяю на aiogram-ботах.
Ошибка 409 Conflict: что происходит на стороне Telegram
Полный текст ошибки выглядит так: Conflict: terminated by other getUpdates request; make sure that only one bot instance is running. Telegram хранит для токена одну активную очередь обновлений. Когда приходит getUpdates, сервер отдаёт накопленные апдейты и подтверждает старые по параметру offset. Если в этот момент уже висит другой запрос getUpdates, старый закрывается с кодом 409, а новый продолжает работу. Через несколько секунд старый процесс переподключается и выбивает уже первого.
Поэтому симптомы такие: бот отвечает не на каждое сообщение, команды иногда выполняются дважды, часть апдейтов теряется (их забрал процесс, в котором обработчик другой или старой версии), а в логе одинаковые Conflict с интервалом в десятки секунд. Если видите ровно это, второй экземпляр точно существует. Вопрос только где.
Есть похожая, но другая ошибка: Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first. Здесь на токене висит вебхук, а бот пытается работать через polling. Лечится она иначе, я разберу её в отдельном разделе.
Какие библиотеки показывают эту ошибку
Любая, что работает через long polling: aiogram, python-telegram-bot, pyTelegramBotAPI, Telegraf, grammY. Текст ошибки приходит от самого Telegram, поэтому формулировка одинаковая, различается только обёртка (в aiogram это TelegramConflictError). Формы на Tilda, которые отправляют заявки в Telegram через sendMessage, к этой ошибке отношения не имеют: sendMessage не занимает очередь обновлений, и два сайта могут писать в один чат с одним токеном без конфликтов.
Где обычно прячется второй экземпляр бота
По моей практике, в девяти случаях из десяти это не злой умысел и не чужой человек, а забытый собственный процесс. Типичные места:
- Локальный запуск для отладки, который остался висеть в соседнем терминале, в IDE или в tmux-сессии на сервере.
- Деплой с перекрытием: при выкатке новой версии в Docker или на PaaS новый контейнер уже стартовал, а старый ещё жив. Обычно конфликт длится секунды и пропадает сам, а если старый контейнер завис и не получил сигнал остановки, остаётся навсегда.
- Два сервиса в одном compose-файле или два юнита systemd с одним и тем же скриптом, например после копирования конфигурации «для теста».
- Cron, запускающий скрипт с polling каждую минуту. Если скрипт живёт дольше минуты, к нему добавляется следующий запуск, и процессы копятся.
- Тот же токен в тестовом и боевом окружении. Разработчик взял токен из продакшена в
.envи запустил локально. - Менеджер процессов с автоперезапуском (supervisor, pm2), в котором параллельно запустили бота вручную.
- Сценарий в n8n с узлом Telegram Trigger. Он работает через вебхук и сам ставит его на токен, поэтому любой polling-бот на том же токене начинает с ним воевать.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Как найти запущенный процесс с тем же токеном
Начинаю с самой машины, на которой должен работать бот, потому что именно там второй процесс находится чаще всего.
Linux-сервер
Ищу процессы Python или Node, в командной строке которых есть имя скрипта бота:
pgrep -af bot.py
ps aux | grep -i "[b]ot.py"
ps -eo pid,etime,cmd | grep -i python
Колонка etime показывает, сколько процесс живёт. Если рядом работает процесс трёхдневной давности, а сервис вы перезапускали час назад, второй экземпляр найден. Если процесс запущен под systemd, смотрю systemctl status нужного юнита и список юнитов, в которые случайно мог попасть тот же скрипт. Для Docker достаточно docker ps: два контейнера из одного образа или два образа с одним токеном видны сразу.
Если на сервере несколько пользователей, не забудьте про чужие сессии: ps aux без фильтра по пользователю покажет всех, а tmux и screen от другого аккаунта легко пропустить.
Windows и локальная машина разработчика
На Windows диспетчер задач показывает только python.exe без аргументов, поэтому командную строку достаю через PowerShell:
Get-CimInstance Win32_Process -Filter "Name='python.exe'" | Select-Object ProcessId, CommandLine
В выводе видно, какой скрипт запустил каждый процесс. Дальше останавливаю лишний через Stop-Process -Id номер. Частая история у фрилансеров: бот отлаживался на ноутбуке, потом был развёрнут на сервере, а ноутбук с открытой средой разработки остался включённым дома.
Если на серверах ничего нет
Когда процессов нигде не видно, а конфликт идёт, остаются чужие места: старый сервер клиента, хостинг, где бот запускали в прошлом году, тестовый стенд подрядчика. Определить это по логам Telegram нельзя, он не показывает IP второго клиента. Здесь помогает радикальный приём, о котором дальше.
Если процесса нет: вебхук и отзыв токена
Сначала проверяю, не висит ли на токене вебхук. Запрос getWebhookInfo безопасен и возвращает текущее состояние:
curl "https://api.telegram.org/bot<TOKEN>/getWebhookInfo"
Если в ответе поле url непустое, на токене стоит вебхук. Он мог остаться от прошлой версии бота, от n8n или от PHP-обработчика на хостинге. Если вы переезжаете на polling, вебхук нужно снять:
curl -X POST "https://api.telegram.org/bot<TOKEN>/deleteWebhook" -d "drop_pending_updates=true"
Параметр drop_pending_updates=true сбросит накопленную очередь. Для бота с заявками клиентов подумайте, нужны ли эти апдейты, прежде чем их стирать. Если же бот работает на вебхуке, то polling на том же токене нужно просто убрать, иначе вы получите вторую ошибку из начала статьи.
Когда вебхука нет, процессов не нашлось, а конфликт остался, использую то, что не требует поиска: отзываю токен. В BotFather команда /revoke выдаёт новый токен, и старый перестаёт работать у всех, у кого он остался: у забытого стенда, у чужого сервера, у скрипта в планировщике. Все копии бота с прежним токеном получат ошибку авторизации и замолчат. Вы вписываете новый токен в единственное нужное место и запускаете бота. Цена такого шага: токен надо заменить везде, где он легально используется, включая n8n-credentials и переменные окружения на хостинге. Зато заодно закрывается вопрос безопасности, если токен мог утечь вместе с репозиторием.
После остановки лишнего процесса ошибка может ещё некоторое время появляться: последний висящий запрос getUpdates закрывается не мгновенно. Подождите до минуты, прежде чем искать дальше.
Сравнение причин и способов проверки
Чтобы не перебирать всё подряд, держу под рукой такую таблицу:
| Подозрение | Как проверить | Что делать |
|---|---|---|
| Забытый локальный запуск | pgrep ‑af, Get-CimInstance, etime процесса | Остановить процесс, для отладки взять отдельного бота |
| Перекрытие при деплое | docker ps, время старта контейнеров | Остановка старой версии до старта новой |
| Cron с polling | crontab ‑l, число процессов скрипта | Перевести бота в постоянный сервис или на вебхук |
| Вебхук на токене | getWebhookInfo, поле url | deleteWebhook или убрать polling |
| Чужой или неизвестный сервер | Процессов нет, а конфликт идёт | Отозвать токен через /revoke |
Как не допустить повторного запуска
Поиск лишнего процесса лечит последствие, а причину закрывают три привычки.
Отдельный бот для разработки
В BotFather создаётся второй бот за минуту. Тестовый токен лежит в локальном .env, боевой только на сервере. Это самая дешёвая мера из всех, и после неё локальный запуск физически не может задеть продакшен.
Блокировка запуска внутри скрипта
Простейший вариант без внешних зависимостей: скрипт занимает локальный порт при старте. Второй экземпляр на той же машине не сможет его занять и сразу завершится:
import asyncio
import os
import socket
import sys
from aiogram import Bot, Dispatcher
lock = socket.socket()
try:
lock.bind(("127.0.0.1", 48555))
except OSError:
sys.exit("Бот уже запущен на этой машине")
bot = Bot(token=os.environ["BOT_TOKEN"])
dp = Dispatcher()
async def main():
await bot.delete_webhook()
await dp.start_polling(bot)
if __name__ == "__main__":
asyncio.run(main())
Порт выбирается любой свободный, у каждого бота свой. Объект lock должен жить до конца работы процесса, поэтому он лежит на уровне модуля. Такая защита работает в пределах одной машины, два сервера она не отловит, для этого нужны отдельные токены или общий внешний замок.
Один процесс и корректная остановка при деплое
У бота на aiogram, который я делаю под клиента, запуск всегда одна точка: один сервис, один контейнер, остановка старой версии до старта новой и сигнал SIGTERM, который polling корректно обрабатывает. Это отдельный сервер или VPS, и его нужно настраивать и продлевать оплату каждый месяц, на обычном хостинге сайта постоянный polling-процесс не поднять. Поэтому для простых ботов при хостинге с PHP я выбираю вебхук: он не занимает очередь и не конфликтует с копиями при перезапусках. Если нужна именно такая схема с аккуратным деплоем, я занимаюсь разработкой Telegram-ботов на заказ вместе с настройкой запуска.
Отдельно про cron: запуск polling-скрипта каждую минуту почти гарантированно приведёт к конфликту, если скрипт живёт дольше минуты. Либо делайте вебхук, либо держите постоянный процесс, либо в скрипте используйте блокировку, как выше.
Telegram Bot API и библиотека aiogram развиваются, поэтому перед запуском я сверяюсь с актуальной документацией.
Частые вопросы
Можно ли держать два бота на одном токене, если один работает через вебхук, а другой через polling?
Нет. Пока на токене стоит вебхук, getUpdates не работает и возвращает ошибку про активный вебхук. Выбирайте один способ получения обновлений на токен. Для второго бота, например для тестов, заведите отдельный токен в BotFather.
Ошибка пропадает сама через время, нужно ли что-то делать?
Если она появляется только в момент деплоя и исчезает за несколько секунд, это перекрытие старого и нового процесса. Достаточно останавливать старый до старта нового. Если ошибка повторяется постоянно, второй экземпляр живёт долго, и его нужно искать по схеме выше.
Почему бот отвечает на сообщения дважды?
Обычно по тому же поводу: два процесса получают апдейты по очереди и оба отвечают. Бывает и другая причина в самом коде, например двойная регистрация обработчика. Чтобы отличить, посмотрите в логах идентификатор процесса и проверьте, нет ли ошибок Conflict.
Что произойдёт с уже накопленными сообщениями после отзыва токена?
Очередь обновлений привязана к самому боту, а не к строке токена: при /revoke меняется только вторая часть токена, а идентификатор бота (цифры до двоеточия) остаётся прежним. Поэтому накопленные апдейты не теряются, их получит бот с новым токеном в пределах обычного срока хранения, это около 24 часов. Если нужно начать с чистого состояния, очередь надо сбросить явно: deleteWebhook с параметром drop_pending_updates или getUpdates со сдвинутым offset.