FSM в Aiogram 3: 5 практических Best Practice правил

Зачем нужен FSM в Telegram-ботах?

Одна из самых частых задач при разработке Telegram-ботов — это последовательный сбор данных от пользователя. При регистрации, подаче заявки, оформлении заказа или заполнении опроса бот должен помнить, на каком именно этапе сейчас находится пользователь. Именно эту задачу решает Finite State Machine (FSM), или машина конечных состояний.

Многие новички при работе с FSM в Aiogram 3 совершают ряд архитектурных ошибок. В результате при перезапуске сервера бота теряются данные, пользователи «застревают» в зависших состояниях, а оперативная память необоснованно переполняется. В этой статье мы рассмотрим 5 важнейших практик (best practices) по правильному использованию FSM в продакшене (production).

1. Используйте только RedisStorage для продакшена

По умолчанию Aiogram предоставляет MemoryStorage. Хотя этот способ удобен для локального тестирования проекта, в реальных проектах он несет серьезные риски. При перезагрузке сервера или обновлении бота все состояния пользователей из оперативной памяти будут удалены.

Кроме того, при использовании нескольких процессов (multiprocessing) или кластера в режиме вебхуков память изолируется, и пользователь может потерять свое состояние в зависимости от того, в какой процесс попадет запрос. Чтобы предотвратить это, всегда необходимо использовать RedisStorage:

from aiogram import Bot, Dispatcher
from aiogram.fsm.storage.redis import RedisStorage
from redis.asyncio import Redis

redis = Redis(host='localhost', port=6379, db=1)
storage = RedisStorage(redis=redis)
dp = Dispatcher(storage=storage)

С помощью Redis каждое состояние сохраняется надежно, и даже при перезапуске сервера бот продолжит работу ровно с того места, где остановился.

2. Не забывайте о механизме отмены (Cancel) состояния

Одна из самых распространенных ошибок разработчиков ботов — отсутствие возможности для пользователя выйти из состояния. Пользователь может начать процесс регистрации и передумать на полпути. Если вы не предусмотрите кнопку или команду отмены, бот перестанет реагировать на любые другие команды и будет постоянно ожидать ввода данных для текущего шага.

Для решения этой проблемы рекомендуется написать общий хэндлер отмены для каждой группы состояний:

from aiogram import types
from aiogram.filters import Command
from aiogram.fsm.context import FSMContext

@dp.message(Command('cancel'))
async def cancel_handler(message: types.Message, state: FSMContext):
    current_state = await state.get_state()
    if current_state is None:
        await message.answer("Bekor qilinadigan faol jarayon yo'q.")
        return
    
    await state.clear()
    await message.answer("Amaliyot bekor qilindi.")

Метод state.clear() сбрасывает не только текущее состояние (state), но и очищает временные данные, накопленные в хранилище FSM.

3. Будьте осторожны с update_data() и get_data()

В Aiogram 3 для сохранения данных состояния настоятельно рекомендуется использовать метод update_data(), а не set_data(). Метод set_data() полностью заменяет словарь данных (dict) новым значением, из-за чего данные, собранные на предыдущих шагах, могут бесследно стереться.

Правильный подход выглядит следующим образом:

@dp.message(Form.name)
async def process_name(message: types.Message, state: FSMContext):
    await state.update_data(name=message.text)
    await state.set_state(Form.age)
    await message.answer("Yoshingizni kiriting:")

Когда на финальном этапе необходимо получить все собранные данные и записать их в базу, логика строится так:

data = await state.get_data()
# Логика записи в базу данных: save_user(name=data['name'], age=data['age'])
await state.clear()

4. Валидируйте данные и информируйте пользователя

Когда шаг FSM принимает данные от пользователя, не переводите его на следующий этап без предварительной проверки. Например, когда бот запрашивает возраст или номер телефона, пользователь может отправить текст, фото или сообщение в неверном формате.

Если введенное значение некорректно, не меняйте состояние, а отправьте понятное сообщение об ошибке:

@dp.message(Form.age)
async def process_age(message: types.Message, state: FSMContext):
    if not message.text.isdigit():
        await message.answer("Iltimos, yoshingizni faqat raqamlarda kiriting!")
        return
    
    age = int(message.text)
    if age < 10 or age > 100:
        await message.answer("Noto'g'ri yosh oralig'i kiritildi.")
        return
    
    await state.update_data(age=age)
    await state.set_state(Form.phone)
    await message.answer("Telefon raqamingizni yuboring:")

Благодаря такому подходу пользователь остается на текущем шаге и может без труда исправить ошибку ввода.

5. Выносите StatesGroup в отдельные модули

По мере роста вашего проекта в нем будут появляться десятки форм и цепочек шагов. Хранение всех классов StatesGroup в одном файле или в главном модуле запуска бота — архитектурная ошибка. Создавайте отдельный файл состояний для каждого функционального модуля (например, регистрация, оформление заказа, обратная связь).

# states/registration.py
from aiogram.fsm.state import State, StatesGroup

class RegistrationState(StatesGroup):
    full_name = State()
    phone_number = State()
    confirm = State()

Такая структура значительно повышает читаемость кода, сокращает количество конфликтов слияния (merge conflicts) при командной разработке и существенно упрощает тестирование.

Заключение

Механизм FSM в Aiogram 3 спроектирован гибко и удобно. Используя Redis, предусматривая возможность выхода из состояния, корректно обновляя данные и уделяя внимание валидации, вы сможете создавать стабильных, надежных и удобных для пользователей Telegram-ботов.