FloodWaitError нельзя “поймать и забыть”: ошибка лечится только логикой паузы

FloodWaitError нельзя “поймать и забыть”: ошибка лечится только логикой паузы

FloodWaitError в Telethon означает простую вещь: аккаунт уже уперся в лимит RPC и сервер требует подождать. Игнорировать это — значит получить цепочку повторных ошибок, сорвать очередь задач и ускорить деградацию сессии.

Что делать в обработчике:
— извлечь seconds из исключения и перевести его в sleep;
— сохранить состояние задачи, чтобы продолжить с того же места;
— не ретраить запросы сразу в цикле;
— если потоков много, ставить общий rate-limit, а не локальный try/except.

Для массовых сценариев важен не сам sleep, а архитектура: один FloodWait на уровне аккаунта должен блокировать только связанный воркер, а не весь процесс. Иначе вы будете терять пропускную способность даже там, где лимит был только на один метод. Дебаг — наш лучший друг в борьбе с FloodWait.

Хорошая практика: логируйте метод, peer, длительность ожидания и контекст операции. Тогда видно, какой именно вызов режет лимит, и можно перестроить очереди, снизить частоту запросов или развести действия по разным сессиям. Оптимизируем сессии, избегаем лимитов.